ratchetify 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 4ec4df90fc1d35e8dbc3e926941de1b4ddf40131
+  data.tar.gz: f83dc562279ef6e25fd6096d3b64f6bf24d8b988
+SHA512:
+  metadata.gz: fa70a0efa1a00b16758a182ba0453fc864ae859124f0ce3b41412cb14f3fb2db1e1b7404b74a7277f62eb5e157fad72fca14db48ac2770c00471b514bcd39c5d
+  data.tar.gz: 1c924f17be19a6de26379b7b2014ab8ae890cd78afdd0a9bead9abce262015548fde636dd3c13fe29445cdb82aa25d74ce595be6792ce85205164f5da8d3befa

data/.gitignore

@@ -0,0 +1,20 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+.project
+.settings
+.DS_Store

data/Capfile.example

@@ -0,0 +1,22 @@
+# ratchetify recipes
+require 'ratchetify'
+
+# the application's name
+set :application, 'yourapp'
+set :host, 'www'
+set :domain, 'yourapp.com'
+
+# SSH user/password
+set :user, 'uberspace_user' 
+set :password, 'uberspace_user_password'
+
+role :web, "some_server.uberspace.de" # Your HTTP server, Apache/etc
+role :db,  "some_server.uberspace.de"
+
+set :repo,  "https://github.com/you/yourapp.git"
+set :repo_password, 'your_github_password'
+set :branch, 'master'
+
+set :daemon_port, 76543 # a random port. Make sure no one else uses it
+
+# there are a couple more attributes, but normally you don't need to change them. See lib/ratchetify.rb and lib/ratchetify/base.rb for details.

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in uberspacify.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Michael Kuehl, michael@ratchet.cc
+
+MIT License
+
+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.md

