Simple tasks real-time updates with django channels, DRF, celery
This repo is showing example how you can use celery tasks and django channels to send tasks progress over the websockets. The client side is written in react and redux.
The task that is executed in celery it is simple add. It accepts two arguments in JSON format, example {"arg1": 2, "arg2": 2}. It will execute as long as the value of the arg1. If the value of arg1 is negative the worker crash will be simulated in the code (crash with segfault). If the value of arg2 is negative then the worker will crash during importing fake package. (Both crash simulations were used to show how we can set FAILURE state even if worker crashed).
In this example the task can be in following states: CREATED, PROGRESS, SUCCESS, FAILURE. The progress value is not stored in database, it is only broadcasted by websockets during task exceution.
The task states and progress are set by:
backend/worker/redis_listener.pywhich is pubsub on redis. It is updating the progress value.backend/worker/worker_listener.pywhich is monitoring celery events. It is setting state values, for example in case of task failure.
In this example we are running gunicorn and daphne servers and redirecting requests in nginx:
- HTTP is going to
gunicorn - websocket is going to
daphne
This can be changed, and both HTTP and websocket connectionscan be handled by daphne server.
To run the app you can use docker-compose:
docker-compose up --build -d
To stop the app:
docker-compose down
The app will be accessed at 0.0.0.0:8000.