Getting Celery Running with Django, django-celery, RabbitMQ and MacPorts

UPDATE: With the release of Celery 3.1, these instructions are out of date. I’ll be posting some notes on migration and doing a fresh 3.1 installation in the near future.

I recently needed an asynchronous task queue and found the fantastic Celery Project to be just what I was looking for.

Getting up and running was fairly simple as there’s lots of great documentation…

Django + Celery
http://docs.celeryproject.org/en/latest/django/first-steps-with-django.html

RabbitMQ
http://docs.celeryproject.org/en/latest/getting-started/brokers/rabbitmq.html
http://www.rabbitmq.com/install-macports.html

But rather than read all of those, here’s a quick rundown of the 5 steps it takes to get up and running…

1) Install RabbitMQ

# required ports

sudo port install erlang +ssl

sudo port install rabbitmq-server

# start the server on system boot

sudo port load rabbitmq-server

# OPTIONAL – install the librabbitmq C library (it's faster thant the default amqp)

sudo pip install librabbitmq

view raw
installs.sh
hosted with ❤ by GitHub

2) OPTIONAL – configure a rabbitmq user

# RabbitMQ installs with a default username / password of guest / guest

# you can change that by creating a new user

rabbitmqctl add_user myuser mypassword

rabbitmqctl add_vhost myvhost

rabbitmqctl set_permissions -p myvhost myuser ".*" ".*" ".*"

view raw
rabbitmq.sh
hosted with ❤ by GitHub

3) Install Celery

# will also install: billiard python-dateutil kombu anyjson amqp

sudo pip install Celery

# install the Django Celery lib

sudo pip install django-celery

view raw
celery.sh
hosted with ❤ by GitHub

4) Configure your Django application

# add the following to your settings.py

import djcelery

djcelery.setup_loader()

# assuming you didn't change the default RabbitMQ username / password

BROKER_URL = 'amqp://guest:guest@localhost:5672/'

view raw
settings.py
hosted with ❤ by GitHub

5) Sync your DB

# when using South

python manage.py migrate djcelery

# when not using South

python manage.py syncdb

view raw
manage.py
hosted with ❤ by GitHub

Boom goes the dynamite. You can now jump into the beginners Django tutorial found here.

One thought on “Getting Celery Running with Django, django-celery, RabbitMQ and MacPorts”

	# required ports
	sudo port install erlang +ssl
	sudo port install rabbitmq-server

	# start the server on system boot
	sudo port load rabbitmq-server

	# OPTIONAL – install the librabbitmq C library (it's faster thant the default amqp)
	sudo pip install librabbitmq

	# RabbitMQ installs with a default username / password of guest / guest
	# you can change that by creating a new user
	rabbitmqctl add_user myuser mypassword
	rabbitmqctl add_vhost myvhost
	rabbitmqctl set_permissions -p myvhost myuser "." "." ".*"

	# will also install: billiard python-dateutil kombu anyjson amqp
	sudo pip install Celery

	# install the Django Celery lib
	sudo pip install django-celery

	# add the following to your settings.py
	import djcelery
	djcelery.setup_loader()

	# assuming you didn't change the default RabbitMQ username / password
	BROKER_URL = 'amqp://guest:guest@localhost:5672/'

	# when using South
	python manage.py migrate djcelery

	# when not using South
	python manage.py syncdb

Share this:

Like this:

Related

One thought on “Getting Celery Running with Django, django-celery, RabbitMQ and MacPorts”

Leave a Reply Cancel reply