README.md

Ansible role for sidekiq

This sets up sidekiq systemctl service on ubuntu.

Dependencies

You need redis to run sidekiq. Just installing the package on ubuntu is sufficient.

Vars

Vars that must be set

sidekiq_dir
sidekiq_env
sidekiq_user

Vars with defaults that you can override

sidekiq_queues: []
sidekiq_instance: ~

Note use RAILS_MAX_THREADS ENV to set concurrency.

Example playbook

Example usage:

- role: thermistor.sidekiq
  sidekiq_dir: /srv/www/beep.eco/beep
  sidekiq_env: production
  sidekiq_user: beep
  tags:
    - sidekiq

You can also specify the queues. This will create command-line args that override a config/sidekiq.yml if present in the app:

- role: thermistor.sidekiq
  sidekiq_queues:
    - mailers
    - default
  sidekiq_dir: /srv/www/beep.eco/beep
  sidekiq_env: production
  sidekiq_user: beep
  tags:
    - sidekiq

You can specify a sidekiq role more than once in a playbook. You might want to do this to if you want a reserved queue for high priority jobs. For this to work you must provide a unique sidekiq_instance name for each runner:

- role: thermistor.sidekiq
  sidekiq_instance: mailers
  sidekiq_queues:
    - mailers
  sidekiq_dir: /srv/www/beep.eco/beep
  sidekiq_env: production
  sidekiq_user: beep
  tags:
    - sidekiq
- role: thermistor.sidekiq
  sidekiq_instance: default
  sidekiq_queues:
    - default
  sidekiq_dir: /srv/www/beep.eco/beep
  sidekiq_env: production
  sidekiq_user: beep
  tags:
    - sidekiq

License

MIT