From 31a318d3868fb1f3c401120fdcda0f44b9884151 Mon Sep 17 00:00:00 2001
From: Felicity Tarnell <ft@le-fay.org>
Date: Fri, 1 May 2015 15:02:29 +0100
Subject: [PATCH] etc: add sample uwsgi and nginx configuration files

---
 etc/nginx.conf.sample | 52 +++++++++++++++++++++++
 etc/uwsgi.conf.sample | 98 +++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 150 insertions(+)
 create mode 100644 etc/nginx.conf.sample
 create mode 100644 etc/uwsgi.conf.sample

diff --git a/etc/nginx.conf.sample b/etc/nginx.conf.sample
new file mode 100644
index 0000000000..b784e2f481
--- /dev/null
+++ b/etc/nginx.conf.sample
@@ -0,0 +1,52 @@
+# vim:sw=4 ts=4 et:
+#
+# This is a sample nginx configuration for a Wagtail application running under
+# uWSGI.
+
+server {
+    # We don't set 'root' here, because we send location / to uWSGI, so
+    # nothing ends up at nginx's default handler.
+
+    listen 80;
+    server_name mywagtail.org;
+
+    error_log /var/log/nginx/mywagtail.org_error.log;
+    access_log /var/log/nginx/mywagtail.org_access.log;
+
+    # Maximum file upload size.
+    client_max_body_size 64M;
+
+    # Enable content compression for text types.
+    gzip on;
+    gzip_types text/plain text/css application/x-javascript image/svg+xml;
+    gzip_comp_level 1;
+    gzip_disable msie6;
+    gzip_http_version 1.0;
+    gzip_proxied any;
+    gzip_vary on;
+
+    location /static/ {
+        access_log off;
+        expires 3600;
+        alias /home/mywagtail/app/static/;
+    }
+
+    # Set a longer expiry for CACHE/, because the filenames are unique.
+    location /static/CACHE/ {
+        access_log off;
+        expires 864000;
+        alias /home/mywagtail/static/CACHE/;
+    }
+
+    # Only server /media/images by default, not e.g. original_images/.
+    location /media/images {
+        expires 864000;
+        alias /home/mywagtail/app/media/;
+    }
+
+    location / {
+        include uwsgi_params;
+        uwsgi_pass unix:/home/mywagtail/mywagtail.sock;
+        break;
+    }
+}
diff --git a/etc/uwsgi.conf.sample b/etc/uwsgi.conf.sample
new file mode 100644
index 0000000000..eee78490e1
--- /dev/null
+++ b/etc/uwsgi.conf.sample
@@ -0,0 +1,98 @@
+# vim:sw=4 ts=4 et:
+#
+# This is a sample uWSGI configuration file for running a Wagtail application.
+# It's designed to run under uWSGI's Emperor mode[0], but should work fine as
+# a standalone instance, e.g. under supervisord using 
+# 'uwsgi --ini /path/to/wagtail.ini'.
+#
+# This configuration assumes an application called 'mywagtail', running under
+# the 'mywagtail' user account, with the application deployed in
+# /home/mywagtail/app and the virtualenv in /home/mywagtail/venv.
+#
+# [0] http://uwsgi-docs.readthedocs.org/en/latest/Emperor.html
+
+[uwsgi]
+# Abort on unknown configuration options.
+strict              = true
+
+uid                 = mywagtail
+gid                 = mywagtail
+umask               = 022
+
+# Report memory usage to check for leaks; optional.
+memory-report       = true
+
+# Change these paths to where uWSGI is installed on your system.  If you've
+# installed uWSGI with pip, then you won't have any plugins, so plugin-dir
+# can be omitted.
+binary-path         = /opt/tbx/bin/uwsgi
+plugin-dir          = /opt/tbx/lib/uwsgi/plugins
+
+# Shut down worker processes when we exit.
+no-orphans          = true
+
+# Provide a statistics socket for uwsgitop; optional.
+stats               = /home/mywagtail/mywagtail.stats
+
+# Run in master mode.
+master              = true
+
+# Set this to the root directory of your project.
+chdir               = /home/mywagtail/app 
+# ... and its virtualenv.
+virtualenv          = /home/mywagtail/venv
+
+# Create a UNIX socket that the web server can access.  Replace 'www-data'
+# with the group (not the user) that your web server runs as.
+#
+# To use FastCGI instead of the uWSGI protocol, replace 'uwsgi-socket' with
+# 'fastcgi-socket'.
+uwsgi-socket        = /home/mywagtail/mywagtail.sock
+chmod-socket        = 660
+chown-socket        = mywagtail:www-data
+
+# The number of worker processes to create.
+workers             = 5
+
+# Create multiple threads per worker.  This is more memory-efficient if your
+# application is thread-safe.
+enable-threads      = true
+threads             = 5
+
+# Use cheaper to kill off idle workers.  This doesn't always work well; for
+# example, on Debian 7 with recently uWSGI versions it appears to sometimes
+# deadlock the application when killing a worker.  If this isn't specified,
+# uWSGI will just create the maximum number of workers at all times.
+cheaper-algo        = spare
+cheaper             = 1
+cheaper-initial     = 1
+cheaper-step        = 1
+
+# Application environment.
+env                 = PATH=/home/mywagtail/venv/bin:/bin:/sbin:/usr/bin:/usr/sbin:/usr/local/bin:/usr/local/sbin
+env                 = HOME=/home/mywagtail
+# Set $PYTHONPATH so that 'django-admin.py' worker without needing the
+# virtualenv active.
+env                 = PYTHONPATH=/home/mywagtail/app/mywagtail
+# Settings module.
+env                 = DJANGO_SETTINGS_MODULE=myapp.settings.production
+# WSGI application.  Wagtail includes this in the default template.
+module              = mywagtail.wsgi:application
+
+# You can run addational daemons along with the application; for example,
+# if you want to run Celery:
+attach-daemon       = celery worker -A myceleryapp -C -c1
+attach-daemon       = celery beat -A myceleryapp -C 
+
+# Log errors and requests.
+logto               = /var/log/uwsgi/mywagtail.log
+log-date            = true
+log-prefix          = [mywagtail]
+logfile-chown       = true
+
+# Enable thunder lock to prevent the thundering herd problem.
+thunder-lock        = true
+
+pcre-jit            = true
+close-on-exec       = true
+buffer-size         = 16384