andyh-deprec 1.99.26

data/lib/deprec/recipes/ar_sendmail.rb

@@ -0,0 +1,65 @@
+# Copyright 2006-2008 by Mike Bailey. All rights reserved.
+Capistrano::Configuration.instance(:must_exist).load do 
+  namespace :deprec do
+    namespace :ar_sendmail do
+      
+      desc "Install ar_mailer"
+      task :install do
+        gem2.install 'ar_mailer'
+      end
+
+      # install dependencies for nginx
+      task :install_deps do
+        #pass
+      end
+      
+      PROJECT_CONFIG_FILES[:ar_sendmail] = [
+        
+        {:template => 'monit.conf.erb',
+         :path => "monit.conf", 
+         :mode => 0600,
+         :owner => 'root:root'},
+         
+        {:template => 'logrotate.conf.erb',
+         :path => "logrotate.conf", 
+         :mode => 0644,
+         :owner => 'root:root'}
+      ]
+       
+      task :config_gen do
+        config_gen_project
+      end
+      
+      task :config_gen_project do
+        PROJECT_CONFIG_FILES[:ar_sendmail].each do |file|
+          deprec2.render_template(:ar_sendmail, file)
+        end
+      end
+      
+      task :config, :roles => :app do
+        config_project
+      end
+      
+      task :config_project, :roles => :app do
+        deprec2.push_configs(:ar_sendmail, PROJECT_CONFIG_FILES[:ar_sendmail])
+        symlink_monit_config
+        symlink_logrotate_config
+      end
+      
+      task :symlink_monit_config, :roles => :app do
+        deprec2.mkdir(monit_confd_dir, :via => :sudo)
+        sudo "ln -sf #{deploy_to}/ar_sendmail/monit.conf #{monit_confd_dir}/ar_sendmail_#{application}.conf"
+      end
+      
+      task :unlink_monit_config, :roles => :app do
+        link = "#{monit_confd_dir}/ar_sendmail_#{application}.conf"
+        sudo "test -L #{link} && unlink #{link}"
+      end
+      
+      task :symlink_logrotate_config, :roles => :app do
+        sudo "ln -sf #{deploy_to}/ar_sendmail/logrotate.conf /etc/logrotate.d/ar_sendmail-#{application}"
+      end
+    
+    end
+  end
+end

data/lib/deprec/recipes/canonical.rb

@@ -0,0 +1,57 @@
+# Copyright 2006-2008 by Mike Bailey. All rights reserved.
+# canonical.rb
+#
+# Running deprec:web:stop will be the same as running deprec:apache:stop or 
+# deprec:nginx:stop depending what you have chosen.
+#
+# generic namespaces are linked up to chosen applications at runtime but these
+# stubs are so they'll be included in the output of "cap -T"
+#
+Capistrano::Configuration.instance(:must_exist).load do 
+  
+  %w(web app db).each do |server|
+    namespace "deprec:#{server}" do
+      
+      desc "Install #{server} server"
+      task :install, :roles => server do 
+      end
+      
+      desc "Generate config file(s) for #{server} server from template(s)"
+      task :config_gen do
+      end
+      
+      desc "Deploy configuration files(s) for #{server} server"
+      task :config, :roles => server do
+      end
+      
+      desc "Start #{server} server"
+      task :start, :roles => server do
+      end
+      
+      desc "Stop #{server} server"
+      task :stop, :roles => server do
+      end
+      
+      desc "Stop #{server} server"
+      task :restart, :roles => server do
+      end
+      
+      desc "Enable startup script for #{server} server"
+      task :activate, :roles => server do
+      end  
+      
+      desc "Disable startup script for #{server} server"
+      task :deactivate, :roles => server do
+      end
+      
+      desc "Backup data for #{server} server"
+      task :backup, :roles => server do
+      end
+      
+      desc "Restore data for #{server} server from backup"
+      task :restore, :roles => server do
+      end
+      
+    end
+  end
+end

data/lib/deprec/recipes/deprec.rb

