vitalk / ansible-nginx-proxy

Ansible recipe to configure a nginx as proxy server

Nginx proxy

Ansible recipe to configure a Nginx as proxy server. This recipe does not trying to cover all available Nginx options and just use the best practices to configure Nginx as proxy server.

Role Variables

Option	Description
nginx_enabled	Enable nginx service on boot.
nginx_state	State of nginx service.
nginx_app_config	The path to nginx application config.
app_name	The name of the application, uses to create application configuration, e.g. should be a shorthand, lowercase and not contain any whitespaces.

This options are optional and bound to the application config. Feel free to define your own variables based on your configuration.

Option	Description
app_ip	The internal ip address of the web application.
app_port	The port used by application.
app_fqdn	Fully qualified domain name of the application. Non-www version.

Usage example

If the existing configuration does not satisfy your needs write your own.

upstream backend {
    server backend1.example.com       weight=5;
    server backend2.example.com:8080;
    server unix:/tmp/backend3;
}

server {
    location / {
        proxy_pass http://backend;
    }
}

Put it somewhere with your playbooks, for example into roles/nginx-proxy/templates/myapp.j2 and point to it via nginx_app_config variable.

Note about relative import

Ansible imports paths relative to the playbook you play, so this layout...

$ tree
.
├── playbook.yml
└── roles
    └── nginx-proxy
        └── templates
            └── myapp.j2

...corresponds to this option

nginx_app_config: roles/nginx-proxy/templates/myapp.j2

License

Licensed under the MIT license.

Self-Promotion

Created by Vital Kudzelka.

Open a GitHub issue if you have any suggestions or found a bug.