2019-12-06 22:37:16 +01:00
|
|
|
---
|
2020-07-13 18:05:03 +02:00
|
|
|
# Enable NGINX options -- `nginx_install` and `nginx_configure`.
|
2019-12-06 22:37:16 +01:00
|
|
|
# Default is true.
|
|
|
|
nginx_enable: true
|
|
|
|
|
2020-07-13 18:05:03 +02:00
|
|
|
# Install NGINX and NGINX modules.
|
|
|
|
# Variables for these options can be found below.
|
|
|
|
# Default is true.
|
|
|
|
nginx_install: true
|
|
|
|
|
2019-12-06 22:37:16 +01:00
|
|
|
# Start NGINX service.
|
|
|
|
# Default is true.
|
|
|
|
nginx_start: true
|
|
|
|
|
|
|
|
# Print NGINX configuration file to terminal after executing playbook.
|
|
|
|
nginx_debug_output: false
|
|
|
|
|
|
|
|
# Specify which type of NGINX you want to install.
|
|
|
|
# Options are 'opensource' or 'plus'.
|
|
|
|
# Default is 'opensource'.
|
|
|
|
nginx_type: opensource
|
|
|
|
|
2020-09-20 12:15:28 +02:00
|
|
|
# (Optional) Specify which version of NGINX you want to install.
|
|
|
|
# Default is to install the latest release.
|
2020-04-18 00:40:35 +02:00
|
|
|
# nginx_version: "=19-1~bionic"
|
2020-09-15 21:27:06 +02:00
|
|
|
# For NGINX Plus and modules you'll need a wilcard like below (which installs plus-20 and modules)
|
2020-04-18 00:40:35 +02:00
|
|
|
# nginx_version: "-20*"
|
2019-12-06 22:37:16 +01:00
|
|
|
|
2019-12-11 21:45:12 +01:00
|
|
|
# Specify whether you want to maintain your version of NGINX, upgrade to the latest version, or remove NGINX.
|
2020-07-13 18:05:03 +02:00
|
|
|
# Can be used with `nginx_version` to fine tune control on which version of NGINX is installed/used on each playbook execution.
|
2019-12-07 01:48:15 +01:00
|
|
|
# Using 'present' will install the latest version (or 'nginx_version') of NGINX on a fresh install.
|
|
|
|
# Using 'latest' will upgrade NGINX to the latest version (that matches your 'nginx_version') of NGINX on every playbook execution.
|
2019-12-11 21:45:12 +01:00
|
|
|
# Using 'absent' will remove NGINX from your system.
|
2019-12-07 01:48:15 +01:00
|
|
|
# Default is present.
|
|
|
|
nginx_state: present
|
|
|
|
|
2021-06-14 16:57:18 +02:00
|
|
|
# Specify whether or not you want to manage the NGINX repositories.
|
|
|
|
# Using 'true' will manage NGINX repositories.
|
|
|
|
# Using 'false' will not manage the NGINX repositories, allowing them to be managed through other means.
|
|
|
|
# Default is true
|
|
|
|
nginx_manage_repo: true
|
|
|
|
|
2019-12-06 22:37:16 +01:00
|
|
|
# Specify repository origin for NGINX Open Source.
|
2020-03-25 18:43:32 +01:00
|
|
|
# Options are 'nginx_repository', 'source' or 'os_repository'.
|
2019-12-06 22:37:16 +01:00
|
|
|
# Only works if 'nginx_type' is set to 'opensource'.
|
|
|
|
# Default is nginx_repository.
|
|
|
|
nginx_install_from: nginx_repository
|
|
|
|
|
2021-06-14 13:13:58 +02:00
|
|
|
# Specify whether or not you want this role to install the epel-release package.
|
|
|
|
# Using 'true' will install epel-release if other criteria are met.
|
|
|
|
# Using 'false' will not install epel-release.
|
|
|
|
# Default is true.
|
|
|
|
nginx_install_epel_release: true
|
|
|
|
|
2020-03-25 18:43:32 +01:00
|
|
|
# Specify source install options for NGINX Open Source.
|
2020-07-13 18:05:03 +02:00
|
|
|
# Options represent whether to install from source also or to install from packages (default).
|
|
|
|
# These only apply if 'nginx_install_from' is set to 'source'.
|
|
|
|
# For the tools, true means we will install from a package and false means install from source.
|
|
|
|
# 'nginx_install_source_build_tools' will install compiler and build tools from packages.
|
|
|
|
# If false, you need to have these present.
|
2020-03-25 18:43:32 +01:00
|
|
|
nginx_install_source_build_tools: true
|
|
|
|
nginx_install_source_pcre: false
|
|
|
|
nginx_install_source_openssl: true
|
|
|
|
nginx_install_source_zlib: false
|
|
|
|
|
2020-09-20 12:15:28 +02:00
|
|
|
# (Optional) Choose where to fetch the NGINX signing key from.
|
2019-12-06 22:37:16 +01:00
|
|
|
# Default is the official NGINX signing key host.
|
|
|
|
# nginx_signing_key: http://nginx.org/keys/nginx_signing.key
|
|
|
|
|
2020-09-20 12:15:28 +02:00
|
|
|
# (Optional) Specify repository for NGINX Open Source or NGINX Plus.
|
2020-09-15 21:27:06 +02:00
|
|
|
# Only works if 'install_from' is set to 'nginx_repository' when installing NGINX Open Source.
|
2019-12-06 22:37:16 +01:00
|
|
|
# Defaults are the official NGINX repositories.
|
2020-09-15 21:27:06 +02:00
|
|
|
# nginx_repository: deb [arch=amd64] https://nginx.org/packages/mainline/debian/ buster nginx
|
2019-12-06 22:37:16 +01:00
|
|
|
|
|
|
|
# Specify which branch of NGINX Open Source you want to install.
|
|
|
|
# Options are 'mainline' or 'stable'.
|
2020-03-25 18:43:32 +01:00
|
|
|
# Only works if 'install_from' is set to 'nginx_repository' or 'source'.
|
2019-12-06 22:37:16 +01:00
|
|
|
# Default is mainline.
|
|
|
|
nginx_branch: mainline
|
|
|
|
|
|
|
|
# Location of your NGINX Plus license in your local machine.
|
|
|
|
# Default is the files folder within the NGINX Ansible role.
|
|
|
|
nginx_license:
|
|
|
|
certificate: license/nginx-repo.crt
|
|
|
|
key: license/nginx-repo.key
|
|
|
|
|
2020-09-15 21:27:06 +02:00
|
|
|
# Set up NGINX Plus license before installation.
|
|
|
|
# Default is true.
|
|
|
|
nginx_setup_license: true
|
|
|
|
|
2019-12-11 21:45:12 +01:00
|
|
|
# Remove NGINX Plus license and repository after installation for security purposes.
|
2020-09-20 12:15:28 +02:00
|
|
|
# Default is true.
|
|
|
|
nginx_remove_license: true
|
2019-12-06 22:37:16 +01:00
|
|
|
|
2020-09-08 00:44:54 +02:00
|
|
|
# Install NGINX Modules.
|
|
|
|
# You can select any of the modules listed below. Beware of NGINX Plus only modules (these are marked).
|
2020-11-12 13:29:20 +01:00
|
|
|
# Format is list with either the module name or a dictionary (see njs for an example).
|
|
|
|
# When using a dictionary, the default value for state is present, and for version it's nginx_version if specified.
|
|
|
|
# Default is an empty list (no modules are installed).
|
2020-09-08 00:44:54 +02:00
|
|
|
nginx_modules: []
|
|
|
|
# - auth-spnego # NGINX Plus
|
|
|
|
# - brotli # NGINX Plus
|
|
|
|
# - cookie-flag # NGINX Plus
|
|
|
|
# - encrypted-session # NGINX Plus
|
|
|
|
# - geoip
|
|
|
|
# - geoip2 # NGINX Plus
|
|
|
|
# - headers-more # NGINX Plus
|
|
|
|
# - image-filter
|
|
|
|
# - lua # NGINX Plus
|
2020-11-12 13:29:20 +01:00
|
|
|
# - name: njs # Required
|
|
|
|
# state: present # Optional
|
|
|
|
# version: =1.19.4+0.4.4-1~bionic # Optional
|
2020-09-08 00:44:54 +02:00
|
|
|
# - opentracing # NGINX Plus
|
|
|
|
# - passenger # NGINX Plus
|
|
|
|
# - perl # NGINX Plus
|
|
|
|
# - prometheus # NGINX Plus
|
|
|
|
# - rtmp
|
|
|
|
# - subs-filter # NGINX Plus
|
|
|
|
# - waf # NGINX Plus
|
|
|
|
# - xslt
|