deprec 0.0.1 → 1.1.0

data/bin/deprec

@@ -0,0 +1,35 @@
+#!/usr/bin/env ruby
+
+begin
+  require 'rubygems'
+rescue LoadError
+  # no rubygems to load, so we fail silently
+end
+
+require 'optparse'
+
+@options = {}
+OptionParser.new do |opts|
+  opts.banner = "Usage: #{$0} [options] [args]"
+
+  opts.on("-A", "--apply-to DIRECTORY",
+    "Create a minimal set of scripts and recipes",
+    "for use with capistrano to configure servers."
+  ) { |value| @options[:apply_to] = value }
+  opts.on("-n", "--name APPLICATION_NAME",
+    "Name of application."
+  ) { |value| @options[:application] = value }
+  opts.on("-d", "--domain DOMAIN_NAME",
+    "Domain name for application."
+  ) { |value| @options[:domain] = value }
+ 
+  if ARGV.empty?
+    puts opts
+      exit
+  else
+    opts.parse!(ARGV)
+  end
+end
+
+require 'deprec/generators/loader'
+Deprec::Generators::RailsLoader.load! @options

data/bin/deprec_dotfiles

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+patch_target=File.dirname(`gemwhich capistrano`) + '/capistrano/cli.rb'
+patch_file = File.join(File.dirname(__FILE__), '..', 'resources','capistrano_include_dotfiles.patch')
+system "sudo patch -p0 #{patch_target} < #{patch_file}"
+req_statement = "require 'deprec/recipes'"
+system "grep '#{req_statement}' ~/.caprc > /dev/null 2>&1 || echo \"#{req_statement}\" >> ~/.caprc"

data/docs/building_edge_capistrano.txt

@@ -0,0 +1,9 @@
+You can build an edge gem by cd'ing to that directory and doing:
+
+1. svn info. Find the line that says "Revision:" and mark the revision number.
+
+2. rake PKG_BUILD=<rev> gem. Replace <rev> with the revision number.
+
+3. Look in the pkg subdirectory. Install that gem file via "gem install pkg/<gem file>"
+
+- Jamis

data/lib/deprec/generators/deprec/USAGE

@@ -0,0 +1,11 @@
+NAME
+     deprec - creates configuration and Capistrano tasks for server configuration.
+
+SYNOPSIS
+     deprec --apply-to /path/to/app --name application_name --domain domain_name
+
+DESCRIPTION
+     This generator creates deployment recipes.
+  
+EXAMPLE
+	deprec --apply-to . --name bailey --domain www.bailey.net.au

data/lib/deprec/generators/deprec/deprec_generator.rb

@@ -0,0 +1,24 @@
+class DeprecGenerator < Rails::Generator::NamedBase
+  attr_reader :application_name
+  attr_reader :domain_name
+  
+  def initialize(runtime_args, runtime_options = {})
+    super
+    @application_name = self.file_name
+    @domain_name = @args[0]
+  end
+
+  def manifest
+    record do |m|
+      m.directory "config"
+      m.template "deploy.rb", File.join("config", "deploy.rb")
+    end
+  end
+
+  protected
+
+    # Override with your own usage banner.
+    def banner
+      "Usage: #{$0} --apply-to /path/to/app --name ApplicationName --domain DomainName"
+    end
+end

data/lib/deprec/generators/deprec/templates/deploy.rb

