winton-ubistrano 1.2.2

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2008 AppTower
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.markdown

@@ -0,0 +1,116 @@
+Ubistrano
+=========
+
+Provision and deploy to an Ubuntu/God/Apache/Passenger stack using Capistrano.
+
+Goals
+-----
+
+* Provision a solid Ubuntu Hardy application server in one command (<code>cap ubuntu</code>)
+* Deploy PHP, Rails, and Sinatra apps
+* Be descriptive about what is going on and allow the user to opt out
+* Simplify the deploy.rb file
+
+The stack
+---------
+
+* Apache
+* Git
+* MySQL
+* MySQLTuner
+* Perl
+* PHP
+* Postfix (relay)
+* Ruby
+* RubyGems
+* Passenger (mod\_rails)
+* God
+* Rails
+* Sinatra
+* Sphinx
+
+
+Getting started
+---------------
+
+### Install gem
+
+	gem install winton-ubistrano
+
+### Capify your project
+
+	capify .
+
+### Edit config/deploy.rb
+
+<pre>
+set :ubistrano, {
+  :application => :my_app,
+  :platform    => :rails,  # :php, :rails, :sinatra
+  :repository  => 'git@github.com:user/my-app.git',
+
+  :ec2 => {
+    :access_key => '',
+    :secret_key => ''
+  },
+
+  :production => {
+    :domains => [ 'myapp.com', 'www.myapp.com' ],
+    :ssl     => [ 'myapp.com' ],
+    :host    => '127.0.0.1'
+  },
+
+  :staging => {
+    :domains => [ 'staging.myapp.com' ],
+    :host    => '127.0.0.1'
+  }
+}
+
+require 'ubistrano'
+</pre>
+
+Ubistrano uses the same Capistrano options you've come to love, but provides defaults and a few extra options as well.
+
+Feel free to add standard options like :user to the stage groups.
+
+Set up your Ubuntu Hardy server
+-------------------------------
+
+### From your app directory
+
+<pre>cap ubuntu</pre>
+
+### Example output
+
+<pre>
+=================================================================================
+Let's set up an Ubuntu server! (Tested with 8.04 LTS Hardy)
+
+With each task, Ubistrano will describe what it is doing, and wait for a yes/no.
+
+=================================================================================
+Have you already created the user defined in deploy.rb? (y/n)
+</pre>
+
+Deploy your app
+---------------
+
+All apps should have a <code>public</code> directory.
+
+### First deploy
+
+	cap deploy:first
+	
+### Subsequent deploys
+
+	cap deploy
+
+
+Deploy to staging
+-----------------
+
+Use any capistrano task, but replace `cap` with `cap staging`.
+
+### Example
+
+	cap staging deploy:first

data/Rakefile

@@ -0,0 +1,31 @@
+require 'rake'
+
+task :default => 'ubistrano.gemspec'
+
+file 'ubistrano.gemspec' => FileList['{example,lib,templates}/**','Rakefile'] do |f|
+  # read spec file and split out manifest section
+  spec = File.read(f.name)
+  parts = spec.split("  # = MANIFEST =\n")
+  fail 'bad spec' if parts.length != 3
+  # determine file list from git ls-files
+  files = `git ls-files`.
+    split("\n").
+    sort.
+    reject{ |file| file =~ /^\./ }.
+    reject { |file| file =~ /^doc/ }.
+    map{ |file| "    #{file}" }.
+    join("\n")
+  # piece file back together and write...
+  parts[1] = "  s.files = %w[\n#{files}\n  ]\n"
+  spec = parts.join("  # = MANIFEST =\n")
+  File.open(f.name, 'w') { |io| io.write(spec) }
+  puts "Updated #{f.name}"
+end
+
+# sudo rake install
+task :install do
+  `gem uninstall ubistrano`
+  `gem build ubistrano.gemspec`
+  `gem install ubistrano*.gem`
+  `rm ubistrano*.gem`
+end

data/changelog.markdown

@@ -0,0 +1,24 @@
+Version 1.2.2
+-------------
+
+* Hardened cap ec2 -> cap ubuntu -> cap ubuntu:install
+* There should be nothing to cause the user to stop and restart the tasks
+
+Version 1.2.0
+-------------
+
+* New EC2 tasks
+* EC2 setup and `cap ubuntu` provision tested
+
+Version 1.1.0
+-------------
+
+* Sinatra apps deploying properly
+* PHP and Rails apps should be deploying properly
+* `cap ubuntu` flow hardened
+
+Version 1.0.3
+-------------
+
+* `cap ubuntu` tested on Ubuntu 8.04 LTS Hardy
+* App deploying not at all tested

