This document includes a curated changelog for each release. We also publish a changelog as the description of a GitHub release, which, by contrast, is auto-generated and includes links to all PRs that went into the release.
April 24, 2023
This release brings:
- Extensive validation of Gateway API resources for robustness, security and correctness. See the validation doc for more details.
- Defined open-source development process for NGINX Kubernetes Gateway project. See the Issue lifecycle doc.
- Miscellaneous enhancements and bug fixes.
FEATURES:
- Report proper Conditions in status of HTTPRoute and Gateway when GatewayClass is invalid or doesn't exist. PR-576
- Implement NKG-specific field validation for GatewayClasses. PR-295
- Implement NKG-specific field validation for HTTPRoutes. PR-455
- Implement NKG-specific field validation for Gateways. PR-407
- Run webhook validation rules inside NKG control plane. PR-388
- Make NGINX error log visible in NGINX container logs. PR-319
- Always generate a root "/" location block in NGINX config to handle unmatched requests with 404 response. PR-356
BUG FIXES:
- Fix HTTPRoute section name related bugs. PR-568
- Fix Observed Generation for Gateway Status. PR-351
- Fix status for parentRef with invalid listener in HTTPRoute. PR-350
- Fix initContainer failure during pod restart. PR-337. Thanks to Tom Plant
- Generate default http server in NGINX if http listener exists in Gateway. PR-320
DEPENDENCIES:
- Bump sigs.k8s.io/gateway-api from 0.6.0 to 0.6.2. PR-471
COMPATIBILITY:
- The Gateway API version:
0.6.2 - NGINX version:
1.21.x* - Kubernetes version:
1.21+
*the installation manifests use the nginx:1.21 image, which always points to the latest version of 1.21.x releases.
CONTAINER IMAGES:
- Control plane:
ghcr.io/nginxinc/nginx-kubernetes-gateway:0.3.0
October 25, 2022
This release extends the support of the features of the Gateway API resources.
FEATURES:
- Support the Pod IPs instead of the virtual IP of a Service in the NGINX upstream. Additionally, NGINX Kubernetes Gateway will pick up any changes to the Pod IPs and update the NGINX upstream accordingly. PR-221
- Support the redirect filter in an HTTPRoute rule. PR-218
- Support weights in backendRefs in the HTTPRoute (traffic splitting). PR-261
- Support the ObservedGeneration field in the HTTPRoute status. PR-254
BUG FIXES:
- Do not require the namespace in the
--gateway-ctlr-namecli argument. PR-235 - Ensure NGINX Kubernetes Gateway exits gracefully during shutdown. PR-250
- Handle query param names in case-sensitive way. PR-220
DEPENDENCIES:
COMPATIBILITY:
- The Gateway API version:
0.5.1 - NGINX version:
1.21.x* - Kubernetes version:
1.21+
*the installation manifests use the nginx:1.21 image, which always points to the latest version of 1.21.x releases.
CONTAINER IMAGES:
- Control plane:
ghcr.io/nginxinc/nginx-kubernetes-gateway:0.2.0
August 22, 2022
This is an initial release of NGINX Kubernetes Gateway project.
The release includes:
- A control plane agent (a Kubernetes controller) that updates date plane (NGINX) configuration based on the state of the resources in the cluster.
- Support for NGINX as a data plane.
- Kubernetes manifests for a Deployment with a single Pod with the control plane and data plane containers as well as Services to enable external connectivity to that Pod.
- Support for a subset of features of GatewayClass, Gateway and HTTPRoute resources (see the Gateway API Compatibility doc).
We expect that the architecture of NGINX Kubernetes Gateway -- the number of pods and containers and their interaction -- will change as the project evolves.
NGINX Kubernetes Gateway is ready for experimental usage. We included the docs as well as examples.
If you'd like to give us feedback or get involved, see the README to learn how.
COMPATIBILITY:
- The Gateway API version:
0.5.0 - NGINX version:
1.21.3 - Kubernetes version:
1.19+
CONTAINER IMAGES:
- Control plane:
ghcr.io/nginxinc/nginx-kubernetes-gateway:0.1.0