capper 1.1.0 → 1.2.0

data/.gitignore

@@ -46,3 +46,4 @@ pkg
 
 # For rubinius:
 #*.rbc
+.idea/

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    capper (1.0.1)
+    capper (1.2.0)
       capistrano (~> 2.12.0)
       capistrano_colors (~> 0.5.5)
       dedent

data/README.rst

@@ -225,6 +225,12 @@ ruby
 The ruby recipe provides basic support for Ruby applications. It will setup a
 gemrc file and and variables for ``ruby_exec_prefix`` (such as bundler).
 
+thin
+----
+
+The thin recipe provides integration with Thin. A script to manage the
+thin process is uploaded to ``#{bin_path}/thin``.
+
 unicorn
 -------
 
@@ -267,6 +273,41 @@ integration. With one application per user account the whole crontab can be
 used for whenever. Additionally this recipe take the ``ruby_exec_prefix``
 setting into account.
 
+node deployment
+--------
+read http://big-elephants.com/2012-07/deploying-node-with-capistrano/ about the
+the use case.
+
+nave
+--------
+
+The nave recipe sets up nave Virtual Environments for Node::
+
+  set :use_nave, true
+  set :nave_dir, '~/.nave'
+  set :node_version, '0.8.1'
+
+npm
+--------
+
+The npm recipe runs npm install after deploy:update_code. When used with the nave
+recipe npm install runs ``nave use <ver> npm install``.
+Not it is recommended to add npm-shrinkwrap.json into version control to manage npm
+dependencies::
+
+  set :npm_cmd, "npm"
+
+forever
+--------
+
+The forever recipe starts your app as daemon in the background.
+When used with the nave recipe it runs ``nave use <ver> forever [action]``::
+
+  set :forever_cmd, "forever" # e.g. "./node_modules/.bin/forever"
+  set :node_env, "production" # the NODE_ENV environment variable used to start the script
+  set :main_js, "index.js" # e.g. "./build/main.js" the script you want to start
+
+
 Contributing to capper
 ======================
 

data/lib/capper/bundler.rb

@@ -10,7 +10,7 @@ set(:ruby_exec_prefix, "bundle exec")
 set(:bundle_dir) do
   begin
     File.join(shared_path, 'bundle', rvm_ruby_string)
-  rescue NoMethodError
+  rescue NoMethodError, NameError
     File.join(shared_path, 'bundle')
   end
 end

data/lib/capper/forever.rb