@@ -0,0 +1,188 @@
+# Copyright 2006-2008 by Mike Bailey. All rights reserved.
+Capistrano::Configuration.instance(:must_exist).load do 
+  
+  # Set the value if not already set
+  # This method is accessible to all recipe files
+  def self.default(name, *args, &block)
+    unless exists?(name)
+      set(name, *args, &block)
+    end
+  end
+  
+  # Deprec checks here for local versions of config templates before it's own
+  set :local_template_dir, File.join('config','templates')
+  
+  # The following two Constants contain details of the configuration 
+  # files used by each service. They're used when generating config
+  # files from templates and when configs files are pushed out to servers.
+  #
+  # They are populated by the recipe file for each service
+  #
+  SYSTEM_CONFIG_FILES  = {} # e.g. httpd.conf
+  PROJECT_CONFIG_FILES = {} # e.g. projectname-httpd-vhost.conf
+  
+  # For each service, the details of the file to download and options
+  # to configure, build and install the service
+  SRC_PACKAGES = {} unless defined?(SRC_PACKAGES)
+  
+  # Server options
+  CHOICES_WEBSERVER = [:nginx, :apache, :none]
+  CHOICES_APPSERVER = [:mongrel, :webrick, :none]
+  CHOICES_DATABASE  = [:mysql, :postgres, :none]
+  
+  
+  # Server defaults
+  default :web_server_type, :apache
+  default :app_server_type, :mongrel
+  default :db_server_type,  :mysql
+
+  default(:web_server_type) do
+    Capistrano::CLI.ui.choose do |menu| 
+      CHOICES_WEBSERVER.each {|c| menu.choice(c)}
+      menu.header = "select webserver type"
+    end
+  end
+
+  default(:app_server_type) do
+    Capistrano::CLI.ui.choose do |menu| 
+      CHOICES_APPSERVER.each {|c| menu.choice(c)}
+      menu.header = "select application server type"
+    end
+  end
+
+  default(:db_server_type) do
+    Capistrano::CLI.ui.choose do |menu| 
+      CHOICES_DATABASE.each {|c| menu.choice(c)}
+      menu.header = "select database server type"
+    end
+  end
+
+  default(:application) do
+    Capistrano::CLI.ui.ask "enter name of project(no spaces)" do |q|
+      q.validate = /^[0-9a-z_]*$/
+    end
+  end 
+
+  default(:domain) do
+    Capistrano::CLI.ui.ask "enter domain name for project" do |q|
+      q.validate = /^[0-9a-z_\.]*$/
+    end
+  end
+
+  default(:repository) do
+    Capistrano::CLI.ui.ask "enter repository URL for project" do |q|
+      # q.validate = //
+    end
+  end
+
+  # some tasks run commands requiring special user privileges on remote servers
+  # these tasks will run the commands with:
+  #   :invoke_command "command", :via => run_method
+  # override this value if sudo is not an option
+  # in that case, your use will need the correct privileges
+  default :run_method, :sudo 
+
+  default(:backup_dir) { '/var/backups'}  
+
+  # XXX rails deploy stuff
+  set :apps_root,     File.join( %w(/ opt apps) )          # parent dir for apps
+  default(:deploy_to)    { File.join(apps_root, application) } # dir for current app
+  default(:current_path) { File.join(deploy_to, "current") }
+  default(:shared_path)  { File.join(deploy_to, "shared") }
+
+  # XXX more rails deploy stuff?
+
+  default :user, ENV['USER']         # user who is deploying
+  default :group, 'deploy'           # deployment group
+  default(:group_src) { group }      # group ownership for src dir
+  default :src_dir, '/usr/local/src' # 3rd party src on servers lives here
+  default(:web_server_aliases) { domain.match(/^www/) ? [] : ["www.#{domain}"] }    
+
+  # XXX for some reason this is causing "before deprec:rails:install" to be executed twice
+  # on :load, 'deprec:connect_canonical_tasks' 
+
+  namespace :deprec do
+
+    task :connect_canonical_tasks, :hosts => 'localhost' do      
+      # link application specific recipes into canonical task names
+      # e.g. deprec:web:restart => deprec:nginx:restart 
+      metaclass = class << self; self; end
+      [:web, :app, :db].each do |server|
+        server_type = send("#{server}_server_type")
+        if server_type != :none
+          metaclass.send(:define_method, server) { namespaces[server] }
+          self.namespaces[server] = deprec.send(server_type)
+        end
+      end
+    end
+
+    task :dump do
+      require 'yaml'
+      y variables
+    end
+    
+    task :setup_src_dir do
+      deprec2.groupadd(group_src)
+      deprec2.add_user_to_group(user, group_src)
+      deprec2.create_src_dir
+    end
+    
+    # Download all packages used by deprec to your local host.
+    # You can then push them to /usr/local/src on target hosts
+    # to save time and bandwidth rather than repeatedly downloading
+    # from the distribution sites.
+    task :update_src do
+      SRC_PACKAGES.each{|key, src_package| 
+        current_dir = Dir.pwd
+        system "cd src/ && test -f #{src_package[:filename]} || wget --quiet --timestamping #{src_package[:url]}"
+        system "cd #{current_dir}"
+      }
+    end
+    
+    # todo
+    #
+    # Copy files from src/ to /usr/local/src/ on remote hosts
+    task :push_src do
+      SRC_PACKAGES.each do |key, src_package| 
+        deprec2.set_package_defaults(src_package)
+        file = File.join('src', src_package[:filename])
+        if File.exists?(file)
+          std.su_put(File.read(file), "#{src_dir}/#{src_package[:filename]}", '/tmp/')
+        end
+      end
+    end
+    
+    task :list_src do
+      # XXX ugly line - look away
+      max_key_size = SRC_PACKAGES.keys.max{|a,b| a.to_s.size <=> b.to_s.size}.to_s.size
+      SRC_PACKAGES.each{|key, src_package| 
+        deprec2.set_package_defaults(src_package)
+        puts "#{key}#{' '*(max_key_size+1-key.to_s.size)}: #{src_package[:url]}"
+      }
+    end
+    
+    task :find_src do
+      # XXX ugly line - look away
+      max_key_size = SRC_PACKAGES.keys.max{|a,b| a.to_s.size <=> b.to_s.size}.to_s.size
+      SRC_PACKAGES.each{|key, src_package| 
+        deprec2.set_package_defaults(src_package)
+        puts "#{key}#{' '*(max_key_size+1-key.to_s.size)}: #{src_package[:url]}"
+        puts `find . -name #{src_package[:filename]}`
+        puts
+      }
+    end
+    
+    task :recover_src do
+      # XXX ugly line - look away
+      max_key_size = SRC_PACKAGES.keys.max{|a,b| a.to_s.size <=> b.to_s.size}.to_s.size
+      SRC_PACKAGES.each{|key, src_package| 
+        puts "#{key}#{' '*(max_key_size+1-key.to_s.size)}: #{src_package[:url]}"
+        file = `find . -name #{src_package[:filename]}`.split[0]
+        `cp #{file} src/` if file
+        puts
+      }
+    end
+     
+  end
+  
+end

