bcalloway-slicehost 0.6.1 → 0.7.5

data/{README → README.textile}

@@ -1,95 +1,225 @@
-Slicehost Recipes
-=================
+h1. Slicehost Recipes
 
 Note:  This is a fork of the original slicehost Capistrano recipies by Joshua Peek
 
-Slicehost Capistrano recipes for configuring and managing your slice. Require Capistrano >2.5.0
-
-Setup
-=======
-
-The recipes are designed to work stand alone apart from the standard set of Capistrano deploy recipes.
-
-  require 'capistrano/ext/slicehost' in your deploy.rb file
-
-Note
-===================
-You  may need to install mysql manually:
-sudo "aptitude install -y mysql-server mysql-client libmysqlclient15-dev"
-sudo "aptitude install -y libmysql-ruby1.8"
-
-Slice setup recipes 
-====================
-
-Commonly used setup recipies. Check the source for more.
+Slicehost Capistrano recipes for configuring and managing your slice. Require Capistrano >2.5.0.
+
+*Requirements*
+* Ubuntu 9.10 or newer
+* Root access
+* Capistrano
+
+h3. Sample Capitrano Deploy Recipe
+
+The following is a sample portion of a Capistrano deploy recipe.  All the following options need to be set, although you might have some additions depending on your specific setup.
+
+<pre><code>
+  set :project, 'myproject' # The name of the project in your GitHub repo 
+
+  set :github_user, "username" # Your GitHub username
+  set :domain_name, "mydomain.com" # should be something like mydomain.com
+  set :user, 'username' # server username
+  set :domain, 'XXX.XXX.XX.XX' # server IP address
+  set :domain_prefix, "mydomain" # the production domain name prefix (no www. or .com)
+  set :domain_suffix, "com" # Is this a .com, .net, or .org? (just use the 2 letters, no dot)
+  set :passenger_version, "2.2.14"
+
+  default_run_options[:pty] = true
+  ssh_options[:forward_agent] = true
+  ssh_options[:port] = 22 # or change this to an alternate port if you want
+
+  set :repository,  "git@github.com:#{github_user}/#{project}.git" #GitHub clone URL
+  set :scm, "git"
+  set :scm_passphrase, "" # This is the passphrase (if any) for the ssh key on the server deployed to
+  set :branch, "master" # or whatever branch you deploy from
+  set :scm_verbose, true
+  set :subdomain, "#{project}.#{domain_name}"
+  set :application, project
+  set :applicationdir, "/home/#{project}" # or whatever directory you want to deploy to
+
+  # Don't change this stuff, but you may want to set shared files at the end of the file ##################
+  # deploy config
+  set :deploy_to, applicationdir
+  set :deploy_via, :remote_cache
+
+  # roles (servers)
+  role :app, domain
+  role :web, domain
+  role :files, domain
+  role :gateway, domain
+  role :gateway_as_root, domain
+  role :db,  domain, :primary => true
+  
+  #################################
+  # All your other deploy settings below here.
+</code></pre>
+
+h3. Setup
+
+In config/deploy.rb:
+<pre><code>
+  require 'capistrano/ext/slicehost'
+</code></pre>
+
+In your project root, type the following to see a full list of commands:
+<pre><code>
+  cap -T
+</code></pre>
+
+h3. Usage
+
+First, setup a normal user. Be sure your capistrano deploy recipe is set to use the root user.
+<pre><code>
+  cap useradd:setup
+</code><pre>
+
+Now, change your capistrano deploy recipe to use the user you just created, and continue.
+
+<pre><code>
+  cap slice:configure
+</code><pre>
+  
+This task performs the following:
+* Sets-up and secures ssh
+* Creates a .bash_profile with helpful shortcuts and colors and creates a nano editor profile
+* Sets-up and secures the system with iptables
+* Installs and updates aptitude, and provisions the server with essential services
+* Sets-up and installs vim
+* Sets-up and installs imagemagick
+
+Next, we install a full Ruby stack:<br />
+* Apache
+* Ruby1.8
+* RubyGems
+* Passenger
+* Git
+<pre><code>
+  cap slice:provision
+</code><pre>
+
+_Note: if you choose to go back and install a Ruby verison other than 1.8.x, you will need to reinstall Passenger_
+
+Now install Rails (it will prompt for what gem you want to install, in this case, type "rails")
+<pre><code>
+  cap gems:install
+</code><pre>
+  
+You will need to ssh into the server in order to setup mysql and postfix:  
+<pre><code>
+  sudo aptitude install -y mysql-server mysql-client libmysqlclient15-dev libmysql-ruby1.8
+  sudo aptitude install postfix telnet heirloom-mailx
+</code></pre>
+
+For more information on installing Postfix, see this: "http://articles.slicehost.com/2008/7/29/postfix-installation":http://articles.slicehost.com/2008/7/29/postfix-installation
+
+That should be it for a basic, Rails server.
+
+h3. Slice setup recipes 
+
+Commonly used setup recipes. Check the source for more.
 
 Setup ssh, iptables and aptitude