@@ -0,0 +1,71 @@
+require 'deprec/recipes'
+
+# =============================================================================
+# ROLES
+# =============================================================================
+# You can define any number of roles, each of which contains any number of
+# machines. Roles might include such things as :web, or :app, or :db, defining
+# what the purpose of each machine is. You can also specify options that can
+# be used to single out a specific subset of boxes in a particular role, like
+# :primary => true.
+
+set :domain, "<%= domain_name %>"
+role :web, domain
+role :app, domain
+role :db,  domain, :primary => true
+
+# =============================================================================
+# REQUIRED VARIABLES
+# =============================================================================
+# You must always specify the application and repository for every recipe. The
+# repository must be the URL of the repository you want this recipe to
+# correspond to. The deploy_to path must be the path on each machine that will
+# form the root of the application path.
+
+set :application, "<%= singular_name %>"
+set :deploy_to, "/var/www/apps/#{application}"
+
+set :user, ENV['USER']
+set :repository, "svn+ssh://#{user}@#{domain}#{deploy_to}/repos/trunk"
+set :rails_env, "production"
+
+# Automatically symlink these directories from current/public to shared/public.
+# set :app_symlinks, %w{photo, document, asset}
+
+# =============================================================================
+# APACHE OPTIONS
+# =============================================================================
+set :apache_server_name, domain
+# set :apache_server_aliases, %w{alias1 alias2}
+# set :apache_default_vhost, true # force use of apache_default_vhost_config
+# set :apache_default_vhost_conf, "/etc/httpd/conf/default.conf"
+# set :apache_conf, "/etc/httpd/conf/apps/#{application}.conf"
+# set :apache_ctl, "/etc/init.d/httpd"
+# set :apache_proxy_port, 8000
+# set :apache_proxy_servers, 2
+# set :apache_proxy_address, "127.0.0.1"
+# set :apache_ssl_enabled, false
+# set :apache_ssl_ip, "127.0.0.1"
+# set :apache_ssl_forward_all, false
+
+# =============================================================================
+# MONGREL OPTIONS
+# =============================================================================
+# set :mongrel_servers, apache_proxy_servers
+# set :mongrel_port, apache_proxy_port
+set :mongrel_address, apache_proxy_address
+# set :mongrel_environment, "production"
+# set :mongrel_config, "/etc/mongrel_cluster/#{application}.conf"
+# set :mongrel_user, user
+# set :mongrel_group, group
+
+# =============================================================================
+# MYSQL OPTIONS
+# =============================================================================
+
+
+# =============================================================================
+# SSH OPTIONS
+# =============================================================================
+# ssh_options[:keys] = %w(/path/to/my/key /path/to/another/key)
+# ssh_options[:port] = 25

data/lib/deprec/generators/loader.rb

@@ -0,0 +1,20 @@
+module Deprec
+  module Generators
+    class RailsLoader
+      def self.load!(options)
+        require "#{options[:apply_to]}/config/environment"
+        require "rails_generator"
+        require "rails_generator/scripts/generate"
+
+        Rails::Generator::Base.sources << Rails::Generator::PathSource.new(
+          :deprec, File.dirname(__FILE__))
+
+        args = ["deprec"]
+        args << (options[:application] || "Application")
+        args << (options[:domain] || "www.mynewsite.com")
+
+        Rails::Generator::Scripts::Generate.new.run(args)
+      end
+    end
+  end
+end

data/lib/deprec/recipes.rb

