Fix #16: Properly configure mod_wsgi

Author: Wtower

README.md

@@ -40,12 +40,24 @@ Optional Configuration variables
 - `conf.name`: The application name (machine name), the same as the Python app. Default: `{{ project }}`
 - `conf.python_version`: The python version to install (major.minor), default: `3.5`.
 - `conf.virtualenv_dir`: Virtualenvs home directory, default to vars' respective option.
-- `conf.wsgi_script`: The wsgi script, default: `index.wsgi`.
 - `conf.compile_msgs`: Set to `true` in order to compile i18n messages.
 - `conf.memcached`: Set to `true` in order to clear cache.
-- `conf.data`: A list of the dump files to load data from, eg `[project, auth]`, omit to skip loaddata. Depends on `loaddata` variable to be `true`.
-- `conf.https_only`: If true then configure Apache 
-  [only for SSL](https://github.com/Wtower/ansible-node-deploy/issues/6). Default: `false`.
+- `conf.data`: A list of the dump files to load data from, eg `[project, auth]`, omit to skip loaddata. 
+  Depends on `loaddata` variable to be `true`.
+
+[WSGI](http://modwsgi.readthedocs.io/en/develop/configuration-directives/WSGIDaemonProcess.html)
+
+- `conf.wsgi_script`: The wsgi script, default: `index.wsgi`.
+- `conf.wsgi_threads`: If set mod_wsgi runs in daemon mode (**recommended** 3-25).
+
+The following are used only for daemon mode:
+
+- `conf.wsgi_processes`: If set mod_wsgi runs in multi-process mode (integer).
+- `conf.wsgi_inactivity_timeout`: Set only for small traffic sites to reset process and reclaim memory (eg. 300).
+- `conf.wsgi_restart_interval`: Set to let process restart after n seconds. Useful if process memory grows large.
+- `conf.wsgi_max_requests`: Similar to the above.
+- `conf.wsgi_graceful_timeout`: If any of the above two are set, the number of seconds to expect no requests to restart.
+- `conf.wsgi_queue_timeout`: If large request queues, drop requests after that many seconds.
 
 Other default variables
 -----------------------
@@ -163,7 +175,11 @@ Task description
 
     Reset target directory ownership to the appropriate Plesk permissions.
 
-24. Configure Apache
+24. Touch WSGI script
+
+    Update the timestamp. If WSGI daemon mode it causes restart of the process at next request.
+
+25. Configure Apache
 
    Configure Apache to execute the wsgi script using the provided template file.
    Only executes if a `domain_name` is provided.

examples/django_sites.yml

@@ -8,6 +8,9 @@ django_sites:
     dev_path: ~/workspace/python/project
     host_path: /var/www/vhosts/mysite.com/myproject.com
     host_user: username
+    wsgi_script: ninedev/wsgi_mod.py
+    wsgi_threads: 3
+    wsgi_inactivity_timeout: 300
     python_version: 3.4
     memcached: true
     https_only: true

tasks/main.yml

@@ -122,16 +122,21 @@
     state: directory
   become: true
 
+- name: Update WSGI module timestamp
+  file:
+    name: "{{ conf.host_path }}/{{ conf.wsgi_script|default('index.wsgi') }}"
+    state: touch
+
 - name: Configure Apache
   template: src="vhost.conf.j2" dest="/var/www/vhosts/{{ conf.domain_name }}/conf/vhost.conf" backup=yes
   become: true
-  when: conf.domain_name is defined and (conf.https_only is not defined or not conf.https_only)
+  when: conf.domain_name is defined
   notify:
     - Reconfigure Plesk domain
     - Restart Apache
 
 - name: Configure Apache SSL
-  template: src="vhost.conf.j2" dest="/var/www/vhosts/{{ conf.domain_name }}/conf/vhost_ssl.conf" backup=yes
+  template: src="vhost_ssl.conf.j2" dest="/var/www/vhosts/{{ conf.domain_name }}/conf/vhost_ssl.conf" backup=yes
   become: true
   when: conf.domain_name is defined
   notify:

templates/vhost.conf.j2

@@ -1,6 +1,17 @@
 # {{ ansible_managed }}
 
-WSGIScriptAlias / {{ conf.host_path }}/{{ conf.wsgi_script| default('index.wsgi') }}
+{% if conf.wsgi_threads is defined %}
+WSGIDaemonProcess {{ conf.domain_name }} display-name=django-{{ project }} threads={{ conf.wsgi_threads }}
+    {%- if conf.wsgi_processes is defined %} processes={{ conf.wsgi_processes }}{% endif -%}
+    {%- if conf.wsgi_inactivity_timeout is defined %} inactivity-timeout={{ conf.wsgi_inactivity_timeout }}{% endif -%}
+    {%- if conf.wsgi_restart_interval is defined %} restart-interval={{ conf.wsgi_restart_interval }}{% endif -%}
+    {%- if conf.wsgi_max_requests is defined %} maximum-requests={{ conf.wsgi_max_requests }}{% endif -%}
+    {%- if conf.wsgi_graceful_timeout is defined %} graceful-timeout={{ conf.wsgi_graceful_timeout }}{% endif -%}
+    {%- if conf.wsgi_queue_timeout is defined %} queue-timeout={{ conf.wsgi_queue_timeout }}{% endif %}
+
+WSGIProcessGroup {{ conf.domain_name }}
+{% endif %}
+WSGIScriptAlias / {{ conf.host_path }}/{{ conf.wsgi_script|default('index.wsgi') }}
 
 Alias /static/ {{ conf.host_path }}/static/
 <Location "/static/">

templates/vhost_ssl.conf.j2

@@ -0,0 +1,16 @@
+# {{ ansible_managed }}
+
+{% if conf.wsgi_threads is defined %}
+WSGIProcessGroup {{ conf.domain_name }}
+{% endif %}
+WSGIScriptAlias / {{ conf.host_path }}/{{ conf.wsgi_script|default('index.wsgi') }}
+
+Alias /static/ {{ conf.host_path }}/static/
+<Location "/static/">
+    Options -Indexes
+</Location>
+
+Alias /media/ {{ conf.host_path }}/media/
+<Location "/media/">
+    Options -Indexes
+</Location>