0.4.0

👾 Help make the NGINX config Ansible role better by participating in our survey! 👾

What's new in NGINX's config Ansible role 0.4.0!

This is a very big release which fundamentally refactors the whole NGINX configuration templating engine. Almost all of the templates have undergone some breaking changes. Please take extra caution when upgrading your environment to this release and make sure you test any required changes before using the role in any potential production environments.

Efforts have been made to thoroughly test all these changes and make sure they work as intended, but due to the magnitude of the refactoring work, there will be some bugs that have escaped our tests. If you find any, please open an issue or PR through the usual channels.

💣 Breaking Changes

• Refactor HTTP core module (#168) @alessfg
• Refactor HTTP upstream module (#85) @alessfg
• Refactor HTTP health check module (#152) @alessfg
• Refactor HTTP auth modules (#141) @alessfg
• Refactor HTTP SSL module (#121) @alessfg
• Refactor HTTP Proxy module (#87) @alessfg
• Refactor all minor modules (#151) @alessfg
• Refactor NGINX config uploads (#79) @alessfg
• Replace nested dictionaries with lists (#76) @alessfg

🚀 Features

• Add support for NAP DoS directives (#182, #153) @aknot242
• Support multiple simulataneous NGINX config uploads (#79) @alessfg

🎉 Enhancements

• Implement new NGINX Plus R25 JWT directives (#175) @alessfg
• Add support for NAP WAF 3.2 security log lists (#114) @aknot242
• Add reconnect_period_seconds for NAP WAF 3.5 (#162) @aknot242
• Remove unused nginx_config_debug_tasks variable (#156) @rhombl4
• Include alias location statement support (#142) @RaymondSchnyder
• Replace "yes"/"no" boolean values with "true"/"false" (#137) @alessfg
• Add server_names_hash_bucket_size directive (#116) @fschueller
• Make http settings access_log_format and keepalive_timeout optional (#100) @rolandjitsu
• Rename html_file_name to index and add index to server_block (#67) @kutysam
• Remove redundant forward slashes (#77) @brianclemens
• Replace nested dictionaries with lists (#76) @alessfg
• Fix package module in Molecule verification tests (#72) @alessfg

🐛 Bug Fixes

• Fix default template for nginx.conf (#148) @alessfg
• Make proxy_read_timeout a string instead of a boolean (#135) @alessfg
• Fix nginx_config_cleanup_paths not working as intended (#99) @alessfg
• Fix missing GRPC boolean check in GRPC template (#95) @alessfg
• Change directory to /etc/nginx before running NGINX config check (#81) @aknot242
• Fix package module in Molecule verification tests (#72) @alessfg

⬆️ Dependencies

• Bump Ansible collections (#184, # 170, #144, #138, #118, #112, #103) @alessfg
• Implement Release Drafter (#117) @alessfg
• Bump ansible-core from 2.11.1 to 2.11.6 in /.github/workflows/requirements (#181, #167, #159, #155, #149) @dependabot
• Replace Ansible base with Ansible core (#133) @alessfg
• Bump jinja2 from 2.11.3 to 3.0.2 in /.github/workflows/requirements (#173, #126, #124) @dependabot
• Add explicit Jinja2 requirement (#104) @alessfg
• Bump ansible-lint from 4.3.7 to 5.2.1 in /.github/workflows/requirements (#183, #172, #163, #154, #139, #130, #120, #109, #106, #102, #92) @dependabot
• Bump yamllint from 1.25.0 to 1.26.3 in /.github/workflows/requirements (#160, #157, #107, #68) @dependabot
• Bump molecule[docker] from 3.2.2 to 3.5.2 in /.github/workflows/requirements (#174, #169, #158, #140, #136, #128, #125, #101, #91, #69) @dependabot
• Bump docker from 4.4.1 to 5.0.3 in /.github/workflows/requirements (#177, #165, #108, #86 , #86, #78) @dependabot
• Bump actions/setup-python from 2 to 2.2.2 (#123) @dependabot
• Bump actions/checkout from 2 to 2.3.5 (#180, #122) @dependabot

Install & Upgrade

• To install the Ansible NGINX config role on a fresh environment, run ansible-galaxy install nginxinc.nginx_config.
• To upgrade the Ansible NGINX config role to the latest release, run ansible-galaxy install -f nginxinc.nginx_config.
• To install or upgrade to this specific Ansible NGINX config role release (0.4.0), run ansible-galaxy install -f nginxinc.nginx_config,v0.4.0.

Resources

• Functional configuration examples (check converge.yml under each molecule scenario) -- github.com/nginxinc/ansible-role-nginx-config/tree/0.4.0/molecule.
• Ansible Galaxy repository -- galaxy.ansible.com/nginxinc/nginx_config.
• NGINX Ansible role & collection introductory blog -- nginx.com/blog/announcing-nginx-core-collection-ansible.
• NGINX: Better with Ansible demo -- github.com/alessfg/nginx-ansible-demo.