deprec 1.6.0 → 1.7.0

data/docs/README.slicehost

@@ -0,0 +1,15 @@
+== Slicehost extras
+
+# A freshly built slice gives you the root account
+# This creates a user account with sudo access
+# The '_as_root' means 'log in as root to do this'
+#
+export HOSTS=deptest.deprecated.org
+cap setup_admin_account_as_root
+cap setup_ssh_keys
+cap install_rails_stack
+cap setup
+cap deploy_with_migrations
+cap restart_apache
+
+

data/docs/old_homepage.txt

@@ -0,0 +1,172 @@
+<pre>
+---------------------------
+deprec - Deployment Recipes
+---------------------------
+
+QUICKSTART
+
+To get your rails app running on a stock standard Ubuntu 6.06 server:
+
+cd /path/to/railsapp
+deprec --apply-to . --name projectname --domain www.projectname.com
+# edit config/deploy.rb to put in details of your subversion repository
+cap install_rails_stack
+cap setup
+cap deploy_with_migrations
+cap restart_apache
+
+Read on for installation and usage instructions.
+
+
+WHAT DEPREC IS
+
+Deprec is a collection of automated recipes, written in ruby, for setting 
+up production ready rails servers. The idea is, even if it takes longer to 
+write a general recipe for your situation, rather than just doing it by hand, 
+it's well worth the effort because you get a reliable and reproducible 
+deployment that will work just as well even if it's 3am and a human would be 
+liable to make mistakes with live webservers.
+
+You also get the advantage of a further set of conventions, which means that 
+other tools that you write can build on these conventions, in the same way 
+that the conventions that we already have amongst rails and capistrano users 
+benefit us when writing plugins and gems.
+
+Deprec is designed to take a raw server, and set it up with current best 
+practices for a production web server. This currently means Apache 2.2 for 
+load balancing and static content, and Mongrel for serving rails. Other 
+alternatives can be added later, providing a convention over configuration 
+approach is followed. Version 1.0 of deprec contains recipes specifically 
+for default installations of Ubuntu 6.06 (server), although it also contains 
+tasks which will allow it to be used on slightly non-standard ubuntu 
+installations, such as those provided by slicehost.com.
+
+Deprec has been tested on live VPS hosts with real production sites. It works 
+for me, if it doesn't work for you, then it's easy to extend.
+
+
+WHAT DEPREC ISN'T
+
+Deprec isn't an attempt to solve all problems on all servers. I am solving 
+my own deployment problems, and providing a general framework to help you 
+solve yours. Submissions of recipes for other linux distributions, and maybe 
+even other operating systems, will be accepted and included. If this is 
+popular, some work may be done to allow your own recipes to be managed as individual gems, dependent on the deprec gem.
+
+
+CREDITS
+
+Deprec is written and maintained by Mike Bailey <mike@bailey.net.au>. 
+More about me here: http://codemode.blogspot.com/
+
+Deprec was inspired and uses the brilliantly executed Capistrano. Thanks Jamis!
+
+After starting on this project I found myself reading and utilizing a lot of 
+code by Bradley Taylor, in particular the RailsMachine and VMbuilder gems.
+
+Neil Wilson wrote three capistrano plugins that are used in this project.
+
+I'd like to say a huge thanks to these guys for helping make my work easier!
+
+For the first cut I have included all third party code in a directory within 
+the deprec gem, rather than link to the gems themselves. I made this decision 
+to prevent deprec from breaking due to a change in one of the other libraries.
+
+Thanks to Craig Ambrose for help with testing, documentation and beer.
+
+
+LICENCE
+
+Deprec is licenced under the LGPL. This means that you can use it in commercial 
+or open source applications. More details found here:
+http://www.gnu.org/licenses/lgpl.html
+
+deprec - deployment recipes for capistrano
+Copyright (C) 2006 Mike Bailey
+
+This library is free software; you can redistribute it and/or
+modify it under the terms of the GNU Lesser General Public
+License as published by the Free Software Foundation; either
+version 2.1 of the License, or (at your option) any later version.
+
+This library is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+Lesser General Public License for more details.
+
+You should have received a copy of the GNU Lesser General Public
+License along with this library; if not, write to the Free Software
+Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
+
+
+USAGE
+
+The following instructions describe how to use deprec. Please note that the 
+initial step, installing deprec on your workstation, will patch your copy of 
+capistrano to allow capistrano directives to be placed in a local configuration 
+file ~/.caprc. This patch has been accepted into capistrano and will be 
+available in a later release. The deprec_dotfiles command will not harm future 
+versions of capistrano that already contain this functionality.
+
+Most of the magic of deprec occurs in the install_rails_stack section. This 
+builds the server, which developers previously had to do by hand, or find a 
+hosting company that did it for them. Once that is done, deprec also adds 
+application specific helper tasks, which are shown below in the "deploy a 
+rails app to hosts" section.
+
+Please note that the "deprec --apply-to" command is much like the 
+"cap --apply-to" command, except that it creates a deploy.rb file in your 
+application's config directory with more available settings than capistrano 
+uses, because these settings can be used to configure the application specific 
+aspects of apache and mongrel. 
+
+Important Note:
+Running "deprec --apply-to" currently overwrites your existing deploy.rb file.
+If you have deployed the app elsewhere before, you may want to backup this file
+so that you can refer to it when setting up your deprec generated deploy.rb.
+Because deprec sets up the server, it can fill in more sensible defaults than
+capistrano normally does, but there are still a few settings that you need to
+set yourself. Future versions of deprec will not overwrite this file
+automatically, but will move it out of the way first.
+
+## install deprec on workstation
+#
+sudo gem install deprec -y    # installs what you need
+deprec_dotfiles               # patches capistrano + creates your ~/.caprc
+cap show_tasks		          # now you have deprec tasks included
+
+
+## install rails stack
+#
+# this currently only works with ubuntu 6.06.1 server installed
+# you need to have an account on this machine and sudo access
+#
+export HOSTS=r01,r02,r03      # define some hosts to mess with
+cap setup_ssh_keys            # copy out your public keys
+cap install_rails_stack	      # install apache, rubygems, mongrel, rails, etc.
+unset HOSTS                   # stop overriding cap's hosts list
+
+
+## deploy a rails app to hosts
+#
+# setup dns for your domain or put an entry in /etc/hosts
+cd /path/to/app
+deprec --apply-to . --name bailey --domain bailey.net.au
+cap setup
+# put svn details in config/deploy.rb 
+# or run 'cap setup_scm' to import project
+cap deploy_with_migrations
+cap restart_apache
+
+# update rails app on hosts
+cap deploy			
+cap deploy_with_migrations
+
+
+## some handy tools
+#
+cap show_tasks
+cap disable_web, enable_web   # puts up maintenance page
+cap restart_mongrel_cluster   # does what it says
+
+</pre>

