A role to install nginx and configure 0 or more sites' doc roots and nginx config files.

For ubuntu systems, it is possible to install the PPA rather than the standard package-managed version. This can be done by specifying install_ppa: True in the playbook. To specify a version of nginx to install, use the nginx_version variable. The default is 1.8.0-1+trusty1.

An example might be:

nginx_sites:
  - name: testsite
    template: site.j2
    files:
    - name: up.json
      content: '{ "status": "happy" }'    

With a site.j2 such as:

server {
  listen 81;
  server_name {{item.name}};
  access_log /var/log/nginx/81.log;
  location /404 {
    return 404;
  }
  location ~ ^/up/?$ {
    root /var/www/{{item.name}};
    rewrite ^.*$ /up.json break;
  }
  location / {
    return 204;
  }
}

A docroot '/var/www/testsite' will be created holding up.json with the specified content. The config in site.j2 will be used for the site. There is a stub config in roles/nginx/templates/ that can be used, but it's unliekly to support the exact configuration you need, which is why using an external template is supported.