https://github.com/divio/aldryn-celery

An opinionated Celery setup bundled as an Aldryn Addon. To be used together with aldryn-django. * Deprecated *
https://github.com/divio/aldryn-celery

Last synced: 2 months ago
JSON representation

An opinionated Celery setup bundled as an Aldryn Addon. To be used together with aldryn-django. * Deprecated *

• Host: GitHub
• URL: https://github.com/divio/aldryn-celery
• Owner: divio
• License: other
• Created: 2016-01-25T09:15:04.000Z (about 9 years ago)
• Default Branch: master
• Last Pushed: 2022-06-03T13:13:59.000Z (over 2 years ago)
• Last Synced: 2023-04-10T18:25:43.991Z (almost 2 years ago)
• Language: Python
• Homepage:
• Size: 23.4 KB
• Stars: 2
• Watchers: 12
• Forks: 5
• Open Issues: 14
• Metadata Files:
  • Readme: README.rst
  • Changelog: CHANGELOG.rst
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
**Deprecated**

This project is no longer supported.

Divio will undertake no further development or maintenance of this project. If you are interested in continuing to 

develop it, use the fork functionality from GitHub. We are not able to transfer ownership of the repository to another 

party.

=============

Aldryn Celery

=============

|PyPI Version|

An opinionated Celery setup bundled as an Aldryn Addon.

To be used together with aldryn-django.

Contributing

============

This is a an open-source project. We'll be delighted to receive your

feedback in the form of issues and pull requests. Before submitting your

pull request, please review our `contribution guidelines

`_.

We're grateful to all contributors who have helped create and maintain this package.

Contributors are listed at the `contributors `_

section.

======================

Installation & Updates

======================

`Installation Documentation on docs.divio.com `_

*********************

Aldryn Platform Users

*********************

Ask Aldryn staff to add this Addon to your Project. It is currently still

hidden.

Aldryn staff has to:

 * provision a rabbitmq vhost and set the ``BROKER_URL`` environment variable.

 * configure the additional worker processes to run in the background (celeryd,

   celerybeat and celerycam)

*******************

Manual Installation

*******************

tbd.

Usage

=====

rough notes:

see ``aldryn_config.py`` to see the environment variables that can be used as

knobs.

Use the following commands to start the celery processes:

* ``aldryn-celery worker``

* ``aldryn-celery beat``

* ``aldryn-celery cam``

Local setup on Aldryn Platform

==============================

Add the following services to your ``docker-compose.yml`` file::

    celeryworker:

      command: aldryn-celery worker

    celerybeat:

      command: aldryn-celery beat

    celerycam:

      command: aldryn-celery cam

    rabbitmq:

      image: rabbitmq:3.5-management

      hostname: rabbitmq

      ports:

        - "15672:15672"

      expose:

        - "15672"

      environment:

        RABBITMQ_ERLANG_COOKIE: "secret cookie here"

For ``celeryworker``, ``celerybeat`` and ``celerycam`` copy in all the options from the ``web`` service, except ``ports``.

In ``web``, ``celeryworker``, ``celerybeat`` and ``celerycam`` add::

    links:

      - "rabbitmq:rabbitmq"

In ``.env-local`` add the following::

    RABBITMQ_ERLANG_COOKIE="secret cookie here"

    BROKER_URL="amqp://guest:guest@rabbitmq:5672/"

``docker-compose up`` or ``divio project up`` will now also startup celery.

Run ``docker-compose stop web && docker-compose rm web && docker-compose up -d web`` for the ``web`` service to pick up the new env vars.

Keep in mind, that celery does not auto reload on code changes. So you need to ``docker-compose restart celeryworker`` after every code change.

.. |PyPI Version| image:: http://img.shields.io/pypi/v/aldryn-celery.svg

   :target: https://pypi.python.org/pypi/aldryn-celery