@@ -0,0 +1,97 @@
+after "deploy:restart", "forever:restart"
+after "deploy:start", "forever:start"
+after "deploy:stop", "forever:stop"
+
+namespace :forever do
+  desc <<-DESC
+    Start the servers using the forever cmd If the forever cmd cannot \
+    be found then you can override the forever_cmd variable to specify \
+    which one it should use.
+    By default index.js in the applications root folder will be used for startup.
+
+    You can override any of these defaults by setting the variables shown below.
+
+      set :forever_cmd,      "forever" # e.g. "./node_modules/.bin/forever"
+      set :main_js,          "index.js" # e.g. "./build/main.js"
+      set :node_env,         "production" # the NODE_ENV environment variable used to start the script
+  DESC
+  task :start, :roles => :app do
+    forever_cmd     = fetch(:forever_cmd, "forever")
+    main_js         = fetch(:main_js, "index.js")
+    app_path        = fetch(:latest_release)
+    node_env        = fetch(:node_env,'production')
+    if app_path.to_s.empty?
+      raise error_type.new("Cannot detect current release path - make sure you have deployed at least once.")
+    end
+    prefix  = fetch(:use_nave, false) ? "#{fetch(:nave_dir)}/nave.sh use #{fetch(:node_version, 'stable')}" :''
+    run "cd #{app_path} && NODE_ENV=#{node_env} #{prefix} #{forever_cmd} start #{main_js}"
+  end
+
+  desc <<-DESC
+    Stop the servers using the forever cmd If the forever cmd cannot \
+    be found then you can override the forever_cmd variable to specify \
+    which one it should use.
+    By default index.js in the applications root folder will be used for startup.
+
+    You can override any of these defaults by setting the variables shown below.
+
+      set :forever_cmd,      "forever" # e.g. "./node_modules/.bin/forever"
+      set :main_js,          "index.js" # e.g. "./build/main.js"
+      set :node_env,         "production" # the NODE_ENV environment variable used to start the script
+  DESC
+  task :stop, :roles => :app  do
+    forever_cmd     = fetch(:forever_cmd, "forever")
+    main_js         = fetch(:main_js, "index.js")
+    app_path        = fetch(:latest_release)
+    node_env        = fetch(:node_env,'production')
+    if app_path.to_s.empty?
+      raise error_type.new("Cannot detect current release path - make sure you have deployed at least once.")
+    end
+    prefix  = fetch(:use_nave, false) ? "#{fetch(:nave_dir)}/nave.sh use #{fetch(:node_version, 'stable')}" :''
+    run "cd #{app_path} && NODE_ENV=#{node_env} #{prefix} #{forever_cmd} stop #{main_js}"
+  end
+  desc <<-DESC
+    Restart the servers using the forever cmd If the forever cmd cannot \
+    be found then you can override the forever_cmd variable to specify \
+    which one it should use.
+    By default index.js in the applications root folder will be used for startup.
+
+    You can override any of these defaults by setting the variables shown below.
+
+      set :forever_cmd,      "forever" # e.g. "./node_modules/.bin/forever"
+      set :main_js,          "index.js" # e.g. "./build/main.js"
+      set :node_env,         "production" # the NODE_ENV environment variable used to start the script
+  DESC
+  task  :restart  do
+    transaction do
+      stop
+      start
+    end
+  end
+
+  desc  <<-DESC
+    tail the forever logfile using the forever cmd If the forever cmd cannot \
+    be found then you can override the forever_cmd variable to specify \
+    which one it should use.
+    By default index.js in the applications root folder will be used for startup.
+
+    You can override any of these defaults by setting the variables shown below.
+
+      set :forever_cmd,      "forever" # e.g. "./node_modules/.bin/forever"
+      set :main_js,          "index.js" # e.g. "./build/main.js"
+  DESC
+  task :tail do
+    forever_cmd     = fetch(:forever_cmd, "forever")
+    main_js         = fetch(:main_js, "index.js")
+    app_path        = fetch(:latest_release)
+    if app_path.to_s.empty?
+      raise error_type.new("Cannot detect current release path - make sure you have deployed at least once.")
+    end
+    prefix  = fetch(:use_nave, false) ? "#{fetch(:nave_dir)}/nave.sh use #{fetch(:node_version, 'stable')}" :''
+    resp = capture "cd #{app_path} && #{prefix} #{forever_cmd} logs | grep #{main_js}"
+    #logs = resp.split("\n")[2..-1].map{|l| l.split(" " ).last.gsub(/.\[3[5,9]m/,'')}
+    logs = resp.split("\n").map{|l| l.split(" " ).last.gsub(/.\[3[5,9]m/,'')}
+    run "tail -n10 -f #{logs.join(" ")}"
+  end
+end
+

data/lib/capper/nave.rb

@@ -0,0 +1,34 @@
+after "deploy:setup", "nave:setup"
+
+_cset(:nave_installer_url, "https://raw.github.com/isaacs/nave/master/nave.sh")
+_cset(:use_nave, true)
+_cset(:nave_dir, "~/.nave")
+_cset(:node_version, "stable")
+
+namespace :nave do
+
+  desc <<-DESC
+    Install nave into nave target dir.\
+
+    You can override the defaults by setting the variables shown below.
+
+    set :nave_dir,      "~/.nave" # e.g. "/usr/local/nave"
+  DESC
+
+  task :setup do
+    run("mkdir -p #{fetch(:nave_dir)}")
+    run("curl -s -L #{nave_installer_url} > #{fetch(:nave_dir)}/nave.sh; " +
+        "chmod +x #{fetch(:nave_dir)}/nave.sh",  :shell => "/bin/bash")
+    install
+  end
+
+  desc <<-DESC
+    Installs the specified node version. (default: stable) \
+
+    set :node_version, "stable" # e.g. "0.8.1"
+  DESC
+
+  task :install do
+    run("#{fetch(:nave_dir)}/nave.sh install #{fetch(:node_version)}")
+  end
+end

data/lib/capper/npm.rb

@@ -0,0 +1,23 @@
+after 'deploy:update_code', "npm:install"
+
+namespace :npm do
+  desc <<-DESC
+    Install the current npm environment. \
+    Note it is recommended to check in npm-shrinkwrap.json into version control\
+    and to put node_module into .gitignore to manage dependencies. \
+    See http://blog.nodejs.org/2012/02/27/managing-node-js-dependencies-with-shrinkwrap \
+    If no npm-shrinkwrap.json is found packages are installed from package.json with no guarantee\
+    about the version beeing installed
+    If the npm cmd cannot be found then you can override the npm_cmd variable to specifiy \
+    which one it should use.
+
+    You can override any of these defaults by setting the variables shown below.
+
+      set :npm_cmd,      "npm" # e.g. "/usr/local/bin/npm"
+  DESC
+  task :install, :roles => :app, :except => { :no_release => true } do
+    prefix = fetch(:use_nave, false) ? "#{fetch(:nave_dir)}/nave.sh use #{fetch(:node_version, 'stable')}" : ''
+    run("cd #{latest_release} && #{prefix} #{fetch(:npm_cmd, "npm")} install")
+  end
+end
+

data/lib/capper/rails.rb

@@ -55,6 +55,14 @@ namespace :rails do
     run "cd #{directory} && #{rake} RAILS_ENV=#{rails_env} #{migrate_env} db:migrate"
   end
 
+  namespace :db do
+    desc "create the database running rake db:create"
+    task :create, :roles => :db, :only => { :primary => true } do
+      migrate_env    = fetch(:migrate_env, "")
+      run "cd #{current_path} && #{rake} RAILS_ENV=#{rails_env} #{migrate_env} db:create"
+    end
+  end
+
   namespace :assets do
     desc <<-DESC
       Run the asset precompilation rake task. You can specify the full path \

data/lib/capper/rvm.rb

@@ -9,7 +9,7 @@ require "rvm/capistrano"
 set(:rvm_type, :user)
 set(:rvm_ruby_string, File.read(".rvmrc").gsub(/^rvm( use)? --create (.*)/, '\2').strip)
 
-_cset(:rvm_version, "1.14.5")
+_cset(:rvm_version, "1.17.0")
 set(:rvm_install_type) { rvm_version }
 
 before "deploy:setup", "rvm:install_ruby"

data/lib/capper/templates/thin.sh.erb

@@ -0,0 +1,35 @@
+#!/bin/bash
+export HOME=<%= deploy_to %>
+export RAILS_ENV=<%= rails_env rescue "production" %>
+
+if [[ -e "${HOME}"/.rvm/scripts/rvm ]]; then
+  source "${HOME}"/.rvm/scripts/rvm
+fi
+
+PIDFILE=<%= thin_pidfile %>
+CMD="<%= ruby_exec_prefix %> thin -p <%= thin_port %> -e $RAILS_ENV -d -R config.ru start"
+
+cd <%= current_path %> >/dev/null
+
+sig () {
+  test -s "$PIDFILE" && kill -$1 $(<$PIDFILE)
+}
+
+case $1 in
+start)
+  sig 0 && echo >&2 "Already running" && exit 0
+  $CMD
+  ;;
+stop)
+  sig QUIT && exit 0
+  echo >&2 "Not running"
+  ;;
+kill)
+  sig TERM && exit 0
+  echo >&2 "Not running"
+  ;;
+*)
+  echo >&2 "Usage: $0 <start|stop|kill>"
+  exit 1
+  ;;
+esac

