Capistrano Transmit¶ ↑

Tasks to work with production data and assets.

This Capistrano plugin allows you to fetch the production database and assets and store them in your local development environment. For reasonably sized projects, you should do this regularly since you will notice typical production-related slowdowns such as missing indexes. The task to fetch assets helps keep your images un-broken, which is always nice.

The only thing this plugin does, is extend Capistrano. No Rails code is loaded. Capistrano loads the scripts in the recipes directory, and that’s just what we need.

The plugin uses rsync to transfer the files, which means any existing files are skipped and/or appended based on their checksum. The transfers are compressed as well so we don’t need to gzip the contents first. All this assumes both your production and development environment are Unix. Tested on Linux production and Mac OS X development.

Installation for Rails 3+¶ ↑

In Gemfile:

gem 'capistrano_transmit', require: false, group: :development

Then add to your deploy.rb:

require 'capistrano/transmit'

Examples¶ ↑

cap transmit:get:mysql		# Fetch the production database into local development
cap transmit:put:mysql		# Overwrite the production MySQL database with your development data

Prerequisites¶ ↑

You need Capistrano 2 for this gem to work.

A couple variables can be overridden by setting them in config/deploy.rb:

user                      # SSH user, defaults to nil, which falls back to your unix user
deploy_host               # the host on which to run the db dump, falls back to your first db
dumpfile                  # remote pathname to dump the database in, defaults to tmp/${production}.sql.gz