birdhousebuilder.recipe.nginx 0.2.5

Supported options

This recipe supports the following options:

anaconda-home

Buildout option with the root folder of the Anaconda installation. Default: $HOME/anaconda. The default location can also be set with the environment variable ANACONDA_HOME. Example:

export ANACONDA_HOME=/opt/anaconda

Search priority is:

1. anaconda-home in buildout.cfg

2. $ANACONDA_HOME

3. $HOME/anaconda

input

The path to a Mako template with a Nginx configuration for your application.

sites

The name of your application.

worker_processes

The number of worker processes started (use auto for dynamic value). Default: 1

keepalive_timeout

Timeout during keep-alive client connection will stay open on the server side. Default: 5s

organization

The organization name for the certificate. Default: Birdhouse

organization_unit

The organization unit for the certificate. Default: Demo

All additional options can be used as parameters in your Nginx site configuration. The anaconda-home Path is available as prefix parameter.

Example usage

The following example buildout.cfg installs Nginx with a site configuration for myapp:

[buildout]
parts = myapp_nginx

anaconda-home = /home/myself/anaconda

[myapp_nginx]
recipe = birdhousebuilder.recipe.nginx
input = ${buildout:directory}/templates/myapp_nginx.conf
sites = myapp

hostname =  localhost
port = 8081

An example Mako template for your Nginx configuration could look like this:

upstream myapp {
  server unix:///tmp/myapp.socket fail_timeout=0;
}

server {
  listen ${port};
  server_name ${hostname};

  root ${prefix}/var/www;
  index index.html index.htm;

  location / {
    # checks for static file, if not found proxy to app
    try_files $uri @proxy_to_phoenix;
  }

  location @proxy_to_phoenix {
      proxy_pass http://myapp;
  }
}

0.2.5 (2016-01-19)

• set keepalive_timeout to 5s (can be overwritten in options).

0.2.4 (2016-01-15)

• disabled sendfile in nginx.conf.

• worker_processes is now configurable.

0.2.3 (2015-07-06)

• create cert.pem only if it does not exist.

0.2.2 (2015-06-25)

• cleaned up templates.

• added user option.

0.2.1 (2015-06-23)

• generates self-signed certificate for https.

0.2.0 (2015-02-24)

• installing in conda enviroment birdhouse.

• using $ANACONDA_HOME environment variable.

• separation of anaconda-home and installation prefix.

0.1.7 (2014-12-06)

• Don’t update conda on buildout update.

0.1.6 (2014-11-11)

• Removed proxy configuration.

• Fixed supervisor config: nginx didn’t stop.

• nginx is started as supervisor service.

0.1.5 (2014-10-27)

• disabled SSLv3 (poodle attack)

0.1.4 (2014-10-21)

• Updated docs.

• Fixed pyOpenSSL dependency.

0.1.3 (2014-08-26)

• Fixed proxy config for wpsoutputs.

• Using proxy-enabled buildout option.

• options master and superuser_enabled added.

0.1.2 (2014-08-01)

• Updated documentation.

0.1.1 (2014-07-24)

• Added start-stop script for nginx.

• Generates self-signed certificate for https.

0.1.0 (2014-07-10)

Initial Release.