ansible-nginx/README.md

1.9 KiB

Nginx for Debian Ansible role

Ansible Galaxy Build Status

Install and configure Nginx on Debian.

Features:

  • SSL/TLS "hardened" support
  • Manage basic auth on vhost / location
  • Proxy + Upstream
  • Fast PHP configuration
  • Preconfigured vhost templates (should work on many app)
  • Auto-configure HTTP2 on SSL/TLS vhosts

Requirements

None. If you set true to nginx_backports, you must install backports repository before lauching this role.

Role Variables

Packaging

  • nginx_apt_package: APT nginx package (try: apt-cache search ^nginx)
  • nginx_backports: Install nginx from backport repository (bool)

Shared

  • nginx_root: root directory where you want to have your files
  • nginx_log_dir: log directory (if you change it, don't forget to change logrotate config)
  • nginx_resolver: list of DNS resolver (default: OpenDNS)
  • nginx_error_log_level: default log level
  • nginx_auto_config_httpv2: boolean, auto configure HTTP2 where possible

Nginx Configuration

  • nginx_user
  • nginx_worker_processes
  • nginx_pid: daemon pid file
  • nginx_events_*: all variables in events block
  • nginx_http_*: all variables in http block
  • nginx_custom_http: instructions list (will put data in /etc/nginx/conf.d/custom.conf)

Fine configuration

Vhost configuration

PHP configuration

Upstream Configuration

SSL/TLS Configuration

Basic Auth

Dependencies

None

Example Playbook

See tests/test.yml.

License

GPLv2

Author Information