ansible-role-nginx/CHANGELOG.md

# Changelog

## 0.15.0 (Unreleased)

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.

FEATURES:

*   Add support to configure logrotate
*   Add support for Ubuntu Focal
*   Add support to configure SELinux
*   Two new variables have been introduced -- `nginx_install` and `nginx_configure` -- to let you choose whether you want to install NGINX, configure NGINX, or both

ENHANCEMENTS:

*   The role now uses `include_tasks` instead of `import_tasks` when possible to speed up the role's execution time
*   Improve configuration templating capabilities:
    *   Add support for unix upstreams
    *   Add PID templating option
    *   Add support for down parameter in upstreams
    *   Add option for custom error pages

BUG FIXES:

*   `nginx_debug_output` would sometimes fail if the NGINX had not been automatically started by the system upon installation
*   If `http_demo_conf` was undefined the web server template interpolation would fail

## 0.14.0 (April 22, 2020)

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.

BREAKING CHANGES:

*   The NGINX Controller agent can no longer be installed using this role. Please use the Ansible collection linked in the README.

FEATURES:

*   Install/build NGINX from source options now available
*   Implement NGINX http sub module templating
*   NGINX config is now correctly validated each run
*   SSL Private Key data is hidden when running the role with the --diff flag

BUG FIXES:

*   The role should no longer sporadically cause apt update to fail in amd64 systems when installing NGINX from an official repository
*   Modules should now correctly install when using a specific NGINX Plus version

## 0.13.0 (December 13, 2019)

BREAKING CHANGES:

*   The new listen templating options are not backwards with the previous listen templating options. Check the `README` or `molecule/template_module/playbook.yml` for examples on how to use the new listen template.
*   BSD and Linux NGINX installation tasks have undergone some major changes. As such, you may have to update your playbooks accordingly.

FEATURES:

*   Improve NGINX http templating:
    *   Multiple server support in HTTP contexts
    *   Header support
    *   OCSP stapling
    *   Improved proxy settings
    *   Logging settings
    *   Improved SSL settings
    *   Improved authentication settings
    *   Max body size support
    *   Improved listen templating
*   Switch to Molecule for testing
*   Add support for Debian Buster
*   Support for specifying which version of NGINX to install
*   Split default variables into multiple functional files
*   Improve support for Alpine distributions
*   Support for updating or removing NGINX from your system
*   Implemented tags to support running specific tasks instead of the whole role

BUG FIXES:

*   Module installation when using NGINX Plus has been fixed
*   Websockets templating has been reenabled after being accidentally deleted
*   When deleting your NGINX Plus license from the system, the NGINX Plus repository will also be deleted to prevent issues further down the line if you run a repository update since there will not be a license anymore to authenticate into the NGINX Plus repository.

## 0.12.0 (May 22, 2019)

FEATURES:

*   Improve NGINX http templating - following parameters are now supported:
    *   Websockets
    *   Basic authentication
    *   Proxy cache
    *   Proxy redirect
    *   Proxy timeouts
    *   SSL
    *   Root (in server context)
    *   Add basic NGINX stream templating
    *   Add support for RHEL 8 and Alpine Linux

BUG FIXES:

*   Fix module installation tasks

## 0.11.0 (Januray 14, 2019)

FEATURES:

*   Allow setting a custom apt and rpm signing key host
*   Add support for enabling an http to https redirects
*   Add ansible_managed to templates
*   Rename html_app_name to web_server_name
*   Rename load_balancer block to reverse_proxy
*   Allow setting the listen port when using SSL
*   Improve SSL defaults
*   Allow setting http or https server locations in proxy_pass

BUG FIXES:

*   Ignore undefined values for autoindex and health check
*   Clarify that the redirect variable refers to a http to https redirect

## 0.10.1 (November 26, 2018)

BUG FIXES:

*   Fix HTML template to use correct variable name

## 0.10.0 (November 26, 2018)

FEATURES:

*   Improve templating support for health checks, multiple location blocks, and auto indexing

BUG FIXES:

*   Fetching the NGINX signing key is now more reliable
*   Fixed HTML templating

## 0.9.0 (October 18, 2018)

FEATURES:

*   Refactor NGINX templating and file uploading
*   Add ability to upload and template HTML files
*   Add ability to upload SSL keys and certificates

## 0.8.0 (September 17, 2018)

FEATURES:

*   Add ability to install NGINX Plus Controller agent
*   Refactor installation of NGINX Amplify agent
*   Rename variables to be prefixed with `nginx_`

BUG FIXES:

*   Correct spelling of name in `tasks/prerequisites/setup-debian.yml`

## 0.7.1 (August 21, 2018)

FEATURES:

*   Add enabled parameter to NGINX and NGINX Unit handlers

## 0.7.0 (August 4, 2018)

FEATURES:

*   Add Amazon Linux 2 support for NGINX Plus
*   Add ability to delete NGINX Plus license after installation

BUG FIXES:

*   GeoIP module can now be properly installed
*   Module installation will no longer fail if only one module is specified

## 0.6.0 (July 19, 2018)

FEATURES:

*   Improve NGINX Unit related documentation
*   Add FreeBSD and Amazon Linux 2 support for NGINX Unit
*   Allow users to install NGINX Unit without having to also install NGINX

## 0.5.0 (June 28, 2018)

FEATURES:

*   Add support for NGINX Unit

## 0.4.0 (May 25, 2018)

FEATURES:

*   Implement support for FreeBSD
*   Allow users to select the default NGINX repository

## 0.3.0 (April 19, 2018)

FEATURES:

*   Improve Travis CI testing strategy

BUG FIXES:

*   Fix templating and push tasks

## 0.2.0 (April 12, 2018)

FEATURES:

*   Add support for all first party NGINX modules

BUG FIXES:

*   Role should now work correctly in distros with old versions of Python
*   Rest API configuration will now only be created when rest_api_enable is set to true (an empty file would be created in previous versions if rest_api_enable was set to false)
*   Uploading/dynamically generating files should now result in the files being uploaded/created to/in the correct directory

## 0.1.0 - Initial release (Januray 26, 2018)

Initial release of the NGINX Ansible role. Features include:

*   Install NGINX Open Source or NGINX Plus.
*   Choose between stable or mainline NGINX Open Source.
*   Install NGINX Amplify.
*   Install NGINX Javascript, Perl, and ModSecurity WAF NGINX modules.
*   Enable the NGINX Plus REST API and dashboard.
*   Upload NGINX configuration files.
*   Templated NGINX configuration system.