data/lib/capper/templates/unicorn.rb.erb

@@ -26,7 +26,7 @@ pid "<%= unicorn_pidfile %>"
 begin
   require "syslogger"
   logger Syslogger.new("<%= application %>-unicorn", Syslog::LOG_PID, Syslog::LOG_LOCAL1)
-rescue
+rescue LoadError
 end
 
 # these do not seem to support syslog

data/lib/capper/thin.rb

@@ -0,0 +1,58 @@
+# these cannot be overriden
+set(:thin_script) { File.join(bin_path, "thin") }
+set(:thin_pidfile) { File.join(pid_path, "thin.pid") }
+
+_cset(:thin_port, 3000)
+
+after "deploy:update_code", "thin:setup"
+after "deploy:restart", "thin:restart"
+
+monit_config "thin", <<EOF.dedent, :roles => :app
+  check process thin
+  with pidfile "<%= thin_pidfile %>"
+  start program = "<%= thin_script %> start" with timeout 60 seconds
+  stop program = "<%= thin_script %> stop"
+EOF
+
+bluepill_config "thin", <<EOF, :roles => :app
+  app.process("thin") do |process|
+    process.pid_file = "<%= thin_pidfile %>"
+    process.working_dir = "<%= current_path %>"
+
+    process.start_command = "<%= thin_script %> start"
+    process.start_grace_time = 60.seconds
+
+    process.stop_signals = [:quit, 5.seconds, :quit, 30.seconds, :term, 5.seconds, :kill]
+    process.stop_grace_time = 45.seconds
+  end
+EOF
+
+namespace :thin do
+  desc "Generate thin configuration files"
+  task :setup, :roles => :app, :except => { :no_release => true } do
+    upload_template_file("thin.sh",
+                         thin_script,
+                         :mode => "0755")
+  end
+
+  desc "Start thin"
+  task :start, :roles => :app, :except => { :no_release => true } do
+    run "#{thin_script} start"
+  end
+
+  desc "Stop thin"
+  task :stop, :roles => :app, :except => { :no_release => true } do
+    run "#{thin_script} stop"
+  end
+
+  desc "Restart thin with zero downtime"
+  task :restart, :roles => :app, :except => { :no_release => true } do
+    run "#{thin_script} kill"
+    run "#{thin_script} start"
+  end
+
+  desc "Kill thin (this should only be used if all else fails)"
+  task :kill, :roles => :app, :except => { :no_release => true } do
+    run "#{thin_script} kill"
+  end
+end

