Ansible role for installing NGINX
BUG FIXES:
ENHANCEMENTS:
Check NGINX
handler now always outputs an ok
state instead of changed
since it's a read-only operation with no traceable changes.BREAKING CHANGES:
nginx_modules
, instead of manually setting the modules you want to install to true
or false
. This change will also simplify adding future supported modules to this role. You can find a list of supported modules for NGINX and NGINX Plus in vars/main.yml
.nginx_config
role instead.nginx_configure
default value from true
to false
to further promote the adoption of the NGINX config role.FEATURES:
nginx_setup_license
-- Determine whether you want to use this role to upload your NGINX license to your target host.vars/main.yml
nginx_setup_license
, nginx_install
and nginx_check_support
.ENHANCEMENTS:
ansible_facts
wherever possible.nginx_repository
for NGINX Plus too.vars/main.yml
.2.9.13
and Ansible Lint to 4.3.5
.BUG FIXES:
2.6
or earlier versions of 2.7
.BREAKING CHANGES:
ENHANCEMENTS:
2.9.12
and Ansible Lint to 4.3.2
.mode
in relevant tasks.nginx
apt_repository
filename in Debian based distros.FEATURES:
BUG FIXES:
DEPRECATION WARNING:
With the advent of Ansible collections and to reduce the overhead of this role, the decision has been made to split this role into three smaller roles:
BREAKING CHANGES:
The Debian and Ubuntu repositories have slightly changed. You may run into some duplication issues when running the role on a preexisting target that already has had NGINX installed using the role. To fix this, manually remove the old repository source.
If you use custom_options
you will now need to manually end each directive with a semicolon.
The status
directive is no longer supported in NGINX Plus, and the stub_status
directive has been reworked into a template.
The listen directive structure in the stream
template has been updated to the listen directive structure found in the http
template. You can now specify multiple listen
directives in the same server
block as well as include any extra listen
options you might need.
Old configuration example
listen_address: localhost
listen_port: 80
udp_enable: false
New configuration example
listen:
listen_localhost:
ip: 0.0.0.0 # Wrap in square brackets for IPv6 addresses
port: 80
ssl: false
opts: [] # Listen opts like udp which will be added (ssl is automatically added if you specify 'ssl:').
The one major change is that instead of using udp_enable: true
you will now need to use opts: [udp]
if you wish to enable udp
.
FEATURES:
nginx_install
and nginx_configure
-- to let you choose whether you want to install NGINX, configure NGINX, or both.ENHANCEMENTS:
include_tasks
instead of import_tasks
when possible to speed up the role's execution time.*.conf
files in a given directory, or specify a list of files you wish to delete.stream
contexts.BUG FIXES:
nginx_debug_output
would sometimes fail if NGINX had not been automatically started by the system upon installation.http_demo_conf
was undefined the web server template interpolation would fail.This is a relatively minor release, but it includes a potential breaking change (hence the version bump). The one major new feature is the ability to install/build NGINX Open Source from source.
Features:
--diff
flagBug fixes:
apt update
to fail in amd64
systems when installing NGINX from an official repositoryBreaking changes:
Features:
Bug fixes:
Breaking changes:
README
or molecule/template_module/playbook.yml
for examples on how to use the new listen template.Features:
Bug fixes:
Features:
Bug fixes:
Bug fixes: