capistrano-chocopoche 0.0.2 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-!binary "U0hBMQ==":
-  metadata.gz: 1bd1489c00876b7c9ab12807d47716466f3040c6
-  data.tar.gz: cfd8a4a6c773f096d2e8e32ab4aba5e3703dbcb6
-!binary "U0hBNTEy":
-  metadata.gz: fc676969d37f7523d4ed8b775bd4fb4700a23dfe0409e35456f0ae8eb16b8af022d5b43b5f2762c3689cff4770eeb95bacfd0028da89a2b682aad4522f4131fa
-  data.tar.gz: 9d643175726549773759b31b9c259c42f5ffb7af7594031552a172664e6fee202f049e38f58c1df7ef9c72f18a3d040f4e18ed8e0248f2317f1ef0a37d1b5c97
+SHA1:
+  metadata.gz: 26cfccb5e750bc7083dfdd42dfc6320d40622ef9
+  data.tar.gz: b56877aa569af52f82ee19958ee0502bb3e78abe
+SHA512:
+  metadata.gz: bda1db522b9277ea660c14953985a1783c79f7b8551ab2659c7975466e43f9724eb46042beee6ddd06779b8957b6770d688f55d10b7013deccd11e5541b948b2
+  data.tar.gz: db3d2a905b958f5def5288136a99faf175dcfb80a423335709aa8c93243934ceb1fc3ec0e9000642731951d1be65a31ed126bf0ea07b4cea25ad5e6fd51530db

data/Gemfile

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

data/README.md

@@ -2,145 +2,178 @@
 
 My capistrano poche contains:
 
-- another railsless-deploy recipe
-- a files utility to rsync directories
+- a php composer recipe
+- a files utility to rsync directories up and down
+- a mysql utility to dump/import, download/upload databases
+- a bin to help synchronizing multiple stage together: `csync`
+- and a railsless-deploy recipe (which uses the default rails recipes -
+  it may not be a good idea to reimplement...)
 
 ## Installation
 
     $ gem install capistrano-chocopoche
 
-## Capfile example
+## Tasks
+
+```shell
+cap composer                          # Runs an arbitrary composer command
+cap composer:update                   # Runs the composer update command
+cap connect                           # Connects via SSH to the first app server, and executes a `bash --login` to stay connected
+cap deploy                            # Deploys your project.
+cap deploy:check                      # Test deployment dependencies.
+cap deploy:cleanup                    # Clean up old releases.
+cap deploy:create_symlink             # Updates the symlink to the most recently deployed version.
+cap deploy:pending                    # Displays the commits since your last deploy.
+cap deploy:pending:diff               # Displays the `diff' since your last deploy.
+cap deploy:restart                    # Blank task exists as a hook into which to install your own environment specific behaviour.
+cap deploy:rollback                   # Rolls back to a previous version and restarts.
+cap deploy:rollback:code              # Rolls back to the previously deployed version.
+cap deploy:setup                      # Prepares one or more servers for deployment.
+cap deploy:start                      # Blank task exists as a hook into which to install your own environment specific behaviour.
+cap deploy:stop                       # Blank task exists as a hook into which to install your own environment specific behaviour.
+cap deploy:symlink                    # Deprecated API.
+cap deploy:update                     # Copies your project and updates the symlink.
+cap deploy:update_code                # Copies your project to the remote servers.
+cap deploy:upload                     # Copy files to the currently deployed version.
+cap files:create_symlinks             # Creates :files_symlinks from the shared folder to the current one on the app servers.
+cap files:download                    # Sync files from the first web server to the local temp directory.
+cap files:upload                      # Sync files from the local temp directory to the first web server.
+cap files:upload_files_from_templates # Creates files from templates and upload them to the app server.
+cap invoke                            # Invoke a single command on the remote servers.
+cap mysql:download                    # Download last remote dumps of each databases.
+cap mysql:dump                        # Dump databases to remote backup folder.
+cap mysql:import                      # Import last remote dumps to databases.
+cap mysql:upload                      # Upload last local dump of each databases.
+cap shell                             # Begin an interactive Capistrano session.
+```
+
+## Capfile example with multistage
+
+The [short_url](https://github.com/chocopoche/short_url) project uses that
+library, it's a good working example. See the `Capfile` and stages config under
+`config/deploy`.
+
+The Capfile:
 
 ```ruby
 # Capistrao defaults
 load 'deploy'
 
-# Multistage - to be loaded before the railsless-deploy
 require 'capistrano/ext/multistage'
-
-# Rails inhibition
-require 'capistrano-chocopoche/railsless-deploy'
-
-# Rsync tasks
-require 'capistrano-chocopoche/files'
+require 'capistrano/chocopoche'
 
 # Base configuration
 set :application,   "my-project"
-set :repository,    "git@localhost:#{application}.git"
+set :repository,    "git@example.com:my-project.git"
 set :use_sudo,      false
 ssh_options[:forward_agent] = true
 
-# Rsync + symlinks configuration
-set :files_directories,         [ 'public/upload' ]
-set :files_symlinks,            [ 'public/upload' ]
-
-# # Server config, won't be here in case of multistage
-# server 'localhost', :app, :web, :db, :primary => true
-
-# # default settings
-# set :files_tmp_dir,           'tmp/capistrano-chocopoche/files'
-# set :deploy_to,               '/home/#{user}/apps/#{application}[.#{stage}]'
+# Folders to rsync with files:download
+set :files_rsync,    files_rsync    + %w(web/qr)
+
+# Symlinks to create after deploy:update_code
+set :files_symlinks, files_symlinks + %w(web/qr)
+
+# # Won't work with the cli command `csync` because the default stage task
+# # will be invoked, but it should not
+# set :default_stage,  'vm'
+
+# Files to be generated on setup
+set :files_tpl, [
+  {
+    :template => "config/deploy/templates/nginx.conf.erb",
+    :dest     => "config/nginx.conf"
+  },
+  {
+    :template => "config/deploy/templates/parameters.yml.erb",
+    :dest     => "config/parameters.yml"
+  }
+]
 ```
 
-## Railsless-deploy
-
-This script requires the default capistrano tasks to be loaded, then it will:
-
-- delete rails tasks: `migrate`, `migrations`, `cold`
-- empty rails tasks (but keep it for hooks): `finalize_update`
-- delete rails vars: `rails_env`
-- empty rails vars: `shared_children`
-- override the `deploy_to` var to:
-
-  - `/home/#{user}/apps/#{application}.#{stage}`
-  - or `/home/#{user}/apps/#{application}` if the multistage ext is not
-    loaded.
-
-  Therefore the multistage ext must be required before the railsless-deploy.
-
-- override symlinks related tasks to use relative paths: `create_symlink`,
-  `rollback:revision`
-
-Also the last one implements the atomic symlink as suggested in
-[issue #346](https://github.com/capistrano/capistrano/issues/346).
-
-## Files
-
-The `download` and `upload` tasks use a temporary directory as pivot, so you are
-able to sync from a stage to another.
-
-The following scenario assumes that all commands are launched from the dev stage,
-that you have 3 environements and that `:files_directories` and `:files_symlinks`
-are set as in the example:
-
-- dev: may only contains the cap recipe
-- staging: a stage without files and symlinks
-- prod: a stage with files and symlinks. Prod looks like:
-
-        my-project.prod/
-        ├── current/
-        │   └── public/
-        │       └── upload/         => symlink to my-project/shared/public/upload/
-        └── shared/
-            └── public/
-                └── upload/         => git ignores that folder
-                    ├── file1.png
-                    ├── file2.png
-                    ...
-
-### Download
-
-Download `prod:my-project/shared/public/upload` to `dev:my-project/tmp/capistrano-chocopoche/files/public/upload`:
-
-    $ cap prod files:download
-
-    Gives:
-
-    my-project.dev/
-    ├── current/
-    ├── shared/
-    └── tmp/
-        └── capistrano-chocopoche/
-            └── files/
-                └── public/
-                    └── upload/
-                        ├── file1.png
-                        ├── file2.png
-                        ...
+A stage file in `config/deploy/[stage].rb:
+```
+server 'example.com', :app, :web, :db, :primary => true
+
+def set_files_tpl_params
+  set :files_tpl_params, {
+    :server   => {
+      :hostname => "#{stage}.example.com"
+    },
+    :database => {
+      :driver   => "pdo_mysql",
+      :dbname   => "dbname",
+      :user     => "user",
+      :password => "password",
+      :host     => "localhost"
+    },
+  }
+end
+```
 
-### Upload
+## Capfile example without multistage
 
-Upload `dev:my-project/tmp/capistrano-chocopoche/files/public/upload` to `staging:my-project/shared/public/upload`:
+```ruby
+# Capistrao defaults
+load 'deploy'
 
-    $cap staging files:upload
+require 'capistrano/chocopoche'
 
-    Gives:
+# Base configuration
+set :application,   "my-project"
+set :repository,    "git@example.com:my-project.git"
+set :use_sudo,      false
+ssh_options[:forward_agent] = true
 
-    my-project.staging/
-    ├── current/
-    └── shared/
-        └── public/
-            └── upload/
-                ├── file1.png
-                ├── file2.png
-                ...
+# Folders to rsync with files:download
+set :files_rsync,    files_rsync    + %w(web/qr)
+
+# Symlinks to create after deploy:update_code
+set :files_symlinks, files_symlinks + %w(web/qr)
+
+# Files to be generated on setup
+set :files_tpl, [
+  {
+    :template => "config/deploy/templates/nginx.conf.erb",
+    :dest     => "config/nginx.conf"
+  },
+  {
+    :template => "config/deploy/templates/parameters.yml.erb",
+    :dest     => "config/parameters.yml"
+  }
+]
+
+server 'localhost', :app, :web, :db, :primary => true
+
+def set_files_tpl_params
+  set :files_tpl_params, {
+    :server   => {
+      :hostname => "#{stage}.example.com"
+    },
+    :database => {
+      :driver   => "pdo_mysql",
+      :dbname   => "dbname",
+      :user     => "user",
+      :password => "password",
+      :host     => "localhost"
+    },
+  }
+end
+```
 
-### Symlink
+## csync
 
-Create a symlink from `staging:my-project/shared/public/upload/` to `staging:my-project/current/public/upload/`:
+The csync will chain capistrano commands in order to synchronise two stages.
+Example:
 
-    $ cap staging files:create_symlinks
+    $ csync mysql prod dev
 
-    Gives:
+will dump and download databases from *prod*, then upload and import them to
+*dev*.
 
-    my-project.staging/
-    ├── current/
-    │   └── public/
-    │       └── upload/         => symlink to my-project/shared/public/upload/
-    └── shared/
-        └── public/
-            └── upload/         => git ignores that folder
+    $ csync files prod dev
 
+will rsync files from *prod* to *dev*.
 
 ## License
 

data/bin/csync

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+require 'capistrano/chocopoche/sync-cli'
+
+cli = Capistrano::Chocopoche::SyncCLI.new(ARGV)
+cli.execute

data/capistrano-chocopoche.gemspec

@@ -1,19 +1,25 @@
 # coding: utf-8
 lib = File.expand_path('../lib', __FILE__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'capistrano/chocopoche/version'
 
 Gem::Specification.new do |spec|
   spec.name          = "capistrano-chocopoche"
-  spec.version       = "0.0.2"
+  spec.version       = Capistrano::Chocopoche::VERSION
   spec.authors       = ["Corentin Merot"]
   spec.email         = ["cmerot@themarqueeblink.com"]
-  spec.description   = %q{Capistrano recipes, with another railsless-deploy and a files utility.}
+  spec.description   = %q{Capistrano recipes and bin for mysql, rsync, php composer.}
   spec.summary       = %q{Chocopoche's Capistrano recipes}
   spec.homepage      = "https://github.com/chocopoche/capistrano-chocopoche"
   spec.license       = "MIT"
+
   spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
   spec.require_paths = ["lib"]
 
+  spec.add_runtime_dependency "capistrano", "~> 2.14"
+
   spec.add_development_dependency "bundler", "~> 1.3"
 end
 

data/lib/capistrano/chocopoche.rb

@@ -0,0 +1,5 @@
+require "capistrano/chocopoche/version"
+require 'capistrano/chocopoche/railsless-deploy'
+require 'capistrano/chocopoche/files'
+require 'capistrano/chocopoche/mysql'
+require 'capistrano/chocopoche/composer'

data/lib/capistrano/chocopoche/common.rb

@@ -0,0 +1,36 @@
+configuration = Capistrano::Configuration.respond_to?(:instance) ?
+  Capistrano::Configuration.instance(:must_exist) :
+  Capistrano.configuration(:must_exist)
+
+
+configuration.load do
+
+  _cset :user, Etc.getlogin
+
+  # Used to create relative symlinks in deploy.create_symlink
+  def relative_path(from_str, to_str)
+    require 'pathname'
+    Pathname.new(to_str).relative_path_from(Pathname.new(from_str)).to_s
+  end
+
+  # https://github.com/everzet/capifony/blob/c32d2ae118584d37e9051b6eeda0674ea420f824/lib/capifony.rb
+  def prompt_with_default(var, default, &block)
+    set(var) do
+      Capistrano::CLI.ui.ask("#{var} [#{default}] : ", &block)
+    end
+    set var, default if eval("#{var.to_s}.empty?")
+  end
+
+  desc <<-DESC
+    Connects via SSH to the first app server, and executes a `bash --login` \
+    to stay connected
+  DESC
+  task :connect, :roles => :app, :primary => true do
+    set :host, roles[:app].servers.first.host
+    set :port, ssh_options[:port] || roles[:web].servers.first.port || 22
+    set :user, Etc.getlogin unless exists?(:user)
+
+    cmd = "ssh -A #{user}@#{host} -p #{port} -t \"cd #{current_path};bash --login\""
+    exec(cmd)
+  end
+end

data/lib/capistrano/chocopoche/composer.rb

@@ -0,0 +1,36 @@
+require 'capistrano/chocopoche/files'
+
+configuration = Capistrano::Configuration.respond_to?(:instance) ?
+  Capistrano::Configuration.instance(:must_exist) :
+  Capistrano.configuration(:must_exist)
+
+
+configuration.load do
+
+  set :shared_children, shared_children + %w(vendor)
+  set :files_symlinks,  files_symlinks  + %w(vendor)
+
+  _cset :composer_cli_options, '--dev --quiet'
+
+  namespace :composer do
+
+    desc "Runs an arbitrary composer command"
+    task :default, :roles => :app do
+      prompt_with_default(:composer_task, "update")
+      run "cd #{latest_release} && php composer.phar #{composer_cli_options} " + composer_task
+    end
+
+    desc "Runs the composer update command"
+    task :update, :roles => :app do
+      install_composer
+      run "cd #{latest_release} && php composer.phar #{composer_cli_options} update"
+    end
+
+    desc "[internal] Installs composer"
+    task :install_composer, :roles => :app do
+      run "curl -s http://getcomposer.org/installer | php -- --install-dir=#{current_release}"
+    end
+  end
+
+  # before 'deploy:finalize_update', 'composer:update'
+end

data/lib/capistrano/chocopoche/files.rb

@@ -0,0 +1,102 @@
+# see https://gist.github.com/111597
+require 'etc'
+require 'fileutils'
+require 'capistrano/chocopoche/common'
+
+configuration = Capistrano::Configuration.respond_to?(:instance) ?
+  Capistrano::Configuration.instance(:must_exist) :
+  Capistrano.configuration(:must_exist)
+
+configuration.load do
+
+  _cset :user,             Etc.getlogin
+  _cset :files_rsync,      []
+  _cset :files_symlinks,   []
+  _cset :files_tmp_dir,    'tmp/capistrano-chocopoche/files'
+  _cset :files_tpl,        []
+  _cset :files_tpl_params, {}
+
+  namespace :files do
+
+    task :set_tpl_symlinks do
+      files_tpl.each do |t|
+        set :files_symlinks, files_symlinks + [t[:dest]]
+      end
+    end
+
+    desc "Creates files from templates and upload them to the app server."
+    task :upload_files_from_templates, :roles => :app do
+
+      server 'localhost', :app, :web, :db, :primary => true
+
+      set_files_tpl_params
+
+      files_tpl.each do |t|
+        params = fetch(:files_tpl_params)
+        template  = File.read(t[:template])
+        buffer    = ERB.new(template).result(binding)
+        parent = File.dirname("#{shared_path}/#{t[:dest]}")
+        run "mkdir -p #{parent}"
+        put buffer, "#{shared_path}/#{t[:dest]}", :mode => 0664
+      end
+    end
+
+    desc <<-DESC
+      Sync files from the first web server to the local temp directory. \
+      Files on the remote server must be somewhere in the shared directory.
+    DESC
+    task :download, :roles => :web, :only => { :primary => true }, :once => true do
+
+      host, port = host_and_port
+
+      # Sync each directory
+      files_rsync.each do |file_dir|
+        source = "#{user}@#{host}:#{shared_path}/#{file_dir}"
+        dest   = File.dirname("#{files_tmp_dir}/#{file_dir}")
+        FileUtils.mkdir_p(dest)
+        system "rsync --archive --compress --copy-links    --delete --stats --rsh='ssh -p #{port}' #{source} #{dest}"
+        logger.info "sync files from  #{host}:#{source} to #{dest} finished"
+      end
+
+    end
+
+    desc <<-DESC
+      Sync files from the local temp directory to the first web server. \
+      Files on the remote server will be copied in the shared directory.
+    DESC
+    task :upload, :roles => :web, :only => { :primary => true }, :once => true do
+      host, port = host_and_port
+      files_rsync.each do |file_dir|
+        source = "#{files_tmp_dir}/#{file_dir}"
+        dest   = "#{user}@#{host}:" + File.dirname("#{shared_path}/#{file_dir}")
+        system "rsync --archive --compress --keep-dirlinks --delete --stats --rsh='ssh -p #{port}' #{source} #{dest}"
+        logger.info "sync files from #{source} to #{host}:#{dest} finished"
+      end
+    end
+
+    desc <<-DESC
+      Creates :files_symlinks from the shared folder to the current one on the \
+      app servers. If a file or directory exists as the linkname, it will be \
+      removed.
+    DESC
+    task :create_symlinks, :roles => :app do
+      cmds = files_symlinks.collect do | l |
+        parent = File.dirname("#{latest_release}/#{l}")
+        "mkdir -p #{parent} && rm -rf #{latest_release}/#{l} && ln -nfs #{shared_path}/#{l} #{latest_release}/#{l}"
+      end
+      run cmds.join(' && ')
+    end
+
+    #
+    # Returns the actual host name to sync and port
+    #
+    def host_and_port
+      return roles[:web].servers.first.host, ssh_options[:port] || roles[:web].servers.first.port || 22
+    end
+
+  end
+
+  before 'deploy:finalize_update', 'files:create_symlinks'
+  before 'files:create_symlinks',  'files:set_tpl_symlinks'
+  after  'deploy:setup',           'files:upload_files_from_templates'
+end

data/lib/capistrano/chocopoche/mysql.rb

@@ -0,0 +1,190 @@
+# see https://gist.github.com/111597
+require 'fileutils'
+require 'yaml'
+
+# Converts deeply keys of a hash|array into symbols when they are strings
+# @see http://stackoverflow.com/questions/800122/best-way-to-convert-strings-to-symbols-in-hash#answer-15815545
+class Object
+  def deep_symbolize_keys
+    return self.inject({}){|memo,(k,v)| memo[k.to_sym] = v.deep_symbolize_keys; memo} if self.is_a? Hash
+    return self.inject([]){|memo,v    | memo           << v.deep_symbolize_keys; memo} if self.is_a? Array
+    return self
+  end
+end
+
+configuration = Capistrano::Configuration.respond_to?(:instance) ?
+  Capistrano::Configuration.instance(:must_exist) :
+  Capistrano.configuration(:must_exist)
+
+configuration.load do
+
+  _cset :mysql_backup_dir,  "backup/mysql"
+  _cset :mysql_config_file, "config/parameters.yml"
+  _cset :mysql_yaml_key,    :databases
+
+  namespace :mysql do
+
+    desc "Dump databases to remote backup folder."
+    task :dump, :roles => :db, :only => { :primary => true }, :once => true do
+      fetch_databases.each do |db,config|
+        db_backup_dir = "#{deploy_to}/#{mysql_backup_dir}/#{db}"
+        run "mkdir -p #{db_backup_dir}"
+
+        if exists? :stages
+          dump_filename = "%s/%s-%s-%d.sql" % [
+            db_backup_dir,
+            fetch(:stage),
+            config[:dbname],
+            Time.now.to_i
+          ]
+        else
+          dump_filename = "%s/%s-%d.sql" % [
+            db_backup_dir,
+            config[:dbname],
+            Time.now.to_i
+          ]
+        end
+
+        # Dumps the schema
+        cmd_schema = "mysqldump -h %s --default-character-set=utf8 --no-data -u%s -p %s > %s" % [
+          config[:host],
+          config[:user],
+          config[:dbname],
+          dump_filename
+        ]
+        begin
+          run cmd_schema do |ch, stream, out|
+            ch.send_data "#{config[:password]}\n" if out =~ /^Enter password:/
+          end
+        rescue Capistrano::CommandError => e
+          abort("Connection error, you may want to check database config.")
+        end
+
+        # Tables to ignore (cache, indexes, ...)
+        ignore_tables = ""
+        if config.has_key?(:capistrano) && config[:capistrano].has_key?(:ignore_tables)
+          # Retrieve tables to ignore and generate the mysqldump arguments
+          cmd_ignore_tables = "mysql -h %s --default-character-set=utf8 -u%s -p %s" % [
+            config[:host],
+            config[:user],
+            config[:dbname]
+          ]
+          cmd_ignore_tables += " -BNe 'show tables;'"
+          cmd_ignore_tables += " | grep -E '^#{config[:capistrano][:ignore_tables]}$'"
+          cmd_ignore_tables += " | xargs -I {} echo --ignore-table #{config[:dbname]}.{} "
+
+          run cmd_ignore_tables do |ch, stream, out|
+            if out =~ /^Enter password:/
+              ch.send_data "#{config[:password]}\n"
+            else
+              ignore_tables += " " + out.chop if out.match(/ignore-table/)
+            end
+          end
+        end
+
+        # Dumps the data
+        cmd_data = "mysqldump -h %s --default-character-set=utf8 -u%s -p %s %s >> %s" % [
+          config[:host],
+          config[:user],
+          ignore_tables,
+          config[:dbname],
+          dump_filename
+        ]
+
+        # Executes sql
+        run cmd_data do |ch, stream, out|
+          ch.send_data "#{config[:password]}\n" if out =~ /^Enter password:/
+        end
+
+        # Compress dump
+        run "bzip2 #{dump_filename}"
+      end
+    end
+
+    desc "Import last remote dumps to databases."
+    task :import, :roles => :db, :only => { :primary => true }, :once => true do
+      fetch_databases.each do |db,config|
+        remote_db_backup_dir = "#{deploy_to}/#{mysql_backup_dir}/#{db}"
+        last_dump = capture("ls -xt #{remote_db_backup_dir}").split.reverse.last
+
+        # cmd = "mysql -u%s -p\"%s\" %s < %s/%s" % [
+        #   config[:user],
+        #   config[:password],
+        #   config[:dbname],
+        #   remote_db_backup_dir,
+        #   last_dump
+        # ]
+        # run cmd do |ch, stream, out|
+        #   ch.send_data "#{config[:password]}\n" if out =~ /^Enter password:/
+        # end
+
+        run "bzcat #{remote_db_backup_dir}/#{last_dump} | mysql -u%s -p\"%s\" %s" % [
+          config[:user],
+          config[:password],
+          config[:dbname]
+        ]
+      end
+    end
+
+    desc "Download last remote dumps of each databases."
+    task :download, :roles => :db, :only => { :primary => true }, :once => true do
+      fetch_databases.each do |db,config|
+        local_db_backup_dir  = "#{mysql_backup_dir}/#{db}"
+        remote_db_backup_dir = "#{deploy_to}/#{mysql_backup_dir}/#{db}"
+
+        # Don't know how to avoid the command error if the remote_db_backup_dir
+        # does not exist, other than this way
+        begin
+          dumps = capture("test -d #{remote_db_backup_dir} && ls -xt #{remote_db_backup_dir}").split.reverse
+        rescue Capistrano::CommandError
+          logger.important "No dump found!"
+        end
+
+        if dumps
+          FileUtils.mkdir_p(local_db_backup_dir)
+          hostname  = capture("hostname -f").chop
+          file_name = "#{local_db_backup_dir}/#{hostname}-#{dumps.last}"
+          top.get("#{remote_db_backup_dir}/#{dumps.last}", file_name)
+        end
+      end
+    end
+
+    desc "Upload last local dump of each databases."
+    task :upload, :roles => :db, :only => { :primary => true }, :once => true do
+
+      databases = fetch_databases
+
+      databases.each do |db,config|
+
+        local_db_backup_dir  = "#{mysql_backup_dir}/#{db}"
+        remote_db_backup_dir = "#{deploy_to}/#{mysql_backup_dir}/#{db}"
+
+        if File.directory?(local_db_backup_dir) && last_dump = `ls -xt #{local_db_backup_dir}`.split.reverse.last
+          run "mkdir -p #{remote_db_backup_dir}"
+          top.upload("#{local_db_backup_dir}/#{last_dump}", "#{remote_db_backup_dir}/#{last_dump}")
+          logger.info "#{last_dump} uploaded."
+        else
+          logger.important 'No dump found!'
+        end
+      end
+    end
+
+    desc "[internal] Parses the config/databases.yml and returns compatible ones."
+    task :fetch_databases, :roles => :db, :only => { :primary => true }, :once => true do
+      location = "#{latest_release}/#{mysql_config_file}"
+
+      FileUtils.mkdir_p("config/deploy/tmp")
+      top.get(location, "config/deploy/tmp/parameters.yml")
+      config = YAML.load_file('config/deploy/tmp/parameters.yml').deep_symbolize_keys
+      FileUtils.rm("config/deploy/tmp/parameters.yml")
+
+      databases = config[mysql_yaml_key]
+      abort("No database found in #{mysql_config_file}") if databases.nil? || databases.length < 1
+      databases.delete_if { |key,value| value[:driver] != 'pdo_mysql' }
+      abort("No compatible database found in #{mysql_config_file}") if databases.length < 1
+
+      databases
+    end
+  end
+
+end

data/lib/{capistrano-chocopoche → capistrano/chocopoche}/railsless-deploy.rb

@@ -1,5 +1,4 @@
-require 'etc'
-require 'capistrano-chocopoche/common'
+require 'capistrano/chocopoche/common'
 
 configuration = Capistrano::Configuration.respond_to?(:instance) ?
   Capistrano::Configuration.instance(:must_exist) :
@@ -9,9 +8,9 @@ configuration = Capistrano::Configuration.respond_to?(:instance) ?
 configuration.load do
 
   # Remove rails specific tasks
+  deploy.tasks.delete(:cold)
   deploy.tasks.delete(:migrate)
   deploy.tasks.delete(:migrations)
-  deploy.tasks.delete(:cold)
 
   # Remove rails specific vars
   unset :rails_env
@@ -26,9 +25,6 @@ configuration.load do
     set(:deploy_to) { "/home/#{user}/apps/#{application}" }
   end
 
-  # Remove rails specific shared children
-  # set :shared_children, []
-
   namespace :deploy do
 
     desc <<-DESC
@@ -44,34 +40,21 @@ configuration.load do
       on_rollback do
         if previous_release
           previous_release_relative = relative_path(deploy_to, previous_release)
-          run "ln -s #{previous_release_relative} #{current_path}.tmp && mv -f #{current_path}.tmp #{current_path}"
+          run "ln -nfs #{previous_release_relative} #{current_path}"
         else
           logger.important "no previous release to rollback to, rollback of symlink skipped"
         end
       end
       latest_release_relative = relative_path(deploy_to,latest_release)
-      run "ln -s #{latest_release_relative} #{current_path}.tmp && mv -f #{current_path}.tmp #{current_path}"
+      run "ln -nfs #{latest_release_relative} #{current_path}"
     end
 
     desc <<-DESC
-      [internal] Touches up the released code. This is called by update_code \
-      after the basic deploy finishes. It assumes a Rails project was deployed, \
-      so if you are deploying something else, you may want to override this \
-      task with your own environment's requirements.
-
-      This task will make the release group-writable (if the :group_writable \
-      variable is set to true, which is the default). It will then set up \
-      symlinks to the shared directory for the log, system, and tmp/pids \
-      directories, and will lastly touch all assets in public/images, \
-      public/stylesheets, and public/javascripts so that the times are \
-      consistent (so that asset timestamping works).  This touch process \
-      is only carried out if the :normalize_asset_timestamps variable is \
-      set to true, which is the default The asset directories can be overridden \
-      using the :public_children variable.
+      [internal] This is called by update_code after the basic deploy \
+      finishes.
     DESC
     task :finalize_update, :except => { :no_release => true } do
     end
-
   end
 
   namespace :rollback do
@@ -83,7 +66,7 @@ configuration.load do
     task :revision, :except => { :no_release => true } do
       if previous_release
         previous_release_relative = relative_path(deploy_to, previous_release)
-        run "ln -s #{previous_release_relative} #{current_path}.tmp && mv -f #{current_path}.tmp #{current_path}"
+        run "ln -nfs #{previous_release_relative} #{current_path}"
       else
         abort "could not rollback the code because there is no prior release"
       end

data/lib/capistrano/chocopoche/sync-cli.rb

@@ -0,0 +1,67 @@
+require 'capistrano/cli'
+
+module Capistrano
+  module Chocopoche
+    class SyncCLI
+      def prompt(default, *args)
+        print(*args)
+        result = STDIN.gets.strip
+        return result.empty? ? default : result
+      end
+
+      def ensure_stages
+        show_error("The DATATYPE is missing.")       if @args[0].nil?
+        show_error("The DATATYPE is incorrect.") unless @args[0] =~ /^files|mysql$/
+        show_error("The SOURCE is missing.")         if @args[1].nil?
+        show_error("The DEST is missing.")           if @args[2].nil?
+        @data   = @args[0]
+        @source = @args[1]
+        @dest   = @args[2]
+      end
+
+      def ensure_confirmation
+        unless @options[:no_confirmation] == false
+          confirm = prompt('y', "Sync from #{@source} to #{@dest}? [Y/n] ").downcase
+          unless confirm == "y"
+            abort("Cancelled")
+          end
+        end
+      end
+
+      def show_error(msg)
+        puts @parser.help
+        abort("\n[ERROR] #{msg}")
+      end
+
+      def initialize(args)
+        @args    = args
+        @options = {}
+        @parser  = OptionParser.new do |opts|
+          opts.banner  = "Usage: files-sync [options] DATATYPE SOURCE DEST \n"
+          opts.banner += "Sync DATATYPE from the SOURCE stage to the DEST stage.\n"
+          opts.on("-y", "--no-confirmation", "Don't prompt for confirmation") do |v|
+            @options[:no_confirmation] = v
+          end
+
+          opts.on("--no-backup", "Dont backup databases before importing") do |v|
+            @options[:no_backup] = v
+          end
+        end
+      end
+
+      def execute
+        @parser.parse!
+        ensure_stages
+        ensure_confirmation
+        if @data == 'mysql'
+          Capistrano::CLI.parse([@dest,   "mysql:dump"]).execute! unless @options[:no_backup]
+          Capistrano::CLI.parse([@source, "mysql:dump",   "mysql:download"]).execute!
+          Capistrano::CLI.parse([@dest,   "mysql:upload", "mysql:import"]).execute!
+        elsif @data == 'files'
+          Capistrano::CLI.parse([@source, "files:download"]).execute!
+          Capistrano::CLI.parse([@dest,   "files:upload"]).execute!
+        end
+      end
+    end
+  end
+end

data/lib/capistrano/chocopoche/version.rb

@@ -0,0 +1,5 @@
+module Capistrano
+  module Chocopoche
+    VERSION = "0.2.0"
+  end
+end

metadata

@@ -1,15 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: capistrano-chocopoche
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.2.0
 platform: ruby
 authors:
 - Corentin Merot
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-04-09 00:00:00.000000000 Z
+date: 2013-04-13 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: capistrano
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.14'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.14'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -24,10 +38,11 @@ dependencies:
     - - ~>
       - !ruby/object:Gem::Version
         version: '1.3'
-description: Capistrano recipes, with another railsless-deploy and a files utility.
+description: Capistrano recipes and bin for mysql, rsync, php composer.
 email:
 - cmerot@themarqueeblink.com
-executables: []
+executables:
+- csync
 extensions: []
 extra_rdoc_files: []
 files:
@@ -35,10 +50,16 @@ files:
 - Gemfile
 - LICENSE.txt
 - README.md
+- bin/csync
 - capistrano-chocopoche.gemspec
-- lib/capistrano-chocopoche/common.rb
-- lib/capistrano-chocopoche/files.rb
-- lib/capistrano-chocopoche/railsless-deploy.rb
+- lib/capistrano/chocopoche.rb
+- lib/capistrano/chocopoche/common.rb
+- lib/capistrano/chocopoche/composer.rb
+- lib/capistrano/chocopoche/files.rb
+- lib/capistrano/chocopoche/mysql.rb
+- lib/capistrano/chocopoche/railsless-deploy.rb
+- lib/capistrano/chocopoche/sync-cli.rb
+- lib/capistrano/chocopoche/version.rb
 homepage: https://github.com/chocopoche/capistrano-chocopoche
 licenses:
 - MIT
@@ -49,12 +70,12 @@ 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: []
@@ -64,4 +85,3 @@ signing_key:
 specification_version: 4
 summary: Chocopoche's Capistrano recipes
 test_files: []
-has_rdoc: 

data/lib/capistrano-chocopoche/common.rb

@@ -1,16 +0,0 @@
-configuration = Capistrano::Configuration.respond_to?(:instance) ?
-  Capistrano::Configuration.instance(:must_exist) :
-  Capistrano.configuration(:must_exist)
-
-
-configuration.load do
-
-  _cset :user, Etc.getlogin
-
-  # Used to create relative symlinks in deploy.create_symlink
-  def relative_path(from_str, to_str)
-    require 'pathname'
-    Pathname.new(to_str).relative_path_from(Pathname.new(from_str)).to_s
-  end
-
-end

data/lib/capistrano-chocopoche/files.rb

@@ -1,83 +0,0 @@
-# Capistrano recipe to rsync files up and down.
-#
-# author: Corentin Merot
-# real author: Michael Kessler aka netzpirat, see https://gist.github.com/111597
-
-require 'fileutils'
-require 'capistrano-chocopoche/common'
-
-configuration = Capistrano::Configuration.respond_to?(:instance) ?
-  Capistrano::Configuration.instance(:must_exist) :
-  Capistrano.configuration(:must_exist)
-
-configuration.load do
-
-  _cset :user,              Etc.getlogin
-  _cset :files_directories, []
-  _cset :files_tmp_dir,     'tmp/capistrano-chocopoche/files'
-
-  namespace :files do
-
-    desc <<-DESC
-      Sync files from the first web server to the local temp directory. \
-      Files on the remote server must be somewhere in the shared directory.
-    DESC
-    task :download, :roles => :web, :only => { :primary => true }, :once => true do
-
-      host, port = host_and_port
-
-      Array(fetch(:files_directories, [])).each do |file_dir|
-        unless File.directory? "#{files_tmp_dir}/#{file_dir}"
-          logger.info "create temporary '#{files_tmp_dir}/#{file_dir}' folder"
-          FileUtils.mkdir_p "#{files_tmp_dir}/#{file_dir}"
-        end
-
-        source = "#{shared_path}/#{file_dir}"
-        dest   = File.dirname("#{files_tmp_dir}/#{file_dir}")
-
-        # Sync directory down
-        system "rsync --verbose --archive --compress --copy-links --delete --stats --rsh='ssh -p #{port}' #{user}@#{host}:#{source} #{dest}"
-        logger.info "sync files from  #{host}:#{source} to #{dest} finished"
-      end
-
-    end
-
-    desc <<-DESC
-      Sync files from the local temp directory to the first web server. \
-      Files on the remote server will be copied in the shared directory.
-    DESC
-    task :upload, :roles => :web, :only => { :primary => true }, :once => true do
-
-      host, port = host_and_port
-      Array(fetch(:files_directories, [])).each do |file_dir|
-        source = "#{files_tmp_dir}/#{file_dir}"
-        dest   = File.dirname("#{shared_path}/#{file_dir}")
-
-        # Sync directory up
-        system "rsync --verbose --archive --compress --keep-dirlinks --delete --stats --rsh='ssh -p #{port}' #{source} #{user}@#{host}:#{dest}"
-        logger.info "sync files from #{source} to #{host}:#{dest} finished"
-      end
-    end
-
-    desc <<-DESC
-      Creates :files_symlinks from the shared folder to the current one on the \
-      web servers
-    DESC
-    task :create_symlinks, :roles => [:web] do
-      symlinks = fetch(:files_symlinks)
-      cmds = symlinks.collect do | l |
-        parent = File.dirname("#{current_path}/#{l}")
-        "mkdir -p #{parent} && ln -fs #{shared_path}/#{l} #{current_path}/#{l}"
-      end
-      run cmds.join(' && ')
-    end
-
-    #
-    # Returns the actual host name to sync and port
-    #
-    def host_and_port
-      return roles[:web].servers.first.host, ssh_options[:port] || roles[:web].servers.first.port || 22
-    end
-
-  end
-end