+<pre><code>
 	cap slice:configure
-
-Setup mysql
-	cap mysql:install
+</code></pre>
 
 Install Apache
+<pre><code>
 	cap apache:install
+</code></pre>
 
 Install ruby 1.8
+<pre><code>
 	cap ruby:setup_18
+</code></pre>
 
 Install ruby enterprise
+<pre><code>
 	cap ruby:install_enterprise
+</code></pre>
 
 Install ruby gems
+<pre><code>
 	cap gems:install_rubygems
+</code></pre>
 
 Install passenger
+<pre><code>
 	cap ruby:install_passenger
+</code></pre>
 
 Upload vhost template
+<pre><code>
 	cap apache:upload_vhost
+</code></pre>
 
 Install git
+<pre><code>
 	cap git:install
+</code></pre>
 
-Maintenance recipies
-====================
+h3. Maintenance recipes
 
-Commonly used maitenance recipies. Check the source for more.
+Commonly used maintenance recipes. Check the source for more.
 
 Show disk space
+<pre><code>
 	cap disk:free
+</code></pre>
 
 Show free memory
+<pre><code>
 	cap disk:memory
+</code></pre>
 
 Update aptitude
+<pre><code>
 	cap aptitude:update
+</code></pre>
 
 Upgrade aptitude
+<pre><code>
 	cap aptitude:upgrade
+</code></pre>
 
 Install package (it will ask you which)
+<pre><code>
 	cap aptitude:install
+</code></pre>
 
 Reload SSH
+<pre><code>
 	cap ssh:reload
+</code></pre>
 
 Install a gem (it will ask you which)
+<pre><code>
 	cap gems:intall
+</code></pre>
 
 List gems
+<pre><code>
 	cap gems:list
+</code></pre>
 
 Restart apache
+<pre><code>
 	cap apache:restart
+</code></pre>
 
 Reload apache
+<pre><code>
 	cap apache:reload
+</code></pre>
 
 Force reload apache
+<pre><code>
 	cap apache:force_reload
+</code></pre>
+
+h3. All Recipes
 
-All Recipes
-===================
+<pre><code>
 cap apache:available_modules      # List available Apache modules
 cap apache:available_sites        # List available Apache sites
 cap apache:disable_module         # Disable Apache module
@@ -164,12 +294,9 @@ cap useradd:setup                 # Interactive adduser
 cap vim:install                   # install vim from aptitude
 cap vim:load_vimrc                # load up a simple .vimrc
 cap vim:setup                     # setup vim on slicehost
+</code></pre>
 
-
-
-Contributors
-============
-
+*Contributors*
 * Oleg Zhurbiy
 * Thomas Balthazar
 * Fran Diéguez

data/lib/capistrano/ext/slicehost/apache.rb

@@ -3,6 +3,16 @@ set(:domain) do
 end
 
 namespace :apache do
+  desc "Install and setup Apache, create vhost container, and enable site"
+  task :setup do
+    install
+    sudo "sudo a2enmod rewrite"
+    upload_vhost
+    sudo "sudo a2ensite #{application}"
+    reload
+    restart
+  end
+  
   desc "Restarts Apache webserver"
   task :restart, :roles => :web do
     sudo "/etc/init.d/apache2 restart"
@@ -80,6 +90,7 @@ namespace :apache do
   task :upload_vhost, :roles => :web do
     put render("vhost", binding), application
     sudo "mv #{application} /etc/apache2/sites-available/#{application}"
+    sudo "chown root:root /etc/apache2/sites-available/#{application}"
   end
 
   desc "Install Apache"

data/lib/capistrano/ext/slicehost/gems.rb

@@ -3,7 +3,7 @@ namespace :gems do
   task :install_rubygems, :roles => :app do
     rubygems_url = "http://rubyforge.org/" + Net::HTTP.get( URI.parse('http://rubyforge.org/frs/?group_id=126') ).scan(/frs\/.*\.tgz/).first.split('"')[0]
     rubygems_version = rubygems_url[/(rubygems.*)(.tgz)/, 1]