@@ -0,0 +1,227 @@
+require 'deprec/recipes/ssh'
+require 'deprec/recipes/svn'
+require 'deprec/recipes/ubuntu'
+require 'deprec/third_party/mongrel_cluster/recipes'
+require 'deprec/third_party/vmbuilder/plugins'
+require 'deprec/third_party/railsmachine/recipes/svn'
+require 'deprec/third_party/railsmachine/recipes/apache'
+require 'deprec/third_party/railsmachine/recipes/mysql'
+
+Capistrano.configuration(:must_exist).load do
+  set :user, (defined?(user) ? user : ENV['USER']) # user who is deploying
+  set :group, 'deploy'           # deployment group
+  set :src_dir, (defined?(src_dir) ? src_dir : '/usr/local/src') # 3rd party src on servers 
+  set :app_symlinks, nil                  
+  
+  desc <<-DESC
+  setup_rails_host takes a stock standard ubuntu 'dapper' 6.06.1 server
+  and installs everything needed to be a rails machine
+  DESC
+  task :install_rails_stack do
+    setup_user_perms
+    enable_universe # we'll need some packages from the 'universe' repository
+    disable_cdrom_install # we don't want to have to insert cdrom
+    install_packages_for_rails # install packages that come with distribution
+    install_rubygems
+    install_gems 
+    install_apache
+  end
+  
+  desc "Set up the expected application directory structure on all boxes"
+  task :setup, :except => { :no_release => true } do
+    setup_paths
+    run <<-CMD
+      mkdir -p -m 775 #{releases_path} #{shared_path}/system &&
+      mkdir -p -m 777 #{shared_path}/log &&
+      mkdir -p -m 777 #{shared_path}/pids
+    CMD
+    setup_servers
+  end
+  
+  desc "setup and configure servers"
+  task :setup_servers do
+    setup_web
+    setup_paths
+    setup_app
+    setup_symlinks
+    setup_db
+  end
+  
+  desc "Setup web server."
+  task :setup_web, :roles => :web  do
+    set :apache_server_name, domain unless apache_server_name
+    setup_apache
+    configure_apache
+  end
+  
+  desc "Setup application server."
+  task :setup_app, :roles => :app  do
+    set :mongrel_environment, rails_env
+    set :mongrel_port, apache_proxy_port
+    set :mongrel_servers, apache_proxy_servers
+    install_mongrel_start_script
+    setup_mongrel_cluster_path
+    configure_mongrel_cluster
+  end
+  
+  desc "Restart application server."
+  task :restart_app, :roles => :app  do
+    restart_mongrel_cluster
+  end
+  
+  desc "Start application server."
+  task :start_app, :roles => :app  do
+    start_mongrel_cluster
+  end
+
+  desc "Start the processes on the application server by calling start_app."
+  task :spinner, :roles => :app do
+    start_app
+  end
+  
+  desc "Setup public symlink directories"
+  task :setup_symlinks, :roles => [:app, :web] do
+    if app_symlinks
+      app_symlinks.each { |link| run "mkdir -p #{shared_path}/public/#{link}" }
+    end
+  end
+  
+  desc "Setup database server."
+  task :setup_db, :roles => :db, :only => { :primary => true } do
+    setup_mysql
+  end
+  
+  desc "Setup source control server."
+  task :setup_scm, :roles => :scm  do
+    setup_svn
+    import_svn
+  end
+  
+  desc "setup extra paths required for deployment"
+  task :setup_paths, :roles => :app do
+    # XXX make a function to create a group writable dir
+    sudo "test -d #{shared_path}/config || sudo mkdir -p #{shared_path}/config"
+    sudo "chgrp -R #{group} #{deploy_to}"
+    sudo "chmod -R g+w #{deploy_to}"
+  end
+  
+  task :create_user do
+    newuser=user
+    user='root'
+    # run "useradd -m #{newuser}"
+    run "ls"
+    user=newuser
+  end
+  
+  task :install_gems do
+    gem.install 'rails'                 # gem lib makes installing gems fun
+    gem.select 'mongrel'                # mongrel requires we select a version
+    gem.install 'mongrel_cluster'
+  end
+  
+  desc "create deployment group and add current user to it"
+  task :setup_user_perms do
+    sudo "grep #{group} /etc/group || sudo groupadd #{group}"
+    sudo "groups #{user} | grep #{group} || sudo usermod --groups #{group} -a #{user}"
+  end
+  
+  task :install_rubygems do
+    # ??? is this an OK way to pass values around to the functions?
+    version = 'rubygems-0.9.0'
+    set :file_to_get, {
+      :file => version + '.tgz',
+      :dir => version,
+      :url => "http://rubyforge.org/frs/download.php/11289/#{version}.tgz",
+      :unpack => "tar zxf #{version}.tgz;",
+      :configure => nil,
+      :make => nil,
+      :install => '/usr/bin/ruby1.8 setup.rb;'
+    }
+    download_src
+    install_from_src
+    gem.update_system
+  end
+  
+  task :install_apache do
+    # ??? is this an OK way to pass values around to the functions?
+    version = 'httpd-2.2.3'
+    set :file_to_get, {
+      :file => version + '.tar.gz',    
+      :dir => version,  
+      :url => "http://www.apache.org/dist/httpd/#{version}.tar.gz",
+      :unpack => "tar zxf #{version}.tar.gz;",
+      :configure => './configure --enable-proxy --enable-proxy-balancer --enable-proxy-http --enable-rewrite  --enable-cache --enable-headers --enable-ssl --enable-deflate;',
+      :make => 'make;',
+      :install => 'make install;',
+      :post_install => 'cp support/apachectl /etc/init.d/httpd && chmod 0777 /etc/init.d/httpd;'
+    }
+    download_src
+    install_from_src
+  end
+
+  # XXX move into cap extensions
+  desc "install package from source"
+  task :install_from_src do
+    package_dir = File.join(src_dir, file_to_get[:dir])
+    unpack_src
+    # XXX we need run_sh and sudo_sh functions to make 'cd' cmd work
+    sudo <<-SUDO
+    sh -c '
+      cd #{package_dir};
+      #{file_to_get[:configure]}
+      #{file_to_get[:make]}
+      #{file_to_get[:install]}
+      #{file_to_get[:post_install]}
+      '
+    SUDO
+  end
+  
+  desc "unpack src and make it writable by the group"
+  task :unpack_src do
+    package_dir = File.join(src_dir, file_to_get[:dir])
+    sudo <<-SUDO
+    sh -c '
+      cd #{src_dir};
+      test -d #{package_dir}.old && rm -fr #{package_dir}.old;
+      test -d #{package_dir} && mv #{package_dir} #{package_dir}.old;
+      #{file_to_get[:unpack]}
+      chgrp -R #{group} #{package_dir};  
+      chmod -R g+w #{package_dir};
+    '
+    SUDO
+  end
+  
+   desc "Setup public symlink directories"
+   task :setup_symlinks, :roles => [:app, :web] do
+     if app_symlinks
+       app_symlinks.each { |link| run "mkdir -p #{shared_path}/public/#{link}" }
+     end
+   end
+
+   desc "Link up any public directories."
+   task :symlink_public, :roles => [:app, :web] do
+     if app_symlinks
+       app_symlinks.each { |link| run "ln -nfs #{shared_path}/public/#{link} #{current_path}/public/#{link}" }
+     end
+  end
+    
+  # something for later...
+  # desc "render a template"
+  # task :z_template do
+  #   file = File.join(File.dirname(__FILE__), 'recipes', 'templates', 'test_goo.rhtml')
+  #   msg = render :template => File.read(file), :foo => 'good', :bar => 'night'
+  #   run "echo #{msg}"
+  # end
+  
+  "will be moved to capistrano extension"
+  task :download_src do
+    # move this into cap extension
+    # XXX should make this group writable
+    # XXX so we don't need to sudo to compile
+    sudo "test -d #{src_dir} || sudo mkdir #{src_dir}" 
+    sudo "chgrp -R #{group} #{src_dir}"
+    sudo "chmod -R g+w #{src_dir}"
+    sudo "sh -c 'cd #{src_dir} && test -f #{file_to_get[:file]} || wget #{file_to_get[:url]}'"
+  end
+  
+end

data/lib/deprec/recipes/slicehost.rb

@@ -0,0 +1,18 @@
+
+Capistrano.configuration(:must_exist).load do
+
+  task :install_rails_stack_slicehost do
+    # create user account
+  
+  end
+  
+end
+# 
+# # set editor to vim
+# 
+# # create user account
+# mkdir -m mbailey
+# # set password for user
+# passwd mbailey
+# # setup sudo
+# echo "mbailey ALL=(ALL) ALL" >> /etc/sudoers

data/lib/deprec/recipes/ssh.rb

@@ -0,0 +1,13 @@
+Capistrano.configuration(:must_exist).load do
+
+  # set :user, (defined?(user) ? user : ENV['USER'])
+  desc "Copies contents of ssh public keys into authorized_keys file"
+  task :setup_ssh_keys do
+    sudo "test -d ~/.ssh || mkdir ~/.ssh"
+    sudo "chmod 0700 ~/.ssh"    
+    put(ssh_options[:keys].collect{|key| File.read(key+'.pub')}.join("\n"),
+      File.join('/home', user, '.ssh/authorized_keys'),
+      :mode => 0600 )
+  end
+  
+end