@@ -0,0 +1,48 @@
+# Ratchetify
+
+Ratchetify helps you deploy a Ruby on Rails app on Uberspace (uberspace.de), a really cool shared hosting provider.
+
+All the magic is built into a couple nice Capistrano scripts. Ratchetify will create an environment for your app, run it in standalone mode, monitor it using Daemontools, and configure Apache to reverse-proxy to it. Ratchetify will also retrieve your MySQL password, create a dedicated database for your app and create a `database.yml`.
+
+## Installation
+
+Add this line to your application's `Gemfile`:
+
+```ruby
+gem 'ratchetify', :git => 'https://github.com/ratchetcc/ratchetify.git'
+```
+
+And then execute:
+
+    $ bundle
+    
+This will install ratchetify, Capistrano 2.x and all dependent gems for you.
+
+## How to use ratchetify
+
+There is a sample [capfile](https://github.com/ratchetcc/ratchetify/blob/master/Capfile.example) that shows the most important settings you need to get started. In addition to the
+attributes used in the Capfile, there are more attributes pre-set in lib/ratchetify.rb and lib/ratchetify/base.rb but usually there is no need to change any of these.
+
+This tools is highly opinionated i.e. all the settings, the way how I run the app etc. are THE WAY I LIKE IT. This does not mean it can not be done differently or that it is the best way to do it ...
+
+## Credits
+
+The original gem was created by [Jan Schulz-Hofen](https://github.com/yeah/uberspacify). 
+
+## License
+
+MIT; Copyright (c) 2014 ratchet.cc
+
+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.
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Added some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,2 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"

data/bin/rat

@@ -0,0 +1,3 @@
+#!/usr/bin/env ruby
+require 'capistrano/cli'
+Capistrano::CLI.execute

data/lib/ratchetify/base.rb

@@ -0,0 +1,23 @@
+
+require 'bundler/capistrano'
+
+def abort_red(msg)
+  abort "  * \e[#{1};31mERROR: #{msg}\e[0m"
+end
+
+Capistrano::Configuration.instance.load do
+
+  # required variables
+  _cset(:user)                  { abort_red "Please configure your Uberspace user using 'set :user, <username>'" }
+  _cset(:repository)            { abort_red "Please configure your code repository using 'set :repository, <repo uri>'" }
+  
+  # other variables
+  _cset(:deploy_via)            { :remote_cache }
+  _cset(:branch)                { 'master' }
+  
+  # internal variables, don't mess with them unsless you know what you do !
+  set(:use_sudo)                { false }
+  ssh_options[:forward_agent] = true # use the keys for the person running the cap command to check out the app
+  default_run_options[:pty]   = true # needed for git password prompts
+  
+end

data/lib/ratchetify/domain.rb

@@ -0,0 +1,23 @@
+
+Capistrano::Configuration.instance.load do
+  
+  require 'capistrano'
+  require 'ratchetify/helpers'
+  
+  desc "Tasks to add/remove domains (web only)"
+  namespace :domain do
+    
+    desc "Add a fully qualified domain and wildcard domain if specified"
+    task :add do
+      run "uberspace-add-domain -d #{fetch :host}.#{fetch :domain} -w"
+      run "uberspace-add-domain -d #{fetch :domain} -w" unless (wildcard_domain == false)
+    end
+    
+    desc "Removes a fully qualified domain and wildcard domain if specified"
+    task :remove do
+      run "uberspace-del-domain -d #{fetch :host}.#{fetch :domain} -w"
+      run "uberspace-del-domain -d #{fetch :domain} -w" unless (wildcard_domain == false)
+    end
+        
+  end
+end

data/lib/ratchetify/help.rb

@@ -0,0 +1,74 @@
+module Capistrano
+  class CLI
+    module Help
+
+      def task_list(config, pattern = true) #:nodoc:
+        tool_output = options[:tool]
+
+        if pattern.is_a?(String)
+          tasks = config.task_list(:all).select {|t| t.fully_qualified_name =~ /#{pattern}/}
+        end
+        if tasks.nil? || tasks.length == 0
+          warn "Pattern '#{pattern}' not found. Listing all tasks.\n\n" if !tool_output && !pattern.is_a?(TrueClass)
+          tasks = config.task_list(:all)
+        end
+
+        if tasks.empty?
+          warn "There are no tasks available. Please specify a recipe file to load." unless tool_output
+        else
+          all_tasks_length = tasks.length
+          if options[:verbose].to_i < 1
+            tasks = tasks.reject { |t| t.description.empty? || t.description =~ /^\[internal\]/ }
+          end
+
+          tasks = tasks.sort_by { |task| task.fully_qualified_name }
+
+          longest = tasks.map { |task| task.fully_qualified_name.length }.max
+          max_length = output_columns - longest - LINE_PADDING
+          max_length = MIN_MAX_LEN if max_length < MIN_MAX_LEN
+
+          tasks.each do |task|
+            if tool_output
+              puts "rat #{task.fully_qualified_name}" # monkey patched
+            else
+              puts "rat %-#{longest}s # %s" % [task.fully_qualified_name, task.brief_description(max_length)]  # monkey patched
+            end
+          end
+
+          unless tool_output
+            if all_tasks_length > tasks.length
+              puts
+              puts "Some tasks were not listed, either because they have no description,"
+              puts "or because they are only used internally by other tasks. To see all"
+              puts "tasks, type `#{File.basename($0)} -vT'."
+            end
+
+            puts
+            puts "Extended help may be available for these tasks."
+            puts "Type `#{File.basename($0)} -e taskname' to view it."
+          end
+        end
+      end
+
+      def explain_task(config, name) #:nodoc:
+        task = config.find_task(name)
+        if task.nil?
+          warn "The task `#{name}' does not exist."
+        else
+          puts "-" * HEADER_LEN
+          puts "rat #{name}"  # monkey patched
+          puts "-" * HEADER_LEN
+
+          if task.description.empty?
+            puts "There is no description for this task."
+          else
+            puts format_text(task.description)
+          end
+
+          puts
+        end
+      end
+
+    end
+  end
+end

data/lib/ratchetify/helpers.rb

@@ -0,0 +1,69 @@
+#
+# usefull methods that make life easier
+#
+
+#
+# dirs and other constants
+#
+
+def webroot_dir
+  "/var/www/virtual/#{user}"
+end
+
+def deploy_root
+  "#{webroot_dir}/apps"
+end
+
+def deploy_dir
+  "#{deploy_root}/#{application}"
+end
+
+def conf_dir
+  "/home/#{user}/aconf"
+end 
+
+def daemon_service
+  "run-#{application}"
+end
+
+#
+# file and dir handling
+#
+
+def file_exists?(full_path)
+  'true' ==  capture("if [ -e #{full_path} ]; then echo 'true'; fi").strip
+end
+
+def dir_exists?(full_path)
+  'true' ==  capture("if [ -d #{full_path} ]; then echo 'true'; fi").strip
+end
+
+def create_dir(full_path, owner=nil)
+  run "mkdir #{full_path} -p"
+  if owner
+    run "chown #{owner} #{full_path}"
+  end
+end
+
+def delete_dir(full_path)
+  if dir_exists? full_path
+    run "rm -Rf #{full_path}"
+  end
+end
+
+def delete_file(full_path)
+  if file_exists? full_path 
+    run "rm #{full_path}"
+  end
+end
+
+#
+# working with git
+#
+def branch?(full_path)
+  capture("cd #{full_path} && git branch | grep '*'")
+end
+
+def on_branch?(full_path, branch)
+  branch?(full_path).include? branch
+end

data/lib/ratchetify/rails.rb

@@ -0,0 +1,127 @@
+
+Capistrano::Configuration.instance.load do
+  
+  require 'capistrano'
+  require 'ratchetify/helpers'
+  require 'ratchetify/setup'
+  require 'ratchetify/domain'
+  require 'ratchetify/service'
+  
+  before "create:rails", "setup:environment"
+  after "create:rails", "service:create"
+  after "create:rails", "domain:add"
+  
+  desc "Deploy an app for the first time"
+  namespace :create do
+    
+    desc "Deploy an RAILS app to uberspace"
+    task :rails do
+      create_repo
+      create_and_configure_database
+      create_reverse_proxy
+      config_rails_app
+      finalize
+    end
+    
+    task :create_repo do
+      # clone the repo first
+      git_cmd = "cd #{deploy_root} && git clone #{fetch :repo} #{fetch :application}"
+      
+      run git_cmd do |channel, stream, out|
+        if out =~ /Password:/
+          channel.send_data("#{fetch :repo_password}\n")
+        else
+          puts out
+        end
+      end
+      
+      # switch to the specified branch
+      run "cd #{deploy_dir} && git checkout -b #{fetch :branch}" unless on_branch? deploy_dir, "#{fetch :branch}"
+      
+    end # task :create_repo
+    
+    task :create_and_configure_database do
+      
+      # extract user & password
+      my_cnf = capture('cat ~/.my.cnf')
+      
+      my_cnf.match(/^user=(\w+)/)
+      mysql_user = $1
+      my_cnf.match(/^password=(\w+)/)
+      mysql_pwd = $1
+      
+      # create the database
+      mysql_database = "#{user}_#{application}" # 'application' MUST NOT contain any '-' !!!
+      run "mysql -e 'CREATE DATABASE IF NOT EXISTS #{mysql_database} CHARACTER SET utf8 COLLATE utf8_general_ci;'"
+      
+      # create the database.yml file
+      database_yml = <<-EOF
+production:
+  adapter: mysql2
+  encoding: utf8
+  database: #{mysql_database}
+  pool: 15
+  username: #{mysql_user}
+  password: #{mysql_pwd}
+  host: localhost
+  socket: /var/lib/mysql/mysql.sock
+  timeout: 10000
+
+EOF
+      # upload the database.yml file
+      put database_yml, "#{deploy_dir}/config/database.yml"
+      
+    end # task :create_and_configure_database
+    
+    task :create_reverse_proxy do
+      
+      # .htaccess      
+      htaccess = <<-EOF
+RewriteEngine On
+RewriteBase /
+RewriteCond %{REQUEST_FILENAME} !-f
+RewriteRule ^(.*)$ http://localhost:#{daemon_port}/$1 [P]
+EOF
+
+      # place the .htaccess file
+      put htaccess, "#{deploy_dir}/.htaccess"
+      run "chmod +r #{deploy_dir}/.htaccess"
+      
+    end # task :create_reverse_proxy
+    
+    task :config_rails_app do
+      # run bundle install first
+      run "cd #{deploy_dir} && bundle install --path ~/.gem"
+
+      # application.yml should normally be on the .gitignore list, however you application might need 
+      # a basic configuration file to e.g. load seed data. Provide such a basic file as 'application.example.yml'
+      # and it will be used to configure the app initially.
+      
+      # create a default application.yml file if non was provided
+      if not file_exists? "#{deploy_dir}/config/application.yml"
+        if file_exists? "#{deploy_dir}/config/application.example.yml"
+          run "cd #{deploy_dir}/config && cp application.example.yml application.yml"
+        end
+      end
+      
+      # run rake db:migrate to create all tables etc
+      run "cd #{deploy_dir} && bundle exec rake db:migrate RAILS_ENV=#{fetch :environment}"
+      
+      # run rake db:seed to load seed data
+      run "cd #{deploy_dir} && bundle exec rake db:seed RAILS_ENV=#{fetch :environment}"
+      
+      # compile assets from the asset pipeline
+      run "cd #{deploy_dir} && bundle exec rake assets:precompile RAILS_ENV=#{fetch :environment}"
+      
+      # create symbolic links so that apache will find the assets
+      run "cd #{deploy_dir} && ln -s public/assets assets"
+    end
+    
+    task :finalize do
+      # create symbolic links..
+      run "cd #{webroot_dir} && ln -s #{deploy_dir} #{fetch :host}.#{fetch :domain}"
+      run "cd #{webroot_dir} && ln -s #{deploy_dir} #{fetch :domain}" unless (wildcard_domain == false)
+    end
+    
+  end # namespace
+end

data/lib/ratchetify/ruby.rb

@@ -0,0 +1,30 @@
+
+Capistrano::Configuration.instance.load do
+  
+  desc "Setup ruby interpreter and tools"
+  namespace :setup do
+    desc "Setup ruby interpreter and tools"
+    task :ruby do
+      
+      # script to setup ruby
+      ruby_script = <<-EOF
+
+# ruby #{ruby_version} environment
+export PATH=/package/host/localhost/ruby-#{ruby_version}/bin:$PATH
+export PATH=$HOME/.gem/ruby/#{ruby_version}/bin:$PATH
+EOF
+
+      # setup the ruby environment
+      put ruby_script, "/home/#{user}/ruby_scrip"
+      run "cat /home/#{user}/ruby_scrip >> /home/#{user}/.bashrc"
+      
+      # configure ruby
+      run "echo 'gem: --user-install --no-rdoc --no-ri' > ~/.gemrc"
+      run "gem install bundler"
+      
+      # cleanup
+      run "rm /home/#{user}/ruby_scrip"
+      
+    end # task :ruby
+  end
+end

data/lib/ratchetify/service.rb

@@ -0,0 +1,118 @@
+
+Capistrano::Configuration.instance.load do
+  
+  require 'capistrano'
+  require 'ratchetify/helpers'
+  
+  desc "Tasks to start/stop/restart the app server"
+  namespace :service do
+    desc "Start the app server"
+    task :start do
+      run "svc -u ~/service/#{daemon_service}"
+    end
+    
+    desc "Stop the app server"
+    task :stop do
+      run "svc -d ~/service/#{daemon_service}"
+    end
+    
+    desc "Restart the app server"
+    task :restart do
+      run "svc -du ~/service/#{daemon_service}"
+    end
+
+    task :create do
+      create_service_thin # the only option for now
+      
+      # register the service
+      run "uberspace-setup-service #{daemon_service} ~/bin/#{daemon_service}"
+      
+    end # task :create_service
+
+    task :create_service_thin do
+      # script to start thin
+      script = <<-EOF
+#!/bin/bash
+export HOME=/home/#{user}
+source $HOME/.bash_profile
+cd #{deploy_dir}
+exec /home/#{user}/.gem/ruby/#{ruby_version}/bin/bundle exec thin start -p #{daemon_port} -e production 2>&1
+EOF
+      
+      # upload the run script
+      put script, "/home/#{user}/bin/#{daemon_service}"
+      run "chmod 755 /home/#{user}/bin/#{daemon_service}"
+      
+    end # task :create_service_thin
+    
+    task :create_service_unicorn do
+      # script to start unicorn
+      script = <<-EOF
+#!/bin/bash
+export HOME=/home/#{user}
+source $HOME/.bash_profile
+cd #{deploy_dir}
+exec /home/#{user}/.gem/ruby/#{ruby_version}/bin/bundle exec unicorn -p #{daemon_port} -c ./config/unicorn.rb -E #{environment} 2>&1
+EOF
+      
+      # upload the run script
+      put script, "/home/#{user}/bin/#{daemon_service}"
+      run "chmod 755 /home/#{user}/bin/#{daemon_service}"
+      
+      # script to configure unicorn
+      unicorn_rb = <<-EOF
+# config/unicorn.rb
+worker_processes 3
+timeout 15
+preload_app true
+
+before_fork do |server, worker|
+  Signal.trap 'TERM' do
+    puts 'Unicorn master intercepting TERM and sending myself QUIT instead'
+    Process.kill 'QUIT', Process.pid
+  end
+
+  defined?(ActiveRecord::Base) and
+    ActiveRecord::Base.connection.disconnect!
+end
+
+after_fork do |server, worker|
+  Signal.trap 'TERM' do
+    puts 'Unicorn worker intercepting TERM and doing nothing. Wait for master to send QUIT'
+  end
+
+  defined?(ActiveRecord::Base) and
+    ActiveRecord::Base.establish_connection
+end      
+EOF
+  
+      # upload the unicorn config file, if it does not exist
+      put unicorn_rb, "#{deploy_dir}/config/unicorn.rb" unless file_exists? "#{deploy_dir}/config/unicorn.rb"
+      
+    end # task :create_service_unicorn
+    
+    desc "Remove the service"
+    task :remove do
+      script = <<-EOF
+cd ~/service/#{daemon_service}
+rm ~/service/#{daemon_service}
+svc -dx . log
+rm -rf ~/etc/run-#{daemon_service}
+EOF
+
+      unless not file_exists? "~/etc/run-#{daemon_service}"
+        # upload script
+        put script, "/home/#{user}/rm-#{daemon_service}"
+        run "chmod 755 /home/#{user}/rm-#{daemon_service}"
+
+        # remove the service
+        run ". ~/rm-#{daemon_service}"
+
+        # cleanup
+        run "rm /home/#{user}/rm-#{daemon_service}"
+      end
+      
+    end # task :remove
+    
+  end
+end

data/lib/ratchetify/setup.rb

@@ -0,0 +1,61 @@
+
+Capistrano::Configuration.instance.load do
+  
+  require 'capistrano'
+  require 'ratchetify/helpers'
+  require 'ratchetify/ruby'
+  
+  desc "Prepare a new uberspace for deployment"
+  namespace :setup do
+    
+    desc "Prepare an uberspace for deployment"
+    task :default do
+      environment
+    end
+    
+    desc "Create dirs, configure ruby, activate daemontools, ..."
+    task :environment do
+      
+      unless file_exists? '.ratchet'
+      
+        puts "Initializing uberspace '#{user}'"
+        
+        # save the current .bashrc
+        run "cp .bashrc bashrc.bak"
+        
+        # create the necessary folders
+        create_dir deploy_root unless dir_exists? deploy_root
+        create_dir conf_dir unless dir_exists? conf_dir
+        run "ln -s #{deploy_root} apps"
+        
+        # dummy main
+        create_dir "#{deploy_root}/main"
+        
+        # remove default html and symbolic link
+        run "rm -rf #{webroot_dir}/html"
+        run "rm -rf /home/#{user}/html"
+        
+        # enable ruby
+        ruby
+        # activate the daemontools
+        run "uberspace-setup-svscan" unless dir_exists? 'service'
+        
+        # done
+        run "touch .ratchet"
+      end  
+    end # task :environment
+    
+    desc "Cleans the uberspace, removes (most) changes, restores the uberspace as much as possible"
+    task :restore do
+      run "mv bashrc.bak .bashrc"
+      run "rm -rf .gem .gemrc .ratchet"
+      
+      # restore old html folder etc
+      create_dir "#{webroot_dir}/html"
+      run "ln -s #{webroot_dir}/html html/"
+      
+      # keep ./apps and ./aconf for now ...
+    end # task :clean
+    
+  end # namespace
+end

data/lib/ratchetify/undeploy.rb

@@ -0,0 +1,31 @@
+
+Capistrano::Configuration.instance.load do
+  
+  require 'capistrano'
+  require 'ratchetify/helpers'
+  require 'ratchetify/service'
+  
+  before "undeploy", "service:remove"
+  
+  desc "Undeploy an app from uberspace"
+  namespace :undeploy do
+    
+    desc "Undeploy an app from uberspace"
+    task :default do
+      drop_database
+      remove_repo
+    end
+    
+    task :drop_database do
+      mysql_database = "#{user}_#{application}" # 'application' MUST NOT contain any '-' !!!
+      run "mysql -e 'DROP DATABASE IF EXISTS #{mysql_database};'"
+    end
+    
+    task :remove_repo do
+      run "cd #{deploy_root} && rm -rf #{fetch :application}"
+      run "cd #{webroot_dir} && rm -rf #{fetch :host}.#{fetch :domain}"
+      run "cd #{webroot_dir} && rm -rf #{fetch :domain}" unless (wildcard_domain == false)
+    end
+    
+  end # namespace
+end

data/lib/ratchetify/update.rb

@@ -0,0 +1,46 @@
+
+Capistrano::Configuration.instance.load do
+  
+  require 'capistrano'
+  require 'ratchetify/helpers'
+  require 'ratchetify/service'
+  
+  before :update, "service:stop"
+  after :update, "service:start"
+  
+  desc "Tasks to update an app"
+  namespace :update do
+    
+    desc "Stop the service, update the app then restart"
+    task :default do
+      # switch to the specified branch
+      run "cd #{deploy_dir} && git checkout -b #{fetch :branch}" unless on_branch? deploy_dir, "#{fetch :branch}"
+      
+      # update the repo
+      git_cmd = "cd #{deploy_dir} && git pull origin #{fetch :branch}"
+      
+      run git_cmd do |channel, stream, out|
+        if out =~ /Password:/
+          channel.send_data("#{fetch :repo_password}\n")
+        else
+          puts out
+        end
+      end
+      
+      #
+      # typical RAILS stuff to finalize
+      #
+      
+      # run bundle install first
+      run "cd #{deploy_dir} && bundle install --path ~/.gem"
+      
+      # run rake db:migrate to create all tables etc
+      run "cd #{deploy_dir} && bundle exec rake db:migrate RAILS_ENV=#{fetch :environment}"
+      
+      # compile assets from the asset pipeline
+      run "cd #{deploy_dir} && bundle exec rake assets:precompile RAILS_ENV=#{fetch :environment}"
+      
+    end # end task :default
+    
+  end
+end

data/lib/ratchetify/version.rb

@@ -0,0 +1,3 @@
+module Ratchetify
+  VERSION = "1.0.0"
+end

data/lib/ratchetify/wordpress.rb

@@ -0,0 +1,79 @@
+
+Capistrano::Configuration.instance.load do
+  
+  require 'capistrano'
+  require 'ratchetify/helpers'
+  require 'ratchetify/setup'
+  require 'ratchetify/domain'
+  
+  before "create:wordpress", "setup:environment"
+  after "create:wordpress", "domain:add"
+  
+  desc "Deploy an app for the first time"
+  namespace :create do
+    
+    desc "Deploy an wordpress blog to uberspace"
+    task :wordpress do
+      create_web_dir
+      create_database
+      finalize
+    end
+    
+    
+    task :create_web_dir do
+      # download the worpress .tar
+      unless dir_exists? deploy_dir
+        # download wp and unpack it
+        run "cd #{webroot_dir} && curl -O https://s3-eu-west-1.amazonaws.com/ratchetp/wordpress-3.8.1.tar.gz"
+        #run "cd #{deploy_root} && mkdir wp_tmp"
+        run "cd #{webroot_dir} && tar xfz wordpress* -C #{deploy_root}"
+        run "cd #{deploy_root} && mv wordpress #{application}"
+        
+        # cleanup
+        #run "cd #{deploy_root} && rm wordpress*"
+        run "cd #{webroot_dir} && rm -rf wordpress*"
+        
+        # rename word press to -> :application
+        #run "cd #{deploy_root} && mv ./wordpress #{application}"
+      end
+      
+    end # task :create_dir
+    
+    task :create_database do
+      
+      # extract user & password
+      my_cnf = capture('cat ~/.my.cnf')
+      
+      my_cnf.match(/^user=(\w+)/)
+      mysql_user = $1
+      my_cnf.match(/^password=(\w+)/)
+      mysql_pwd = $1
+      my_cnf.match(/^port=(\w+)/)
+      mysql_port = $1
+      
+      # create the database
+      mysql_database = "#{user}_#{application}" # 'application' MUST NOT contain any '-' !!!
+      run "mysql -e 'CREATE DATABASE IF NOT EXISTS #{mysql_database} CHARACTER SET utf8 COLLATE utf8_general_ci;'"
+      
+      database_yml = <<-EOF
+database: #{mysql_database}
+username: #{mysql_user}
+password: #{mysql_pwd}
+host: localhost
+port: #{mysql_port}
+
+EOF
+
+      # upload the database.yml file
+      put database_yml, "#{deploy_dir}/database.yml"
+      
+    end # task :create_database
+    
+    task :finalize do
+      # create symbolic links..
+      run "cd #{webroot_dir} && ln -s #{deploy_dir} #{fetch :host}.#{fetch :domain}"
+      run "cd #{webroot_dir} && ln -s #{deploy_dir} #{fetch :domain}" unless (wildcard_domain == false)
+    end # task :finalize
+    
+  end # namespace
+end

data/lib/ratchetify.rb

@@ -0,0 +1,31 @@
+require 'ratchetify/version'
+
+Capistrano::Configuration.instance.load do
+  
+  require 'capistrano'
+  require 'ratchetify/helpers'
+  require 'ratchetify/setup'
+  require 'ratchetify/ruby'
+  require 'ratchetify/service'
+  require 'ratchetify/undeploy'
+  require 'ratchetify/domain'
+  require 'ratchetify/rails'
+  require 'ratchetify/wordpress'
+  require 'ratchetify/update'
+  require 'ratchetify/help' # monkey patched from capistrano
+  
+  # host and domain for the new app
+  set :domain, nil
+  set :host, nil
+  set :wildcard_domain, false
+  
+  # random port used for the reverse proxy
+  set :daemon_port, rand(61000-32768+1)+32768  # random port
+  set :type, :rails # supported types are: :rails, :wordpress, 
+  
+  # internal variables, should not be changed in the cap file
+  set :ruby_version, "2.0.0"
+  set :environment, 'production'
+  set :is_main,  false
+  
+end

data/ratchetify.gemspec

@@ -0,0 +1,25 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/ratchetify/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["Michael Kuehl"]
+  gem.license       = 'MIT'
+  gem.email         = ["michael@ratchet.cc"]
+  gem.description   = %q{Deploy Rails apps on Uberspace}
+  gem.summary       = %q{Ratchetify helps you deploy a Ruby on Rails app on uberspace.de, a popular German shared hosting provider.}
+  gem.homepage      = "https://github.com/ratchetcc/ratchetify"
+
+  gem.files         = `git ls-files`.split($\)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.name          = "ratchetify"
+  gem.require_paths = ["lib"]
+  gem.version       = Ratchetify::VERSION
+  
+  # dependencies for capistrano
+  gem.add_dependency 'capistrano',        '2.12.0'
+  
+  # dependency for mysql on Uberspace
+  gem.add_dependency 'mysql2',            '>=0.3.11'
+  
+end

metadata

@@ -0,0 +1,95 @@
+--- !ruby/object:Gem::Specification
+name: ratchetify
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Michael Kuehl
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-04-11 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: capistrano
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 2.12.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 2.12.0
+- !ruby/object:Gem::Dependency
+  name: mysql2
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.3.11
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.3.11
+description: Deploy Rails apps on Uberspace
+email:
+- michael@ratchet.cc
+executables:
+- rat
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Capfile.example
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- bin/rat
+- lib/ratchetify.rb
+- lib/ratchetify/base.rb
+- lib/ratchetify/domain.rb
+- lib/ratchetify/help.rb
+- lib/ratchetify/helpers.rb
+- lib/ratchetify/rails.rb
+- lib/ratchetify/ruby.rb
+- lib/ratchetify/service.rb
+- lib/ratchetify/setup.rb
+- lib/ratchetify/undeploy.rb
+- lib/ratchetify/update.rb
+- lib/ratchetify/version.rb
+- lib/ratchetify/wordpress.rb
+- ratchetify.gemspec
+homepage: https://github.com/ratchetcc/ratchetify
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Ratchetify helps you deploy a Ruby on Rails app on uberspace.de, a popular
+  German shared hosting provider.
+test_files: []