This is an attempt to create a repeatable deployment script for the Ruby on Rails Tutorial (Michael Hartl) sample application to a VPS using Capistrano 3.1.0.
It flows directly from my other repo, jbinto/ansible-ubuntu-rails-server, where I set up an Ubuntu deployment environment using Ansible and Vagrant.
This repo is forked from mhartl/sample_app_4_0_upgrade.
Work in progress! The instructions are still a little clunky, I'm updating them as I learn. It's evident I need to improve certain things. For instance, I'm not quite sure yet where Ansible should end and Capistrano should begin.
First, set up the jbinto/ansible-ubuntu-rails-server Vagrant/Ansible box. (Or, adapt the code to your environment. Specifically, config/deploy.rb, config/deploy/ and lib/capistrano/.)
This means you already have a Postgres database set up for your app. You have a Postgres user with a generated password, and a database.yml with this password already in the right place (~/apps/<APP_NAME>/shared/config/). In theory, you should never have to see or touch this. Thanks to Ansible, the intermediate "ssh into the server and type in your password" step is gone.
Clone the repo:
git clone https://github.com/jbinto/sample_app_4_0_upgrade.git
cd sample_app_4_0_upgrade
Deploy:
cap production deploy
This will:
- rsync files to the server
- (but not 'shared' files, like logs, pids, sockets, configs)
- do some magic with rotating releases (keeps the past 5)
- run bundler
- run migrations
You can do some tasks manually:
cap production deploy:bundle
cap production deploy:migrate
cap production deploy:restart
When you first clone the repo, you need to do a few things:
cp db/database.yml.example db/database.yml(since database.yml is under gitignore)bundle exec rake db:test:prepare(since there's a Capistrano task to runrake specbefore deploying.)
This is the sample application for Ruby on Rails Tutorial: Learn Web Development with Rails by Michael Hartl. You can use this reference implementation to help track down errors if you end up having trouble with code in the tutorial. In particular, as a first debugging check I suggest getting the test suite to pass on your local machine:
$ cd /tmp
$ git clone git@github.com:railstutorial/sample_app_2nd_ed.git
$ cd sample_app_2nd_ed
$ bundle install
$ bundle exec rake db:migrate
$ bundle exec rake db:test:prepare
$ bundle exec rspec spec/
If the tests don't pass, it means there may be something wrong with your system. If they do pass, then you can debug your code by comparing it with the reference implementation.