data/lib/deprec/recipes/deprecated.rb

@@ -0,0 +1,71 @@
+# Copyright 2006-2008 by Mike Bailey. All rights reserved.
+Capistrano::Configuration.instance(:must_exist).load do 
+  
+  # deprecated tasks from deprec1
+  # we're now using namespaces and some different naming conventions
+  
+  # XXX use deprecated function to generate these dynamically
+  
+  deprec2_isnt_backwards_compatible = <<-EOF
+    
+You've installed deprec2 but seem to be using a deprec1 command.
+
+You have two options:
+
+- install deprec-1.9.x and continue using deprec1
+
+  Instructions are available at http://www.deprec.org/
+
+- use deprec2
+
+EOF
+
+  cap2_warning = <<-EOF
+  
+You're using Capistrano 2 but using a deprecated cap1 command.
+
+EOF
+  
+  task :setup_admin_account do
+    puts deprec2_isnt_backwards_compatible  
+    puts "  Replace 'cap setup_admin_account' with 'cap deprec:users:add'"
+    puts
+  end
+  
+  task :change_root_password do
+    puts deprec2_isnt_backwards_compatible  
+    puts "  Replace 'cap change_root_password' with 'cap deprec:users:passwd'"
+    puts
+  end
+  
+  task :setup_ssh_keys do
+    puts deprec2_isnt_backwards_compatible  
+    puts "  Replace 'cap setup_ssh_keys' with 'cap deprec:ssh:setup_keys'"
+    puts
+  end
+  
+  task :install_rails_stack do
+    puts deprec2_isnt_backwards_compatible  
+    puts "  Replace 'cap install_rails_stack' with 'cap deprec:rails:install_rails_stack'"
+    puts
+  end
+  
+  task :setup do
+    puts deprec2_isnt_backwards_compatible  
+    puts "  Replace 'cap setup' with 'cap deploy:setup'"
+    puts
+  end
+  
+  task :restart_apache do
+    puts deprec2_isnt_backwards_compatible  
+    puts "  Replace 'cap restart_apache' with 'cap deprec:apache:restart'"
+    puts
+  end
+  
+  task :show_tasks do
+    puts deprec2_isnt_backwards_compatible  
+    puts "  Replace 'cap show-tasks' with 'cap -T'"
+    puts
+  end
+  
+end

data/lib/deprec/recipes/example.rb