data/lib/deprec/capistrano_extensions/deprec_extensions.rb

@@ -54,7 +54,9 @@ module Deprec
   
   # create new user account on target system
   def useradd(user, options={})
+    options[:shell] ||= '/bin/bash' # new accounts on ubuntu 6.06.1 have been getting /bin/sh
     switches = ''
+    switches += " --shell=#{options[:shell]} " if options[:shell]
     switches += ' --create-home ' unless options[:homedir] == false
     switches += " --gid #{options[:group]} " unless options[:group].nil?
     send(run_method, "grep '^#{user}:' /etc/passwd || sudo /usr/sbin/useradd #{switches} #{user}")

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

@@ -59,8 +59,10 @@ set :apache_server_name, domain
 set :mongrel_address, apache_proxy_address
 # set :mongrel_environment, "production"
 # set :mongrel_config, "/etc/mongrel_cluster/#{application}.conf"
-set :mongrel_user, "mongrel_#{application}"
-set :mongrel_group, "app_#{application}"
+# set :mongrel_user_prefix,  'mongrel_'
+# set :mongrel_user, mongrel_user_prefix + application
+# set :mongrel_group_prefix,  'app_'
+# set :mongrel_group, mongrel_group_prefix + application
 
 # =============================================================================
 # MYSQL OPTIONS

data/lib/deprec/recipes.rb

@@ -13,8 +13,12 @@ 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                  
-  
+  set :app_symlinks, nil
+  set :mongrel_user_prefix,  'mongrel_'
+  set :mongrel_user, lambda {mongrel_user_prefix + application}
+  set :mongrel_group_prefix,  'app_'
+  set :mongrel_group, lambda {mongrel_group_prefix + application}
+    
   desc <<-DESC
   setup_rails_host takes a stock standard ubuntu 'dapper' 6.06.1 server
   and installs everything needed to be a rails machine
@@ -67,7 +71,7 @@ Capistrano.configuration(:must_exist).load do
     
     sudo "chgrp -R #{mongrel_group} #{tmp_dir} #{shared_dir}"
     sudo "chmod 0775 #{tmp_dir} #{shared_dir}" 
