Add supervisord contrib example (#3262)
* Add supervisord contrib example Useful for running a development instance really quickly. Doesn't yet support: * ipdb/pdb, but still supports rdb * color log output * Revert to celery concurrency * Updatestheme-0.6.2
parent
02cc08f245
commit
2e39d5f21a
|
@ -15,6 +15,7 @@
|
||||||
.ropeproject/
|
.ropeproject/
|
||||||
_build
|
_build
|
||||||
bower_components/
|
bower_components/
|
||||||
|
contrib/supervisord.log
|
||||||
deploy/.vagrant
|
deploy/.vagrant
|
||||||
dist/*
|
dist/*
|
||||||
local_settings.py
|
local_settings.py
|
||||||
|
|
|
@ -0,0 +1,28 @@
|
||||||
|
Running Read the Docs via Supervisord
|
||||||
|
=====================================
|
||||||
|
|
||||||
|
This is the easiest way to start all of the commands you'll need for development
|
||||||
|
in an environment relatively close to the production evironment. All you need is
|
||||||
|
``supervisord`` and ``redis-server``. Installation of ``redis-server`` is
|
||||||
|
outside the scope of this documentation, but once installed, all you need to run
|
||||||
|
from ``supervisord`` is::
|
||||||
|
|
||||||
|
pip install supervisord
|
||||||
|
cd contrib/
|
||||||
|
supervisord
|
||||||
|
|
||||||
|
This will bring up a web instance for the dashboard, a web instance for
|
||||||
|
documentation serving, two celery instances, and redis-server.
|
||||||
|
|
||||||
|
If you already are running redis-server, this will complain about the port
|
||||||
|
already being in use, but will still load.
|
||||||
|
|
||||||
|
Debugging
|
||||||
|
---------
|
||||||
|
|
||||||
|
To debug, set trace points like normal, with ``pdb``/``ipdb``. Then you can
|
||||||
|
connect to the process by bringing it to the foreground::
|
||||||
|
|
||||||
|
supervisorctl fg main
|
||||||
|
|
||||||
|
You'll still see logging to STDERR on the main supervisord process page.
|
|
@ -0,0 +1,42 @@
|
||||||
|
[supervisord]
|
||||||
|
nodaemon = True
|
||||||
|
directory = ../
|
||||||
|
loglevel = error
|
||||||
|
strip_ansi = False
|
||||||
|
environment = PYTHONUNBUFFERED=1,READTHEDOCS_INSTANCE=readthedocs.org
|
||||||
|
|
||||||
|
[inet_http_server]
|
||||||
|
port = 127.0.0.1:9001
|
||||||
|
username = 🍔
|
||||||
|
password = 🍟
|
||||||
|
|
||||||
|
[supervisorctl]
|
||||||
|
username = 🍔
|
||||||
|
password = 🍟
|
||||||
|
|
||||||
|
[rpcinterface:supervisor]
|
||||||
|
supervisor.rpcinterface_factory = supervisor.rpcinterface:make_main_rpcinterface
|
||||||
|
|
||||||
|
[program:redis]
|
||||||
|
command = redis-server
|
||||||
|
directory = ../
|
||||||
|
priority = 0
|
||||||
|
startretries = 0
|
||||||
|
stderr_logfile = /dev/stderr
|
||||||
|
stderr_logfile_maxbytes = 0
|
||||||
|
|
||||||
|
[program:main]
|
||||||
|
command = python manage.py runserver 8000
|
||||||
|
directory = ../
|
||||||
|
priority = 100
|
||||||
|
stopasgroup = True
|
||||||
|
stderr_logfile = /dev/stderr
|
||||||
|
stderr_logfile_maxbytes = 0
|
||||||
|
|
||||||
|
[program:celery]
|
||||||
|
command = celery worker -A readthedocsinc -Q default,celery,web,builder -l DEBUG -c 2
|
||||||
|
directory = ../
|
||||||
|
priority = 100
|
||||||
|
stopasgroup = True
|
||||||
|
stderr_logfile = /dev/stderr
|
||||||
|
stderr_logfile_maxbytes = 0
|
Loading…
Reference in New Issue