mirror of
https://github.com/frappe/gunicorn.git
synced 2026-01-14 11:09:11 +08:00
119 lines
4.7 KiB
HTML
119 lines
4.7 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="en">
|
|
<head>
|
|
<meta charset="utf-8" />
|
|
<title>Green Unicorn - The Configuration File</title>
|
|
<link rel="alternate" type="application/rss+xml" href="/feed.xml" />
|
|
|
|
<!--[if IE]>
|
|
<script>
|
|
document.createElement('section');
|
|
document.createElement('article');
|
|
document.createElement('aside');
|
|
document.createElement('footer');
|
|
document.createElement('header');
|
|
document.createElement('nav');
|
|
document.createElement('time');
|
|
</script>
|
|
|
|
<![endif]-->
|
|
|
|
<link rel="stylesheet" href="css/style.css" type="text/css" media="screen">
|
|
</head>
|
|
<body>
|
|
<div class="container">
|
|
<div id="header">
|
|
|
|
<h1 class="logo"><a href="http://gunicorn.org">gunicorn</a></h1>
|
|
|
|
<div id="links">
|
|
get the source in
|
|
<a href="http://github.com/benoitc/gunicorn">git</a> then
|
|
<a href="http://github.com/benoitc/gunicorn/issues">send feedback</a>
|
|
</div>
|
|
</div>
|
|
|
|
|
|
<div id="menu">
|
|
<ul id="actions">
|
|
<li><a href="installation.html">Installation</a></li>
|
|
<li><a href="usage.html">Usage</a></li>
|
|
<li><a href="deployment.html">Deployment</a></li>
|
|
<li><a href="configuration.html">Configuration</a></li>
|
|
<li><a href="tuning.html">Tuning</a></li>
|
|
<li><a href="faq.html">FAQ</a></li>
|
|
<li><a href="news.html">News</a></li>
|
|
</ul>
|
|
</div>
|
|
|
|
<div class="document" id="the-configuration-file">
|
|
<h1 class="title">The Configuration File</h1>
|
|
<p>Gunciorn 0.5 introduced the ability to use a Python configuration file. Gunicorn will look for <tt class="docutils literal">gunicorn.conf.py</tt> in the current working directory or what ever path is specified on the command line with the <tt class="docutils literal"><span class="pre">-c</span></tt> option.</p>
|
|
<div class="section" id="example-gunicorn-conf-py">
|
|
<h1>Example gunicorn.conf.py</h1>
|
|
<pre class="literal-block">
|
|
bind = "127.0.0.1:8000" # Or "unix:/tmp/gunicorn.sock"
|
|
daemon = False # Whether work in the background
|
|
debug = False # Some extra logging
|
|
logfile = "-" # Name of the log file
|
|
loglevel = "info" # The level at which to log
|
|
pidfile = None # Path to a PID file
|
|
workers = 1 # Number of workers to initialize
|
|
umask = 0 # Umask to set when daemonizing
|
|
user = None # Change process owner to user
|
|
group = None # Change process group to group
|
|
|
|
def after_fork(server, worker):
|
|
fmt = "worker=%s spawned pid=%s"
|
|
server.log.info(fmt % (worker.id, worker.pid))
|
|
|
|
def before_fork(server, worker):
|
|
fmt = "worker=%s spawning"
|
|
server.log.info(fmt % worker.id)
|
|
|
|
def before_exec(server):
|
|
serer.log.info("Forked child, reexecuting.")
|
|
</pre>
|
|
</div>
|
|
<div class="section" id="parameter-descriptions">
|
|
<h1>Parameter Descriptions</h1>
|
|
<dl class="docutils">
|
|
<dt>after_fork(server, worker):</dt>
|
|
<dd>This is called by the worker after initialization.</dd>
|
|
<dt>before_fork(server, worker):</dt>
|
|
<dd>This is called by the worker just before forking.</dd>
|
|
<dt>before_exec(server):</dt>
|
|
<dd>This function is called before relaunching the master. This happens when the master receives a HUP or USR2 signal.</dd>
|
|
<dt>bind:</dt>
|
|
<dd>The address on which workers are listening. It can be a TCP address with a format of <tt class="docutils literal">IP:PORT</tt> or a Unix socket address like <tt class="docutils literal"><span class="pre">unix:/path/to/socketfile</span></tt>.</dd>
|
|
<dt>daemon:</dt>
|
|
<dd>Whether or not to detach the server from the controlling terminal.</dd>
|
|
<dt>debug:</dt>
|
|
<dd>If <tt class="docutils literal">True</tt>, only one worker will be launch and the variable <tt class="docutils literal">wsgi.multiprocess</tt> will be set to False.</dd>
|
|
<dt>group:</dt>
|
|
<dd>The group in which worker processes will be launched.</dd>
|
|
<dt>logfile:</dt>
|
|
<dd>The path to the log file <tt class="docutils literal">-</tt> (stdout) by default.</dd>
|
|
<dt>loglevel:</dt>
|
|
<dd>The level at which to log. <tt class="docutils literal">info</tt>, <tt class="docutils literal">debug</tt>, or <tt class="docutils literal">error</tt> for instance. Only log messages of equal or greater severity are logged.</dd>
|
|
<dt>pidfile:</dt>
|
|
<dd>A file to store the master's PID.</dd>
|
|
<dt>umask:</dt>
|
|
<dd>Used to set the umask when daemonizing.</dd>
|
|
<dt>user:</dt>
|
|
<dd>The user as which worker processes will by launched.</dd>
|
|
</dl>
|
|
</div>
|
|
</div>
|
|
|
|
|
|
|
|
|
|
|
|
<div id="footer">
|
|
<p>This work is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by/3.0/">Creative Commons Attribution 3.0 Unported License</a>.</p>
|
|
<p>Hosted on <a href="http://github.com/">Github</a></p>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html> |