Changeset - 7dbdb498f460
Parent rev.
Child rev.
[Not reviewed]
default
0 1 0
Mads Kiilerich - 6 years ago 2020-04-05 17:09:45
mads@kiilerich.com
uwsgi: slim down and tweak the default '[uwsgi]' configuration section

The goal is to have a basic working setup that show how and why to use uWSGI.
System administrators should check uWSGI documentation for further information
and general advice about operations.

Based on uWSGI documentation, experiments, and
https://www.techatbloomberg.com/blog/configuring-uwsgi-production-deployment/ .
1 file changed with 19 insertions and 54 deletions:
kallithea/lib/paster_commands/template.ini.mako
19
54
0 comments (0 inline, 0 general)
kallithea/lib/paster_commands/template.ini.mako
➞
Show inline comments
 
@@ -66,154 +66,119 @@ smtp_use_tls = false
 
[server:main]
 
host = ${host}
 
port = ${port}
 

			




	
	
	
		
 
%if http_server == 'gearbox':

			




	
	
	
		
 
<%text>## Gearbox default web server ##</%text>

			




	
	
	
		
 
use = egg:gearbox#wsgiref

			




	
	
	
		
 
<%text>## nr of worker threads to spawn</%text>

			




	
	
	
		
 
threadpool_workers = 1

			




	
	
	
		
 
<%text>## max request before thread respawn</%text>

			




	
	
	
		
 
threadpool_max_requests = 100

			




	
	
	
		
 
<%text>## option to use threads of process</%text>

			




	
	
	
		
 
use_threadpool = true

			




	
	
	
		
 

			




	
	
	
		
 
%elif http_server == 'gevent':

			




	
	
	
		
 
<%text>## Gearbox gevent web server ##</%text>

			




	
	
	
		
 
use = egg:gearbox#gevent

			




	
	
	
		
 

			




	
	
	
		
 
%elif http_server == 'waitress':

			




	
	
	
		
 
<%text>## WAITRESS ##</%text>

			




	
	
	
		
 
use = egg:waitress#main

			




	
	
	
		
 
<%text>## number of worker threads</%text>

			




	
	
	
		
 
threads = 1

			




	
	
	
		
 
<%text>## MAX BODY SIZE 100GB</%text>

			




	
	
	
		
 
max_request_body_size = 107374182400

			




	
	
	
		
 
<%text>## use poll instead of select, fixes fd limits, may not work on old</%text>

			




	
	
	
		
 
<%text>## windows systems.</%text>

			




	
	
	
		
 
#asyncore_use_poll = True

			




	
	
	
		
 

			




	
	
	
		
 
%elif http_server == 'gunicorn':

			




	
	
	
		
 
<%text>## GUNICORN ##</%text>

			




	
	
	
		
 
use = egg:gunicorn#main

			




	
	
	
		
 
<%text>## number of process workers. You must set `instance_id = *` when this option</%text>

			




	
	
	
		
 
<%text>## is set to more than one worker</%text>

			




	
	
	
		
 
workers = 4

			




	
	
	
		
 
<%text>## process name</%text>

			




	
	
	
		
 
proc_name = kallithea

			




	
	
	
		
 
<%text>## type of worker class, one of sync, eventlet, gevent, tornado</%text>

			




	
	
	
		
 
<%text>## recommended for bigger setup is using of of other than sync one</%text>

			




	
	
	
		
 
worker_class = sync

			




	
	
	
		
 
max_requests = 1000

			




	
	
	
		
 
<%text>## amount of time a worker can handle request before it gets killed and</%text>

			




	
	
	
		
 
<%text>## restarted</%text>

			




	
	
	
		
 
timeout = 3600

			




	
	
	
		
 

			




	
	
	
		
 
%endif

			




	
	
	
		
 
%else:

			




	
	
	
		
 
<%text>## UWSGI ##</%text>

			




	
	
	
		
 
<%text>## run with uwsgi --ini-paste-logged <inifile.ini></%text>

			




	
	
	
		
 
[uwsgi]

			




	
	
	
		
 
socket = /tmp/uwsgi.sock

			




	
	
	
		
 
master = true

			




	
	
	
		
 
http-socket = ${host}:${port}

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## set as daemon and redirect all output to file</%text>

			




	
	
	
		
 
#daemonize = ./uwsgi_kallithea.log

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## master process PID</%text>

			




	
	
	
		
 
pidfile = ./uwsgi_kallithea.pid

			




	
	
	
		
 
<%text>## Note: this section is parsed by the uWSGI .ini parser when run as:</%text>

			




	
	
	
		
 
<%text>## uwsgi --venv /srv/kallithea/venv --ini-paste-logged my.ini</%text>

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## stats server with workers statistics, use uwsgitop</%text>

			




	
	
	
		
 
<%text>## for monitoring, `uwsgitop 127.0.0.1:1717`</%text>

			




	
	
	
		
 
stats = 127.0.0.1:1717

			




	
	
	
		
 
memory-report = true

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## log 5XX errors</%text>

			




	
	
	
		
 
log-5xx = true

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## Set the socket listen queue size.</%text>

			




	
	
	
		
 
listen = 128

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## Gracefully Reload workers after the specified amount of managed requests</%text>

			




	
	
	
		
 
<%text>## (avoid memory leaks).</%text>

			




	
	
	
		
 
max-requests = 1000

			




	
	
	
		
 
# HTTP Basics:

			




	
	
	
		
 
http-socket = ${host}:${port}

			




	
	
	
		
 
buffer-size = 65535                    ; Mercurial will use huge GET headers for discovery

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## enable large buffers</%text>

			




	
	
	
		
 
buffer-size = 65535

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## socket and http timeouts ##</%text>

			




	
	
	
		
 
http-timeout = 3600

			




	
	
	
		
 
socket-timeout = 3600

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## Log requests slower than the specified number of milliseconds.</%text>

			




	
	
	
		
 
log-slow = 10

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## Exit if no app can be loaded.</%text>

			




	
	
	
		
 
need-app = true

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## Set lazy mode (load apps in workers instead of master).</%text>

			




	
	
	
		
 
lazy = true

			




	
	
	
		
 
# Scaling:

			




	
	
	
		
 
master = true                          ; Use separate master and worker processes

			




	
	
	
		
 
auto-procname = true                   ; Name worker processes accordingly

			




	
	
	
		
 
lazy = true                            ; App *must* be loaded in workers - db connections can't be shared

			




	
	
	
		
 
workers = 4                            ; On demand scaling up to this many worker processes

			




	
	
	
		
 
cheaper = 1                            ; Initial and on demand scaling down to this many worker processes

			




	
	
	
		
 
max-requests = 1000                    ; Graceful reload of worker processes to avoid leaks

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## scaling ##</%text>

			




	
	
	
		
 
<%text>## set cheaper algorithm to use, if not set default will be used</%text>

			




	
	
	
		
 
cheaper-algo = spare

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## minimum number of workers to keep at all times</%text>

			




	
	
	
		
 
cheaper = 1

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## number of workers to spawn at startup</%text>

			




	
	
	
		
 
cheaper-initial = 1

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## maximum number of workers that can be spawned</%text>

			




	
	
	
		
 
workers = 4

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## how many workers should be spawned at a time</%text>

			




	
	
	
		
 
cheaper-step = 1

			




	
	
	
		
 
# Tweak defaults:

			




	
	
	
		
 
strict = true                          ; Fail on unknown config directives

			




	
	
	
		
 
enable-threads = true                  ; Enable Python threads (not threaded workers)

			




	
	
	
		
 
vacuum = true                          ; Delete sockets during shutdown

			




	
	
	
		
 
single-interpreter = true

			




	
	
	
		
 
die-on-term = true                     ; Shutdown when receiving SIGTERM (default is respawn)

			




	
	
	
		
 
need-app = true                        ; Exit early if no app can be loaded.

			




	
	
	
		
 

			




	
	
	
		
 
%endif

			




	
	
	
		
 
<%text>## middleware for hosting the WSGI application under a URL prefix</%text>

			




	
	
	
		
 
#[filter:proxy-prefix]

			




	
	
	
		
 
#use = egg:PasteDeploy#prefix

			




	
	
	
		
 
#prefix = /<your-prefix>

			




	
	
	
		
 

			




	
	
	
		
 
[app:main]

			




	
	
	
		
 
use = egg:kallithea

			




	
	
	
		
 
<%text>## enable proxy prefix middleware</%text>

			




	
	
	
		
 
#filter-with = proxy-prefix

			




	
	
	
		
 

			




	
	
	
		
 
full_stack = true

			




	
	
	
		
 
static_files = true

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## Internationalization (see setup documentation for details)</%text>

			




	
	
	
		
 
<%text>## By default, the languages requested by the browser are used if available, with English as default.</%text>

			




	
	
	
		
 
<%text>## Set i18n.enabled=false to disable automatic language choice.</%text>

			




	
	
	
		
 
#i18n.enabled = true

			




	
	
	
		
 
<%text>## To Force a language, set i18n.enabled=false and specify the language in i18n.lang.</%text>

			




	
	
	
		
 
<%text>## Valid values are the names of subdirectories in kallithea/i18n with a LC_MESSAGES/kallithea.mo</%text>

			




	
	
	
		
 
#i18n.lang = en

			




	
	
	
		
 

			




	
	
	
		
 
cache_dir = %(here)s/data

			




	
	
	
		
 
index_dir = %(here)s/data/index

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## uncomment and set this path to use archive download cache</%text>

			




	
	
	
		
 
archive_cache_dir = %(here)s/tarballcache

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## change this to unique ID for security</%text>

			




	
	
	
		
 
app_instance_uuid = ${uuid()}

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## cut off limit for large diffs (size in bytes)</%text>

			




	
	
	
		
 
cut_off_limit = 256000

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## force https in Kallithea, fixes https redirects, assumes it's always https</%text>

			




	
	
	
		
 
force_https = false

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## use Strict-Transport-Security headers</%text>

			




	
	
	
		
 
use_htsts = false

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## number of commits stats will parse on each iteration</%text>

			




	
	
	
		
 
commit_parse_limit = 25

			




	
	
	
		
 

			




	
	
	
		
 
<%text>## Path to Python executable to be used for git hooks.</%text>

			




	
	
	
		
 
<%text>## This value will be written inside the git hook scripts as the text</%text>

			




	
	
	
		
 
<%text>## after '#!' (shebang). When empty or not defined, the value of</%text>

			




	
	
	
		
 
<%text>## 'sys.executable' at the time of installation of the git hooks is</%text>

			




        

    



    


    



    



      

      





    
    0 comments (0 inline, 0 general)
    





    


  

  







  


    




    








    
        
    
    
        This site is powered by
            Kallithea 0.7.0,
        which is
        © 2010–2025 by various authors & licensed under GPLv3.