data/example/deploy.rb

@@ -0,0 +1,23 @@
+set :ubistrano, {
+  :application => :my_app,
+  :platform    => :rails,  # :php, :rails, :sinatra
+  :repository  => 'git@github.com:user/my-app.git',
+  
+  :ec2 => {
+    :access_key => '',
+    :secret_key => ''
+  },
+  
+  :production => {
+    :domains => [ 'myapp.com', 'www.myapp.com' ],
+    :ssl     => [ 'myapp.com' ],
+    :host    => '127.0.0.1'
+  },
+  
+  :staging => {
+    :domains => [ 'staging.myapp.com' ],
+    :host    => '127.0.0.1'
+  }
+}
+
+require 'ubistrano'

data/lib/ubistrano/apache.rb

@@ -0,0 +1,38 @@
+Capistrano::Configuration.instance(:must_exist).load do
+  
+  namespace :apache do
+    desc "Reload apache settings"
+    task :reload, :roles => :web do
+      sudo_puts "/etc/init.d/apache2 reload"
+    end
+    
+    desc "Restart apache"
+    task :restart, :roles => :web do
+      sudo_puts "/etc/init.d/apache2 restart"
+    end
+    
+    namespace :virtual_host do
+      desc "Create a new virtual host"
+      task :create, :roles => :web do
+        upload_from_erb "/etc/apache2/sites-available/#{application}_#{stage}", binding, :name => 'virtual_host', :folder => 'apache'
+      end
+      
+      desc "Enable a virtual host"
+      task :enable, :roles => :web do
+        sudo_puts "a2ensite #{application}_#{stage}"
+      end
+      
+      desc "Destroy a virtual host"
+      task :destroy, :roles => :web do
+        apache.virtual_host.disable
+        sudo_each "rm /etc/apache2/sites-available/#{application}_#{stage}"
+      end
+      
+      desc "Disable a virtual host"
+      task :disable, :roles => :web do
+        sudo_puts "a2dissite #{application}_#{stage}"
+      end
+    end
+  end
+
+end

data/lib/ubistrano/deploy.rb

@@ -0,0 +1,64 @@
+Capistrano::Configuration.instance(:must_exist).load do
+  
+  namespace :deploy do
+    desc "Restart application"
+    task :restart, :roles => :app, :except => { :no_release => true } do
+      run_each "touch #{current_path}/tmp/restart.txt"
+    end
+
+    desc "Start application"
+    task :start, :roles => :app do
+      apache.virtual_host.enable
+    end
+
+    desc "Stop application"
+    task :stop, :roles => :app do
+      apache.virtual_host.disable
+    end
+    
+    desc "Deploy for the first time"
+    task :first, :roles => :app do
+      sudo_each [
+        "mkdir -p #{base_dir}",
+        "chown -R #{user}:#{user} #{base_dir}"
+      ]
+      mysql.create.db
+      deploy.setup
+      case platform
+      when :php
+        deploy.update
+      when :rails
+        rails.config.default
+        deploy.update
+        deploy.migrate
+      when :sinatra
+        sinatra.config.default
+        deploy.update
+        sinatra.install
+      end
+      apache.virtual_host.create
+      deploy.start
+      apache.reload
+    end
+  
+    desc "Stop servers and destroy all files"
+    task :destroy, :roles => :app do
+      sudo_each "rm -Rf #{deploy_to}"
+      mysql.destroy.db
+      apache.virtual_host.destroy
+    end
+    
+    namespace :web do
+      task :disable do
+        pub = "#{deploy_to}/current/public"
+        sudo_each "mv #{pub}/maintenance.html #{pub}/index.html"
+      end
+      
+      task :enable do
+        pub = "#{deploy_to}/current/public"
+        sudo_each "mv #{pub}/index.html #{pub}/maintenance.html"
+      end
+    end
+  end
+  
+end

data/lib/ubistrano/ec2.rb

