Configure Celery

Celery is an asynchronous task queue. It's a part of RhodeCode scheduler functionality. Celery makes certain heavy tasks perform more efficiently. Most important it allows sending notification emails, create repository forks, and import repositories in async way. It is also used for bi-directional repository sync in scheduler.

If you decide to use Celery you also need a working message queue. The recommended and fully supported message broker is rabbitmq.

In order to install and configure Celery, follow these steps:

1. Install RabbitMQ, see the documentation on the Celery website for rabbitmq installation, or rabbitmq website installation

1a. As en example configuration after installation, you can run:

sudo rabbitmqctl add_user rcuser secret_password
sudo rabbitmqctl add_vhost rhodevhost
sudo rabbitmqctl set_user_tags rcuser rhodecode
sudo rabbitmqctl set_permissions -p rhodevhost rcuser ".*" ".*" ".*"

2. Enable celery, and install celery worker process script using the enable-module:

   rccontrol enable-module celery {instance-id}
   

3. Configure Celery in the :file:`home/{user}/.rccontrol/{instance-id}/rhodecode.ini` file. Set the broker_url as minimal settings required to enable operation. If used our example data from pt 1a, here is how the broker url should look like:

   celery.broker_url = amqp://rcuser:secret_password@localhost:5672/rhodevhost
   

   Full configuration example is below:

   # Set this section of the ini file to match your Celery installation
   ####################################
   ###        CELERY CONFIG        ####
   ####################################
   
   use_celery = true
   celery.broker_url = amqp://rcuser:secret@localhost:5672/rhodevhost
   
   # maximum tasks to execute before worker restart
   celery.max_tasks_per_child = 100
   
   ## tasks will never be sent to the queue, but executed locally instead.
   celery.task_always_eager = false