girder.celery

This is an Ansible role for setting up a Celery worker.

Requirements

You need Ubuntu 20.04 or newer.

Your project that uses Celery must meet these requirements:

It should be installable from a Git repo.
- If your project can only be installed from PyPI, please report an issue.
It must be installable via pip.
If there is a requirements.txt file, it should include the line . to install the project itself.
It must have celery listed as a requirement.
It should have a Celery app instance in a location that can be imported.

Role Variables

Parameter	Required	Default	Comments
`celery_app`	Yes		The import path for the Celery app, used with `-A` or `--app`.
`celery_repository_url`	Yes		The HTTP URL of the Git repository for the Celery project.
`celery_repository_ref`	No	`HEAD`	The Git reference to checkout when cloning the repo.
`celery_environment`	No	`{}`	A mapping of environment variables for the Celery worker during runtime.

Example Playbook

Here's an example playbook using this role:

- name: Deploy Celery worker
  hosts: all
  vars:
    ansible_python_interpreter: auto
  roles:
    - role: girder.celery
      vars:
        celery_app: test_project.celery
        celery_repository_url: https://github.com/girder/ansible-role-girder-celery.git
        celery_environment:
          DJANGO_STORAGE_BUCKET_NAME: "my-bucket"