@@ -0,0 +1,115 @@
+# Copyright 2006-2008 by Mike Bailey. All rights reserved.
+Capistrano::Configuration.instance(:must_exist).load do 
+  namespace :deprec do
+    namespace :example do
+      
+      SRC_PACKAGES[:example] = {
+        :filename => 'example-1.2.3.tar.gz',   
+        :md5sum => "d050a49bd72222ec21c6bb593b3473a5d  example-1.2.3.tar.gz", 
+        :dir => 'example-1.2.3',  
+        :url => "http://www.example.org/dist/example/example-1.2.3.tar.gz",
+        :unpack => "tar zxf example-1.2.3.tar.gz;",
+        :configure => %w(
+          ./configure
+          --enable-mods-shared=all
+          --enable-proxy 
+          ;
+          ).reject{|arg| arg.match '#'}.join(' '),
+        :make => 'make;',
+        :install => 'make install;',
+        :post_install => 'install -b support/apachectl /etc/init.d/httpd;'
+      }
+      
+      desc "Install example"
+      task :install, :roles => :web do
+        install_deps
+        deprec2.download_src(SRC_PACKAGES[:example], src_dir)
+        deprec2.install_from_src(SRC_PACKAGES[:example], src_dir)
+      end
+      
+      task :install_deps do
+        apt.install( {:base => %w(build-essential zlib1g-dev)}, :stable )
+      end
+      
+      SYSTEM_CONFIG_FILES[:example] = [
+        
+        {:template => "example.conf.erb",
+         :path => '/etc/example/example.conf',
+         :mode => 0755,
+         :owner => 'root:root'}
+         
+      ]
+
+      PROJECT_CONFIG_FILES[:example] = [
+        
+        {:template => "example.conf.erb",
+         :path => 'conf/example.conf',
+         :mode => 0755,
+         :owner => 'root:root'}
+      ]
+      
+      
+      desc "Generate configuration file(s) for XXX from template(s)"
+      task :config_gen do
+        config_gen_system
+        config_gen_project
+      end
+
+      task :config_gen_system do
+        SYSTEM_CONFIG_FILES[:example].each do |file|
+          deprec2.render_template(:example, file)
+        end
+      end
+
+      task :config_gen_project do
+        PROJECT_CONFIG_FILES[:example].each do |file|
+          deprec2.render_template(:example, file)
+        end
+      end
+      
+      desc 'Deploy configuration files(s) for XXX' 
+      task :config, :roles => :web do
+        config_system
+        config_project
+      end
+
+      task :config_system, :roles => :web do
+        deprec2.push_configs(:example, SYSTEM_CONFIG_FILES[:example])
+      end
+
+      task :config_project, :roles => :web do
+        deprec2.push_configs(:example, PROJECT_CONFIG_FILES[:example])
+      end
+      
+      
+      task :start, :roles => :web do
+        send(run_method, "/etc/init.d/example reload")
+      end
+      
+      task :stop, :roles => :web do
+        send(run_method, "/etc/init.d/example reload")
+      end
+      
+      task :restart, :roles => :web do
+        send(run_method, "/etc/init.d/example restart")
+      end
+      
+      task :reload, :roles => :web do
+        send(run_method, "/etc/init.d/example reload")
+      end
+      
+      task :activate, :roles => :web do
+      end  
+      
+      task :deactivate, :roles => :web do
+      end
+      
+      task :backup, :roles => :web do
+      end
+      
+      task :restore, :roles => :web do
+      end
+      
+    end
+  end
+end

data/lib/deprec/recipes/git.rb

