2.17.0 release notes
July 10, 2024
NGINX Instance Manager 2.17.0 release notes
NGINX Instance Manager 2.17.0 supports upgrades from these previous versions:
- 2.14.0 - 2.16.0
If your NGINX Instance Manager version is older, you may need to upgrade to an intermediate version before upgrading to the target version.
This release includes the following updates:
-
Adds support for F5 WAF for NGINX v5
NGINX Instance Manager 2.17.0 adds support for F5 WAF for NGINX v5..
F5 WAF for NGINX v5 (designed for both NGINX Open Source and NGINX Plus environments) consists of a dynamic NGINX module and containerized WAF services, providing robust security and scalability.
-
Hosted Docker images for Kubernetes Helm charts
Prior to this release, users had to download NGINX Instance Manager docker images and push them to their local container registry for use in the Kubernetes Helm charts. This was not very turnkey and required multiple steps before being able to use the Helm charts. Now all Instance Manager container images are available from F5’s public docker repository, simplifying the installation in Kubernetes.
See the Deploy Instance Manager on Kubernetes documentation for more information.
-
Ansible role to deploy NGINX Instance Manager
This release comes with an Ansible role to help you Install NGINX Instance Manager quickly, while also encouraging the best practices for your chosen environment.
-
NGINX Instance Manager IaC using Packer and Terraform
This release improves the Infrastructure as Code (IaC) project to help you quickly get started with NGINX Instance Manager using Packer and Terraform.
The project uses Packer to create images and Terraform to deploy these images to your preferred cloud provider, including GCP, Azure, or vSphere.
-
Single docker image with all the NGINX Instance Manager services and dependencies
This release includes access to a single Docker image for running NGINX Instance Manager as a container. This allows customers to deploy Instance Manager locally with a single "docker run" command. For more details, see Deploy NGINX Instance Manager in a Single Docker Container.
This release has the following changes in default behavior:
-
NGINX Instance Manager now collects and sends anonymized telemetry and interaction information for analysis by F5 NGINX. This information is used to improve our products and services.
Customers have the option to opt out of data collection by disabling the feature in the Instance Manager web interface, using the Account menu in the top-right corner of the screen. For more details, see Configure Telemetry and Web Analytics.
-
Augment Template order now matches NGINX configuration structure
When you generate a configuration using augment templates, the order shown in the UI now matches the structure of an NGINX configuration. This makes filling out a template more intuitive.
-
End of support for CentOS 7 and Red Hat Enterprise Linux 7
CentOS 7 and Red Hat Enterprise Linux 7 reached end of maintenance support on June 30, 2024.
Since these operating systems won’t get any more updates or security patches, NGINX Instance Manager no longer supports them.
Please upgrade your environment to one of the supported distributions to continue using NGINX Instance Manager.
This release fixes the following issues. Use your browser’s search function to find the issue ID in the page.
- Users receive login error when NGINX Management Suite is deployed in Kubernetes (44686)
- REST API does not work until you log into the web interface first (44877)
- Editing template submissions uses the latest versions, may cause "malformed" errors (44961)
- Editing template submissions now allows for using most recent template version (44971)
You can find information about known issues in the Known Issues topic.