-    run "test ! -f /usr/bin/gem"
+    #run "test ! -f /usr/bin/gem"
     run "wget -q #{rubygems_url}"
     run "tar xzvf #{rubygems_version}.tgz"
     run "rm #{rubygems_version}.tgz"

data/lib/capistrano/ext/slicehost/iptables.rb

@@ -6,8 +6,8 @@ namespace :iptables do
     http://articles.slicehost.com/2008/4/25/ubuntu-hardy-setup-page-1
   DESC
   task :configure, :roles => :gateway do
-    put render("iptables", binding), "iptables.test.rules"
-    sudo "mv iptables.test.rules /etc/iptables.test.rules"
+    put render("iptables", binding), "iptables.up.rules"
+    sudo "mv iptables.up.rules /etc/iptables.up.rules"
 
     if capture("cat /etc/network/interfaces").grep(/iptables/).empty?
       run %(cat /etc/network/interfaces |
@@ -18,7 +18,12 @@ namespace :iptables do
       sudo "mv interfaces /etc/network/interfaces"
     end
     
-    sudo "iptables-restore < /etc/iptables.test.rules"
+    sudo "iptables-restore < /etc/iptables.up.rules"
     sudo "iptables-save > /etc/iptables.up.rules"
+    
+    put render("iptables_reboot", binding), "iptables_reboot"
+    sudo "mv iptables_reboot /etc/network/if-pre-up.d/iptables_reboot"
+    sudo "chmod +x /etc/network/if-pre-up.d/iptables_reboot"
+    
   end
 end

data/lib/capistrano/ext/slicehost/ruby.rb

@@ -8,24 +8,25 @@ set :ruby_enterprise_version do
   "#{ruby_enterprise_url[/(ruby-enterprise.*)(.tar.gz)/, 1]}"
 end
 
-set :passenger_version do
-  capture("gem list passenger$ -r").gsub(/[\n|\s|passenger|(|)]/,"")
-end
-
 namespace :ruby do
   desc "Install Ruby 1.8"
   task :setup_18, :roles => :app do
     sudo "aptitude install -y ruby1.8-dev ruby1.8 ri1.8 rdoc1.8 irb1.8 libreadline-ruby1.8 libruby1.8 libopenssl-ruby sqlite3 libsqlite3-ruby1.8"
-
-    # sudo "ln -s /usr/bin/ruby1.8 /usr/bin/ruby"
-    # sudo "ln -s /usr/bin/ri1.8 /usr/bin/ri"
-    # sudo "ln -s /usr/bin/rdoc1.8 /usr/bin/rdoc"
-    # sudo "ln -s /usr/bin/irb1.8 /usr/bin/irb"
+    sudo "ln -s /usr/bin/ruby1.8 /usr/bin/ruby"
+    sudo "ln -s /usr/bin/ri1.8 /usr/bin/ri"
+    sudo "ln -s /usr/bin/rdoc1.8 /usr/bin/rdoc"
+    sudo "ln -s /usr/bin/irb1.8 /usr/bin/irb"
   end
 
   desc "Install Ruby 1.9"
   task :setup_19, :roles => :app do
-    sudo "aptitude install -y ruby1.9.1-dev libruby1.9.1 ruby1.9.1 ri1.9.1 rdoc1.9.1 irb1.9.1 libreadline-ruby1.9.1  libopenssl-ruby1.9.1 sqlite3 libsqlite3-ruby1.9.1"
+    sudo "aptitude -q -y install libc6-dev libssl-dev libmysql++-dev libsqlite3-dev make build-essential libssl-dev libreadline5-dev zlib1g-dev"
+    run "wget ftp://ftp.ruby-lang.org/pub/ruby/1.9/ruby-1.9.1-p243.tar.gz"
+    run "tar zxvf ruby-1.9.1-p243.tar.gz"
+    run "cd ruby-1.9.1-p243"
+    run "./configure"
+    run "make"
+    sudo "make install"
   end
   
   desc "Install Ruby Enterpise Edition"
@@ -44,8 +45,8 @@ namespace :ruby do
   task :install_passenger_apache, :roles => :app do
     sudo "apt-get install apache2-mpm-prefork"
     sudo "aptitude install -y apache2-prefork-dev"
-    sudo "/opt/#{ruby_enterprise_version}/bin/ruby /opt/#{ruby_enterprise_version}/bin/gem install passenger rake --no-rdoc --no-ri"
-    sudo "PATH='/opt/#{ruby_enterprise_version}/bin/':\$PATH /opt/#{ruby_enterprise_version}/bin/ruby /opt/#{ruby_enterprise_version}/bin/passenger-install-apache2-module --auto"
+    sudo "gem install passenger -v #{passenger_version}"
+    sudo "passenger-install-apache2-module --auto"
 
     put render("passenger.load", binding), "/home/#{user}/passenger.load"
     put render("passenger.conf", binding), "/home/#{user}/passenger.conf"

data/lib/capistrano/ext/slicehost/slice.rb

@@ -8,6 +8,15 @@ namespace :slice do
     vim.setup
     imagemagick.install
   end
+  
+  desc "Provision the server with a full Rails stack"
+  task :provision do
+    apache.setup
+    ruby.setup_18
+    gems.install_rubygems
+    ruby.install_passenger_apache
+    git.install
+  end
 end
 
 namespace :imagemagick do

data/lib/capistrano/ext/slicehost/ssh.rb

@@ -13,7 +13,7 @@ namespace :ssh do
     then reloads the SSH service to finalize the changes.
   DESC
   task :setup, :roles => :gateway do
-    upload_keys
+    #upload_keys
     configure_sshd
     reload
   end

data/lib/capistrano/ext/slicehost/templates/iptables_reboot.erb

@@ -0,0 +1,2 @@
+#!/bin/sh
+/sbin/iptables-restore < /etc/iptables.up.rules

data/lib/capistrano/ext/slicehost/templates/passenger.conf.erb

@@ -1,2 +1,2 @@
-PassengerRoot /opt/<%= ruby_enterprise_version %>/lib/ruby/gems/1.8/gems/passenger-<%= passenger_version %>
-PassengerRuby /opt/<%= ruby_enterprise_version %>/bin/ruby
+PassengerRoot /usr/lib/ruby/gems/1.8/gems/passenger-<%= passenger_version %>
+PassengerRuby /usr/bin/ruby1.8

data/lib/capistrano/ext/slicehost/templates/passenger.load.erb

@@ -1 +1 @@
-LoadModule passenger_module /opt/<%= ruby_enterprise_version %>/lib/ruby/gems/1.8/gems/passenger-<%= passenger_version %>/ext/apache2/mod_passenger.so
+LoadModule passenger_module /usr/lib/ruby/gems/1.8/gems/passenger-<%= passenger_version %>/ext/apache2/mod_passenger.so

data/lib/capistrano/ext/slicehost/templates/vhost.erb

@@ -1,8 +1,11 @@
 <VirtualHost *:80>
 
-  ServerName  <%= domain %>
-  ServerAlias www.<%= domain %>
+  ServerName  <%= domain_name %>
+  ServerAlias www.<%= domain_name %>
 
   DocumentRoot <%= current_path %>/public
-
+  
+  RewriteEngine on
+  RewriteCond %{HTTP_HOST} ^www\.<%= domain_prefix %>\.<%= domain_suffix %>$ [NC]
+  RewriteRule ^(.*)$ http://<%= domain_prefix %>.<%= domain_suffix %>$1 [L,R=301]
 </VirtualHost>

metadata

@@ -4,9 +4,9 @@ version: !ruby/object:Gem::Version
   prerelease: false
   segments: 
   - 0
-  - 6
-  - 1
-  version: 0.6.1
+  - 7
+  - 5
+  version: 0.7.5
 platform: ruby
 authors: 
 - Joshua Peek, Brandon Calloway
@@ -14,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-05-26 00:00:00 -04:00
+date: 2010-06-04 00:00:00 -04:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -38,10 +38,9 @@ executables: []
 extensions: []
 
 extra_rdoc_files: 
-- README
+- README.textile
 files: 
 - MIT-LICENSE
-- README
 - lib/capistrano/ext/slicehost.rb
 - lib/capistrano/ext/slicehost/apache.rb
 - lib/capistrano/ext/slicehost/aptitude.rb
@@ -60,6 +59,7 @@ files:
 - lib/capistrano/ext/slicehost/ssh.rb
 - lib/capistrano/ext/slicehost/templates/bashrc.erb
 - lib/capistrano/ext/slicehost/templates/iptables.erb
+- lib/capistrano/ext/slicehost/templates/iptables_reboot.erb
 - lib/capistrano/ext/slicehost/templates/istatdlauncher.erb
 - lib/capistrano/ext/slicehost/templates/mydircolors.erb
 - lib/capistrano/ext/slicehost/templates/nanorc.erb
@@ -71,6 +71,7 @@ files:
 - lib/capistrano/ext/slicehost/templates/vimrc.erb
 - lib/capistrano/ext/slicehost/useradd.rb
 - lib/capistrano/ext/slicehost/vim.rb
+- README.textile
 has_rdoc: true
 homepage: http://github.com/bcalloway/slicehost
 licenses: []