Adds the following capistrano commands:
good_job:generate # Generate locally good_job systemd service unit file
good_job:disable # Disable good_job systemd service
good_job:enable # Enable good_job systemd service
good_job:install # Install good_job systemd service
good_job:reload # Reload good_job service via systemd
good_job:restart # Restart good_job service via systemd
good_job:start # Start good_job service via systemd
good_job:status # Get good_job service status via systemd
good_job:stop # Stop good_job service via systemd
good_job:uninstall # Uninstall good_job systemd service
Add this line to your application's Gemfile:
group :development do
gem 'capistrano-good_job', require: false
end
And then execute:
$ bundle
# Capfile
require 'capistrano/good_job'
install_plugin Capistrano::GoodJob
To prevent loading the hooks of the plugin, add false to the load_hooks param.
# Capfile
install_plugin Capistrano::GoodJob, load_hooks: false
Then run once
bundle exec cap production good_job:install
for the initial setup. This will copy a systemd
service definition to ~/.config/systemd/user/symantiq_good_job.service
on your server marked with Capistrano role db
.
It will also enable
it in systemd
, allowing to to then run commands such as:
systemctl --user status your_app_good_job_production
systemctl --user start your_app_good_job_production
systemctl --user stop your_app_good_job_production
systemctl --user reload your_app_good_job_production
systemctl --user restart your_app_good_job_production
through their Capistrano counterparts, ex: bundle exec cap good_job:restart
.
The plugin has registered a Capistrano hook
to run bundle exec cap good_job:restart
after deploy:
after "deploy:finished", "good_job:restart"
See #register_hooks
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 install this gem onto your local machine, run bundle exec rake install
. 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 the created tag, and push the .gem
file to rubygems.org.
Bug reports and pull requests are welcome on GitHub at https://github.com/mtomov/capistrano_good_job.
The gem is available as open source under the terms of the MIT License.
The structure and code of the gem are heavily inspired by capistrano-puma
's systemd
tasks