Capistrano::SharedConfigs

This gem provides capistrano tasks to pull the latest configs from the shared configs branch and update the symlinks in the shared directory.

Installation

Add this line to your application's Gemfile:

gem 'capistrano-shared_configs'

And then execute:

$ bundle

Or install it yourself as:

$ gem install capistrano-shared_configs

Usage

It depends on another agent (i.e. puppet) to get the shared_configs branch onto the server.

The tasks can be made available to your capistrano deploy environments by requiring capistrano/shared_configs in your Capfile.

The three tasks made available to you are

cap shared_configs:check
cap shared_configs:pull
cap shared_configs:symlink
cap shared_configs:update

shared_configs:update simply calls pull and then symlink and is intended to provide a simple single command.

This can be added into your deployment workflow to automatically pull and symlink shared configs into your capistrano shared directories, or alternatively just run manually from the command line.

Development

After checking out the repo, run bin/setup to install dependencies. You can also run bin/console for an interactive prompt that will allow you to experiment.

To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/sul-dlss/capistrano-shared_configs.

License

The gem is available as open source under the terms of the Apache 2.0 License.