Contents

= Porter Gem

The Porter gem is comprised of Capistrano and Rake tasks that make cloning your production server data down to your development environment a cinch.

== Overview

* A mysqldump command is remotely issued (via Capistrano) to the remote production server, saving the result as a compressed (gz) file
* The database backup file from the server is retrieved (via scp) and decompressed
* The development database is dropped, recreated, and restored from the backup
* Assets stored in shared/public are rysnc'd down to your local public directory (exclusions are accepted!)
* Separate rake tasks are included for restoring the db and re-syncing the assets without re-dumping the production db

== Dependencies

* Capistrano (and a config/deploy.rb file)
* Rake
* A Rails App
* rsync (locally and remotely)

== Installation

* sudo gem install porter
* config.gem 'porter'
* script/generate porter
* See the generated config/porter_config.yml - it's pretty straight-forward

== Usage

* cap porter:production (creates the remote database backup then calls the two rake tasks below)
* rake porter:production:db (if you've already got a db backup pulled down and want to restore from it again)
* rake porter:production:assets (rsync the assets down from the production server again)

== Copyright

Copyright (c) 2010 Kenny Johnston. See LICENSE for details.

Version data entries

3 entries across 3 versions & 1 rubygems

Version	Path
porter-0.1.4	README.rdoc
porter-0.1.2	README.rdoc
porter-0.1.1	README.rdoc