tomo-plugin-sidekiq

This is a tomo plugin that provides tasks for managing sidekiq via systemd, based on the recommendations in the sidekiq documentation. This plugin assumes that you are also using the tomo rbenv and env plugins, and that you are using a systemd-based Linux distribution like Ubuntu 18 LTS.

This plugin requires Sidekiq 6.0.6 or newer.

• Installation
• Settings
• Tasks
• Recommendations
• Support
• License
• Code of conduct
• Contribution guide

Run:

$ gem install tomo-plugin-sidekiq

Or add it to your Gemfile:

gem "tomo-plugin-sidekiq"

Then add the following to .tomo/config.rb:

plugin "sidekiq"

setup do
  # ...
  run "sidekiq:setup_systemd"
end

deploy do
  # ...
  # Place this task at *after* core:symlink_current
  run "sidekiq:restart"
end

This plugin installs sidekiq as a user-level service using systemctl --user. This allows sidekiq to be installed, started, stopped, and restarted without a root user or sudo. However, when provisioning the host you must make sure to run the following command as root to allow the sidekiq process to continue running even after the tomo deploy user disconnects:

# run as root
$ loginctl enable-linger <DEPLOY_USER>

Configures systemd to manage sidekiq. This means that sidekiq will automatically be restarted if it crashes, or if the host is rebooted. This task essentially does two things:

1. Installs a sidekiq.service systemd unit
2. Enables it using systemctl --user enable

Note that these units will be installed and run for the deploy user. You can use :sidekiq_systemd_service_template_path to provide your own template and customize how sidekiq and systemd are configured.

sidekiq:setup_systemd is intended for use as a setup task. It must be run before sidekiq can be started during a deploy.

Gracefully restarts the sidekiq service via systemd, or starts it if it isn't running already. Equivalent to:

systemctl --user restart sidekiq.service

Starts the sidekiq service via systemd, if it isn't running already. Equivalent to:

systemctl --user start sidekiq.service

Stops the sidekiq service via systemd. Equivalent to:

systemctl --user stop sidekiq.service

Prints the status of the sidekiq systemd service. Equivalent to:

systemctl --user status sidekiq.service

Uses journalctl (part of systemd) to view the log output of the sidekiq service. This task is intended for use as a run task and accepts command-line arguments. The arguments are passed through to the journalctl command. For example:

$ tomo run -- sidekiq:log -f

Will run this remote script:

journalctl -q --user-unit=sidekiq.service -f

Add a config/sidekiq.yml file to your application (i.e. checked into git) and use that to configure sidekiq, using environment variables as necessary. For example:

---
:queues:
  - default

:concurrency: <%= ENV.fetch("SIDEKIQ_CONCURRENCY", "1") %>

Now you can tune sidekiq for each environment by simply setting environment variables (e.g. using tomo run env:set), without hard-coding configuration in git or within systemd files.

If you want to report a bug, or have ideas, feedback or questions about the gem, let me know via GitHub issues and I will do my best to provide a helpful answer. Happy hacking!

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

Everyone interacting in this project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the code of conduct.

Pull requests are welcome!