data/lib/capper/version.rb

@@ -1,3 +1,3 @@
 module Capper
-  VERSION = "1.1.0"
+  VERSION = "1.2.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: capper
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.2.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-08-03 00:00:00.000000000 Z
+date: 2012-12-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: erubis
@@ -114,8 +114,11 @@ files:
 - lib/capper/bundler.rb
 - lib/capper/delayed_job.rb
 - lib/capper/django.rb
+- lib/capper/forever.rb
 - lib/capper/monit.rb
 - lib/capper/multistage.rb
+- lib/capper/nave.rb
+- lib/capper/npm.rb
 - lib/capper/python.rb
 - lib/capper/rails.rb
 - lib/capper/ruby.rb
@@ -125,10 +128,12 @@ files:
 - lib/capper/templates/maintenance.html.erb
 - lib/capper/templates/manage.py.erb
 - lib/capper/templates/rails.console.sh.erb
+- lib/capper/templates/thin.sh.erb
 - lib/capper/templates/unicorn.rb.erb
 - lib/capper/templates/unicorn.sh.erb
 - lib/capper/templates/uwsgi.sh.erb
 - lib/capper/templates/uwsgi.xml.erb
+- lib/capper/thin.rb
 - lib/capper/unicorn.rb
 - lib/capper/utils/bluepill.rb
 - lib/capper/utils/monit.rb