-    # set owner and group of mogrels file (if they exist)
+    # set owner and group of mongrels file (if they exist)
     files.each { |file|
       sudo "chown #{mongrel_user} #{file} || exit 0"   
       sudo "chgrp #{mongrel_group} #{file} || exit 0"  
@@ -180,7 +184,19 @@ Capistrano.configuration(:must_exist).load do
       :dir => version,  
       :url => "http://www.apache.org/dist/httpd/#{version}.tar.gz",
       :unpack => "tar zxf #{version}.tar.gz;",
-      :configure => './configure --enable-so --enable-proxy --enable-proxy-balancer --enable-proxy-http --enable-rewrite  --enable-cache --enable-headers --enable-ssl --enable-deflate --with-included-apr;',
+      :configure => %w{
+        ./configure
+        --enable-proxy 
+        --enable-proxy-balancer 
+        --enable-proxy-http 
+        --enable-rewrite  
+        --enable-cache 
+        --enable-headers 
+        --enable-ssl 
+        --enable-deflate 
+        --with-included-apr
+        ;
+        }.reject{|arg| arg.match '#'}.join(' '),
       :make => 'make;',
       :install => 'make install;',
       :post_install => 'install -b support/apachectl /etc/init.d/httpd;'
@@ -200,7 +216,29 @@ Capistrano.configuration(:must_exist).load do
       :dir => version,
       :url => "http://www.php.net/distributions/#{version}.tar.gz",
       :unpack => "tar zxf #{version}.tar.gz;",
-      :configure => "./configure --prefix=/usr/local/php --with-apxs2=/usr/local/apache2/bin/apxs --disable-ipv6 --enable-sockets --enable-soap --with-pcre-regex --with-mysql --with-zlib --with-gettext --with-sqlite --enable-sqlite-utf8 --with-openssl --with-mcrypt --with-ncurses --with-jpeg-dir=/usr --with-gd --with-ctype --enable-mbstring --with-curl==/usr/lib;",
+      :configure => %w{
+        ./configure 
+        --prefix=/usr/local/php
+        --with-apxs2=/usr/local/apache2/bin/apxs
+        --disable-ipv6
+        --enable-sockets
+        --enable-soap
+        --with-pcre-regex
+        --with-mysql
+        --with-zlib 
+        --with-gettext
+        --with-sqlite
+        --enable-sqlite-utf8
+        --with-openssl
+        --with-mcrypt
+        --with-ncurses
+        --with-jpeg-dir=/usr
+        --with-gd
+        --with-ctype
+        --enable-mbstring
+        --with-curl==/usr/lib 
+        ;
+        }.reject{|arg| arg.match '#'}.join(' '),
       :make => 'make;',
       :install => 'make install;',
       :post_install => ""
@@ -212,6 +250,52 @@ Capistrano.configuration(:must_exist).load do
     deprec.append_to_file_if_missing('/usr/local/apache2/conf/httpd.conf', 'AddType application/x-httpd-php .php')
   end
   
+
+  
+  # move all memcache stuff to separate file
+  set :memcache_ip, '127.0.0.1'
+  set :memcache_port, 11211
+  set :memcache_memory, 256
+  
+  # XXX needs thought/work
+  task :memcached_start do
+    run "memcached -d -m #{memcache_memory} -l #{memcache_ip} -p #{memcache_port}"
+  end
+  
+  # XXX needs thought/work
+  task :memcached_stop do
+    run "killall memcached"
+  end
+  
+  # XXX needs thought/work
+  task :memcached_restart do
+    memcached_stop
+    memcached_start
+  end
+  
+  task :install_memcached do
+    version = 'memcached-1.2.2'
+    set :src_package, {
+      :file => version + '.tar.gz',   
+      :md5sum => 'a08851f7fa7b15e92ee6320b7a79c321  memcached-1.2.2.tar.gz', 
+      :dir => version,  
+      :url => "http://www.danga.com/memcached/dist/#{version}.tar.gz",
+      :unpack => "tar zxf #{version}.tar.gz;",
+      :configure => %w{
+        ./configure
+        --prefix=/usr/local 
+        ;
+        }.reject{|arg| arg.match '#'}.join(' '),
+      :make => 'make;',
+      :install => 'make install;',
+      :post_install => 'install -b support/apachectl /etc/init.d/httpd;'
+    }
+    apt.install( {:base => %w(libevent-dev)}, :stable )
+    deprec.download_src(src_package, src_dir)
+    deprec.install_from_src(src_package, src_dir)
+  end
+  
+  
   desc "Setup public symlink directories"
   task :setup_symlinks, :roles => [:app, :web] do
    if app_symlinks
@@ -243,7 +327,7 @@ Capistrano.configuration(:must_exist).load do
      
   task :setup_admin_account do
     user = Capistrano::CLI.password_prompt "Enter userid for new user:" 
-    deprec.useradd(user)
+    deprec.useradd(user, :shell => '/bin/bash')
     puts "Setting pasword for new account"
     sudo_with_input("passwd #{user}", /UNIX password/) # ??? how many  versions of the prompt are there?
     deprec.groupadd('admin')

metadata

@@ -3,8 +3,8 @@ rubygems_version: 0.9.2
 specification_version: 1
 name: deprec
 version: !ruby/object:Gem::Version 
-  version: 1.6.0
-date: 2007-05-07 00:00:00 +10:00
+  version: 1.7.0
+date: 2007-05-08 00:00:00 +10:00
 summary: deployment recipes for capistrano
 require_paths: 
 - lib
@@ -30,8 +30,9 @@ authors: []
 
 files: 
 - bin/deprec
-- docs/apache_config_options.txt
 - docs/building_edge_capistrano.txt
+- docs/old_homepage.txt
+- docs/README.slicehost
 - lib/deprec
 - lib/deprec/capistrano_extensions
 - lib/deprec/generators

data/docs/apache_config_options.txt

@@ -1,101 +0,0 @@
-
-
-deprec
---enable-proxy 
---enable-proxy-balancer 
---enable-proxy-http 
-
---enable-rewrite  
---enable-cache 
---enable-headers 
-
---enable-ssl 
---enable-deflate 
---with-included-apr
-
-new
---enable-proxy=shared 
---enable-proxy-balancer=shared
---enable-proxy-http=shared 
---enable-proxy-html=shared 
-
---enable-rewrite 
---enable-cache
---enable-headers 
-
---enable-ssl=shared 
---enable-deflate 
---with-included-apr 
-
---enable-so 
---enable-cgi 
---enable-info 
---enable-mime-magic 
---enable-usertrack 
---enable-mem-cache 
---enable-modules=all 
---enable-mods-shared=all 
---with-mpm=worker
-
-
-
-
-
-
-Capistrano.configuration(:must_exist).load do
- 
-  desc "Install full apache with mod_php and extras"
-  task :install_full_apache do
-    version = 'httpd-2.2.4'
-    set :src_package, {
-      :file => version + '.tar.gz',   
-      :md5sum => '3add41e0b924d4bb53c2dee55a38c09e  httpd-2.2.4.tar.gz', 
-      :dir => version,  
-      :url => "http://www.apache.org/dist/httpd/#{version}.tar.gz",
-      :unpack => "tar zxf #{version}.tar.gz;",
-      :configure => './configure --enable-so --enable-cgi --enable-info --enable-mime-magic --enable-usertrack --enable-deflate --enable-proxy=shared --enable-proxy-html=shared --enable-proxy-http=shared --enable-proxy-balancer=shared --enable-rewrite --enable-cache --enable-mem-cache --enable-ssl=shared --enable-headers --enable-modules=all --enable-mods-shared=all --with-included-apr --with-mpm=worker;',
-      :make => 'make;',
-      :install => 'make install;',
-      :post_install => 'install -b support/apachectl /etc/init.d/httpd;'
-    }
-    run "export CFLAGS=-O2;"
-    deprec.download_src(src_package, src_dir)
-    deprec.install_from_src(src_package, src_dir)
-    # ubuntu specific - should instead call generic name which can be picked up by different distros
-    send(run_method, "update-rc.d httpd defaults")
-  end
- 
-  desc "Install PHP from source"
-  task :install_php_from_source do
-    version = 'php-5.2.1'
-    set :src_package, {
-      :file => version + '.tar.gz',
-      :dir => version,
-      :url => "http://ca.php.net/distributions/#{version}.tar.gz",
-      :unpack => "tar zxf #{version}.tar.gz;",
-      :configure => "./configure --prefix=/usr/local/php --with-apxs2=/usr/local/apache2/bin/apxs --disable-ipv6 --enable-sockets --enable-soap --with-pcre-regex --with-mysql --with-zlib --with-gettext --with-sqlite --enable-sqlite-utf8 --with-openssl --with-mcrypt --with-ncurses --with-jpeg-dir=/usr --with-gd --with-ctype --enable-mbstring --with-curl==/usr/lib;",
-      :make => 'make;',
-      :install => 'make install;',
-      :post_install => ""
-    }
-    apt.install( {:base => %w(flex libcurl3 libcurl3-dev libmcrypt-dev libmysqlclient15-dev libncurses5-dev)}, :stable )
-    run "export CFLAGS=-O2;"
-    deprec.download_src(src_package, src_dir)
-    deprec.install_from_src(src_package, src_dir)
-  end
-      
-  desc "Install apache, ruby, php, and server extras"
-  task :install_full_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_rmagick
-    install_postfix
-    install_full_apache
-    install_php_from_source # php must be installed after apache, needs 'apxs' in apache2/bin
-  end
- 
-end