@@ -0,0 +1,97 @@
+# Copyright 2006-2008 by Mike Bailey. All rights reserved.
+Capistrano::Configuration.instance(:must_exist).load do 
+  namespace :deprec do 
+    namespace :git do
+
+      set :git_user, 'git'
+      set :git_group, 'git'
+      set :git_port, '9418'
+      set :git_keys_file, '/home/git/.ssh/authorized_keys'
+      set :git_root, '/var/git'
+
+      SRC_PACKAGES[:git] = {
+        :url => "http://kernel.org/pub/software/scm/git/git-1.5.5.4.tar.gz",
+        :md5sum => "8255894042c8a6db07227475b8b4622f  git-1.5.5.4.tar.gz"
+      }
+
+      desc "Install git"
+      task :install do
+        install_deps
+        deprec2.download_src(SRC_PACKAGES[:git], src_dir)
+        deprec2.install_from_src(SRC_PACKAGES[:git], src_dir)
+        # create_git_root
+        # create_git_user
+      end
+
+      # install dependencies for nginx
+      task :install_deps do
+        apt.install( {:base => %w(zlib1g-dev gettext)}, :stable )
+      end
+      
+      # "Start git server in local directory"
+      task :serve do
+        cmd = "git-daemon --verbose --port=#{git_port} --base-path=#{Dir.pwd} --base-path-relaxed"
+        puts cmd
+        `#{cmd}`
+      end
+      
+      desc "Create git repos for current dir"
+      task :init do
+        `git init`
+        create_gitignore
+        create_files_in_empty_dirs
+        `git add . && git commit -m 'initial import'`
+      end
+      
+      task :create_gitignore do
+        system("echo '.DS_Store' >> .gitignore") # files sometimes created by OSX 
+        system("echo 'log/*' >> .gitignore") if File.directory?('log')
+        system("echo 'tmp/**/*' >> .gitignore") if File.directory?('tmp')
+      end
+      
+      task :create_files_in_empty_dirs do
+        %w(log tmp).each { |dir| 
+          system("touch #{dir}/.gitignore") if File.directory?(dir)
+        }
+      end
+      
+      desc "Create remote origin for current dir"
+      task :create_remote_origin do
+        File.directory?('.git') || init
+         
+        # Push to remote git repo
+        hostname = capture "echo $CAPISTRANO:HOST$"
+        system "git remote add origin git@#{hostname.chomp}:#{application}"
+        system "git push origin master:refs/heads/master"
+        
+        puts 
+        puts "New remote Git repo: #{git_user}@#{hostname.chomp}:#{application}"
+        puts    
+        
+        # File.open('.git/config', 'w') do |c|
+        #   c.write 'Add the following to .git/config'
+        #   c.write '[branch "master"]'
+        #   c.write ' remote = origin'
+        #   c.write ' merge = refs/heads/master'
+        # end
+          
+      end
+
+      # Create root dir for git repositories
+      task :create_git_root do
+        deprec2.mkdir(git_root, :mode => 02775, :owner => git_user, :group => git_group, :via => :sudo)
+        sudo "chmod -R g+w #{git_root}"
+      end
+      
+      # regenerate git authorized keys file from users file in same dir
+      task :regenerate_authorized_keys do
+        sudo "echo '' > #{git_keys_file}"
+        sudo "for file in `ls #{git_keys_file}-*`; do cat $file >> #{git_keys_file}; echo \"\n\" >> #{git_keys_file} ; done"
+        sudo "chown #{git_user}.#{git_group} #{git_keys_file}"
+        sudo "chmod 0600 #{git_keys_file}" 
+      end
+
+
+    end 
+  end
+end

data/lib/deprec/recipes/gitosis.rb

@@ -0,0 +1,48 @@
+# Copyright 2006-2008 by Mike Bailey. All rights reserved.
+Capistrano::Configuration.instance(:must_exist).load do 
+  namespace :deprec do 
+    namespace :gitosis do
+      
+      # ref: http://scie.nti.st/2007/11/14/hosting-git-repositories-the-easy-and-secure-way
+
+      set :gitosis_user, 'git'
+
+      desc "Install git"
+      task :install do
+        deprec2.create_src_dir
+        install_deps
+        run <<-SUDO
+          cd #{src_dir} && test -d gitosis || #{sudo} git clone git://eagain.net/gitosis.git; exit 0
+        SUDO
+        run "cd #{src_dir}/gitosis && #{sudo} python setup.py install"
+        create_user
+        init
+      end
+
+      # install dependencies for nginx
+      task :install_deps do
+        apt.install( {:base => %w(python-setuptools)}, :stable )
+      end
+
+      # Create user for gitosis to run as
+      # This will also be the account you use for ssh access to git
+      task :create_user do
+        run "grep '^#{gitosis_user}:' /etc/passwd || #{sudo} adduser --system --shell /bin/sh --gecos 'git version control' --group --disabled-password --home /home/#{gitosis_user} #{gitosis_user}"
+        sudo "passwd --unlock #{gitosis_user}"
+      end
+      
+      task :init do
+        sudo "sudo -H -u #{git_user} gitosis-init < ~/.ssh/authorized_keys"
+        sudo "chmod 0755 /home/git/repositories/gitosis-admin.git/hooks/post-update" 
+        puts
+        puts "Now check out the gitosis-admin repos, edit configs and push changes back"
+        puts "Your changes with update gitosis as soon as they are checked in."
+        puts
+        puts "git clone git@YOUR_SERVER_HOSTNAME:gitosis-admin.git"
+        puts "cd gitosis-admin"
+        puts ""
+      end
+
+    end 
+  end
+end