Skip to content

lafourmiliere-benevolat/capistrano-good_job

 
 

Repository files navigation

Capistrano Systemd integration for GoodJob

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

Installation

Add this line to your application's Gemfile:

group :development do
  source "https://rubygems.pkg.github.com/lafourmiliere-benevolat" do
    gem "capistrano-good_job", "0.1.8", require: false
  end
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.

Usage

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

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 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.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/lafourmiliere-benevolat/foodie.

License

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

Credits

The structure and code of the gem are heavily inspired by capistrano-puma's systemd tasks

About

GoodJob systemd integration for Capistrano

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

 
 
 

Languages

  • Ruby 85.9%
  • HTML 12.6%
  • Shell 1.5%