| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221 |
- # Sample Gunicorn configuration file.
- #
- # Server socket
- #
- # bind - The socket to bind.
- #
- # A string of the form: 'HOST', 'HOST:PORT', 'unix:PATH'.
- # An IP is a valid HOST.
- #
- # backlog - The number of pending connections. This refers
- # to the number of clients that can be waiting to be
- # served. Exceeding this number results in the client
- # getting an error when attempting to connect. It should
- # only affect servers under significant load.
- #
- # Must be a positive integer. Generally set in the 64-2048
- # range.
- #
- bind = '0.0.0.0:80'
- backlog = 2048
- #
- # Worker processes
- #
- # workers - The number of worker processes that this server
- # should keep alive for handling requests.
- #
- # A positive integer generally in the 2-4 x $(NUM_CORES)
- # range. You'll want to vary this a bit to find the best
- # for your particular application's work load.
- #
- # worker_class - The type of workers to use. The default
- # sync class should handle most 'normal' types of work
- # loads. You'll want to read
- # http://docs.gunicorn.org/en/latest/design.html#choosing-a-worker-type
- # for information on when you might want to choose one
- # of the other worker classes.
- #
- # A string referring to a Python path to a subclass of
- # gunicorn.workers.base.Worker. The default provided values
- # can be seen at
- # http://docs.gunicorn.org/en/latest/settings.html#worker-class
- #
- # worker_connections - For the eventlet and gevent worker classes
- # this limits the maximum number of simultaneous clients that
- # a single process can handle.
- #
- # A positive integer generally set to around 1000.
- #
- # timeout - If a worker does not notify the master process in this
- # number of seconds it is killed and a new worker is spawned
- # to replace it.
- #
- # Generally set to thirty seconds. Only set this noticeably
- # higher if you're sure of the repercussions for sync workers.
- # For the non sync workers it just means that the worker
- # process is still communicating and is not tied to the length
- # of time required to handle a single request.
- #
- # keepalive - The number of seconds to wait for the next request
- # on a Keep-Alive HTTP connection.
- #
- # A positive integer. Generally set in the 1-5 seconds range.
- #
- workers = 2
- worker_class = 'sync'
- worker_connections = 1000
- timeout = 15
- keepalive = 2
- #
- # spew - Install a trace function that spews every line of Python
- # that is executed when running the server. This is the
- # nuclear option.
- #
- # True or False
- #
- spew = False
- #
- # Server mechanics
- #
- # daemon - Detach the main Gunicorn process from the controlling
- # terminal with a standard fork/fork sequence.
- #
- # True or False
- #
- # raw_env - Pass environment variables to the execution environment.
- #
- # pidfile - The path to a pid file to write
- #
- # A path string or None to not write a pid file.
- #
- # user - Switch worker processes to run as this user.
- #
- # A valid user id (as an integer) or the name of a user that
- # can be retrieved with a call to pwd.getpwnam(value) or None
- # to not change the worker process user.
- #
- # group - Switch worker process to run as this group.
- #
- # A valid group id (as an integer) or the name of a user that
- # can be retrieved with a call to pwd.getgrnam(value) or None
- # to change the worker processes group.
- #
- # umask - A mask for file permissions written by Gunicorn. Note that
- # this affects unix socket permissions.
- #
- # A valid value for the os.umask(mode) call or a string
- # compatible with int(value, 0) (0 means Python guesses
- # the base, so values like "0", "0xFF", "0022" are valid
- # for decimal, hex, and octal representations)
- #
- # tmp_upload_dir - A directory to store temporary request data when
- # requests are read. This will most likely be disappearing soon.
- #
- # A path to a directory where the process owner can write. Or
- # None to signal that Python should choose one on its own.
- #
- daemon = False
- raw_env = []
- pidfile = None
- umask = 0
- user = None
- group = None
- tmp_upload_dir = None
- #
- # Logging
- #
- # logfile - The path to a log file to write to.
- #
- # A path string. "-" means log to stdout.
- #
- # loglevel - The granularity of log output
- #
- # A string of "debug", "info", "warning", "error", "critical"
- #
- errorlog = '-'
- loglevel = 'info'
- accesslog = '-'
- access_log_format = '%(h)s %(l)s %(u)s %(t)s "%(r)s" %(s)s %(b)s "%(f)s" "%(a)s"'
- #
- # Process naming
- #
- # proc_name - A base to use with setproctitle to change the way
- # that Gunicorn processes are reported in the system process
- # table. This affects things like 'ps' and 'top'. If you're
- # going to be running more than one instance of Gunicorn you'll
- # probably want to set a name to tell them apart. This requires
- # that you install the setproctitle module.
- #
- # A string or None to choose a default of something like 'gunicorn'.
- #
- proc_name = None
- #
- # Server hooks
- #
- # post_fork - Called just after a worker has been forked.
- #
- # A callable that takes a server and worker instance
- # as arguments.
- #
- # pre_fork - Called just prior to forking the worker subprocess.
- #
- # A callable that accepts the same arguments as after_fork
- #
- # pre_exec - Called just prior to forking off a secondary
- # master process during things like config reloading.
- #
- # A callable that takes a server instance as the sole argument.
- #
- def post_fork(server, worker):
- server.log.info("Worker spawned (pid: %s)", worker.pid)
- def pre_fork(server, worker):
- pass
- def pre_exec(server):
- server.log.info("Forked child, re-executing.")
- def when_ready(server):
- server.log.info("Server is ready. Spawning workers")
- def worker_int(worker):
- worker.log.info("worker received INT or QUIT signal")
- ## get traceback info
- import threading, sys, traceback
- id2name = {th.ident: th.name for th in threading.enumerate()}
- code = []
- for threadId, stack in sys._current_frames().items():
- code.append("\n# Thread: %s(%d)" % (id2name.get(threadId, ""),
- threadId))
- for filename, lineno, name, line in traceback.extract_stack(stack):
- code.append('File: "%s", line %d, in %s' % (filename,
- lineno, name))
- if line:
- code.append(" %s" % (line.strip()))
- worker.log.debug("\n".join(code))
- def worker_abort(worker):
- worker.log.info("worker received SIGABRT signal")
|