mkubenka / ansible-role-nginx

Ansible role to install and manage nginx configuration

Ansible Role NGINX

Nginx (pronounced "engine x") is a web server. It can act as a reverse proxy server for TCP, UDP, HTTP, HTTPS, SMTP, POP3, and IMAP protocols, as well as a load balancer and an HTTP cache.

http://nginx.org/

Requirements

• if nginx_enable_geoip is enabled
  • geoip you can use the mkubenka.geoip role to install.

Role Variables

The variables that can be passed to this role and a brief description about them are as follows. (For all variables, take a look at defaults/main.yml)

# Sets the maximum allowed size of the client request body.
nginx_client_max_body_size: '2M'

# List of dynamic modules to load.
nginx_modules: 
  - ngx_http_modsecurity

# Defines trusted addresses that are known to send correct replacement addresses.
nginx_set_real_ip_from: '192.168.1.1'

# Defines the request header field whose value will be used to replace the client address.
nginx_real_ip_header: 'X-Real-IP'

# Enable nginx GeoIP support.
nginx_enable_geoip: yes

Dependencies

None

Example Playbook

- hosts: servers
  roles:
     - { role: mkubenka.nginx }

License

BSD

Author Information

Michal Kubenka [email protected]