This is an Ansible role for setting up Flower, which is Celery's web user interface.

What It Does

This role installs the flower Python module using pip, sets up a flower service, and creates a flowerconfig.py file. It also starts the service.

How to Use It

Here is a simple example of a playbook:

- hosts: all
  roles:
    - role: flower
      vars:
        flower_port: 80
        flower_app_name: proj
        flower_app_dir: /my/cool/app
        flower_broker_url: http://localhost:5671

It is highly recommended to store the {{ flower_ui_users }} and broker URL/API variables in secret_group_vars.

Virtual Environment

The role automatically installs celery in the home directory of {{ flower_user }} (~/.local/bin/celery). If you want to use your own virtual environment, set the {{ flower_venv_dir }} variable (just the directory without /bin/celery), and the role will install it there or create the necessary directory and virtual environment.

Applications

To use apps with flower, you should set the {{ flower_app_dir }} variable to point to the app's directory, which will also be where the service runs. The {{ flower_app_name }} is just the name of the module.

Galaxy

If you are using this role for Galaxy servers, make sure to set both:

• {{ flower_app_dir }}
• {{ flower_python_path }} (this can be relative to the app's directory)