@@ -0,0 +1,113 @@
+Capistrano::Configuration.instance(:must_exist).load do
+  
+  namespace :ec2 do
+    desc "Set up a new EC2 instance and provision"
+    task :default, :roles => :web do
+      ec2.key_pair.install
+      ec2.instance.create
+      ec2.security.group.setup if yes("Set up the default security group? You only need to do this once.")
+      exit unless yes("Add the instance's IP address to config/deploy.rb. Continue?")
+      puts space(msg(:ec2_finished))
+    end
+    
+    namespace :instance do      
+      desc "Create a fresh Hardy instance"
+      task :create do
+        options = {
+          :image_id => ask('Press enter for Ubuntu Hardy or enter an AMI image id: ', 'ami-1c5db975'),
+          :key_name => "#{application}"
+        }
+        instance = ec2_api.run_instances(options).instancesSet.item[0]
+        instance_id = instance.instanceId
+        pp instance
+        ip = ec2_api.allocate_address.publicIp
+        ec2_api.associate_address(:instance_id => instance_id, :public_ip => ip)
+        puts "\nYour instance id is: #{instance_id}"
+        puts "Your IP address  is: #{ip}"
+      end
+      
+      desc "Restart an instance"
+      task :restart do
+        ec2.instances
+        pp ec2_api.reboot_instances(:instance_id => ask("Restart which instance ids?"))
+      end
+      
+      desc "Destroy an instance"
+      task :destroy do
+        ec2.instances
+        instance_id = ask("Terminate which instance ids?")
+        ec2_api.terminate_instances(:instance_id => instance_id)
+        ip = ec2_api.describe_addresses.addressesSet.item.select { |x| x.instanceId == instance_id }.first
+        ec2_api.release_address(:public_ip => ip.publicIp) if ip
+      end
+    end
+    
+    desc "List your EC2 instances"
+    task :instances do
+      pp ec2_api.describe_instances
+    end
+    
+    desc "List IPs for this EC2 account"
+    task :ips do
+      pp ec2_api.describe_addresses
+    end
+    
+    namespace :key_pair do
+      desc "Install key pair for SSH"
+      task :install do
+        begin
+          out = ec2_api.create_keypair(:key_name => application.to_s)
+          key = out.keyMaterial
+        rescue EC2::InvalidKeyPairDuplicate
+          ec2.key_pair.remove
+          ec2.key_pair.install
+        end
+        File.open(File.expand_path("~/.ssh/id_rsa-#{application}"), 'w') { |f| f.write key }
+      end
+
+      desc "Install key pair for SSH"
+      task :remove do
+        ec2_api.delete_keypair(:key_name => application.to_s)
+        `rm ~/.ssh/id_rsa-#{application}`
+      end
+    end
+    
+    namespace :security do
+      namespace :group do
+        desc "Open standard ports for default security group"
+        task :setup do
+          [ 22, 80, 443 ].each do |port|
+            ec2_api.authorize_security_group_ingress(
+              :group_name => 'default', :cidr_ip => '0.0.0.0/0', :from_port => port, :to_port => port, :ip_protocol => 'tcp'
+            )
+          end
+        end
+        
+        desc "Describe default security group"
+        task :describe do
+          pp ec2_api.describe_security_groups(:group_name => 'default')
+        end
+      end
+    end
+    
+    namespace :api_tools do
+      desc "Install ec2 api tools locally"
+      task :install, :roles => :web do
+        `cd ~ && curl http://s3.amazonaws.com/ec2-downloads/ec2-api-tools.zip -O`
+        `cd ~ && unzip ec2-api-tools.zip`
+        `cd ~ && rm ec2-api-tools.zip`
+        `mv ~/ec2-api-tools-* ~/.ec2`
+      end
+      
+      desc "Install ec2 api tools locally"
+      task :remove, :roles => :web do
+        `rm -Rf ~/.ec2`
+      end
+    end
+    
+    def ec2_api
+      @ec2_api ||= EC2::Base.new(:access_key_id => ec2_access_key, :secret_access_key => ec2_secret_key)
+    end
+  end
+  
+end

data/lib/ubistrano/gems.rb

@@ -0,0 +1,29 @@
+Capistrano::Configuration.instance(:must_exist).load do
+  
+  namespace :gems do  
+    desc "List gems on remote server"
+    task :list, :roles => :app do
+      run_puts "gem list"
+    end
+    
+    desc "Update gems on remote server"
+    task :update, :roles => :app do
+      sudo_each [
+        "gem update --system",
+        "gem update"
+      ]
+    end
+    
+    desc "Install a remote gem"
+    task :install, :roles => :app do
+      gem_install ask('Enter the name of the gem to install:')
+    end
+    
+    desc "Uninstall a remote gem"
+    task :uninstall, :roles => :app do
+      gem_name = ask 'Enter the name of the gem to remove:'
+      sudo "gem uninstall #{gem_name}"
+    end
+  end
+
+end