You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: CHANGELOG.md
+38Lines changed: 38 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,6 +4,44 @@ This document includes a curated changelog for each release. We also publish a c
4
4
a [GitHub release](https://github.com/nginx/nginx-gateway-fabric/releases), which, by contrast, is auto-generated
5
5
and includes links to all PRs that went into the release.
6
6
7
+
## Release 2.2.0
8
+
9
+
_October 21, 2025_
10
+
11
+
FEATURES:
12
+
13
+
- Add first class OpenShift support, including UBI based images and an Operator. [4001](https://github.com/nginx/nginx-gateway-fabric/pull/4001)
14
+
- Add regex for path matching. [3874](https://github.com/nginx/nginx-gateway-fabric/pull/3874). Thanks to [fabian4](https://github.com/fabian4)
15
+
- Add support for Inference Extension. [4091](https://github.com/nginx/nginx-gateway-fabric/pull/4091)
16
+
- Support ExternalName Services. [3759](https://github.com/nginx/nginx-gateway-fabric/pull/3759)
17
+
- Add support for Gateway addresses field. [3896](https://github.com/nginx/nginx-gateway-fabric/pull/3896)
18
+
- Add support for Port in ParentReference. [3778](https://github.com/nginx/nginx-gateway-fabric/pull/3778)
19
+
20
+
BUG FIXES:
21
+
22
+
- Handle duplicate kinds in listener allowed kinds. [3810](https://github.com/nginx/nginx-gateway-fabric/pull/3810)
23
+
- Align with BackendTLSPolicy validation. [3871](https://github.com/nginx/nginx-gateway-fabric/pull/3871)
24
+
25
+
HELM CHART:
26
+
27
+
- The version of the Helm chart is now 2.2.0
28
+
- Set NGINX Plus default image. [3919](https://github.com/nginx/nginx-gateway-fabric/pull/3919)
29
+
30
+
COMPATIBILITY:
31
+
32
+
- Gateway API version: `1.3.0`
33
+
- NGINX version: `1.29.2`
34
+
- NGINX Plus version: `R35`
35
+
- NGINX Agent version: `v3.3.2`
36
+
- Kubernetes version: `1.25+`
37
+
38
+
CONTAINER IMAGES:
39
+
40
+
- Control plane: `ghcr.io/nginx/nginx-gateway-fabric:2.2.0`
41
+
- Data plane: `ghcr.io/nginx/nginx-gateway-fabric/nginx:2.2.0`
42
+
- Data plane with NGINX Plus: `private-registry.nginx.com/nginx-gateway-fabric/nginx-plus:2.2.0`
| Latest release | For production use |[Manifests](https://github.com/nginx/nginx-gateway-fabric/tree/v2.1.4/deploy). |[Documentation](https://docs.nginx.com/nginx-gateway-fabric). [Examples](https://github.com/nginx/nginx-gateway-fabric/tree/v2.1.4/examples). |
50
+
| Latest release | For production use |[Manifests](https://github.com/nginx/nginx-gateway-fabric/tree/v2.2.0/deploy). |[Documentation](https://docs.nginx.com/nginx-gateway-fabric). [Examples](https://github.com/nginx/nginx-gateway-fabric/tree/v2.2.0/examples). |
51
51
| Edge | For experimental use and latest features |[Manifests](https://github.com/nginx/nginx-gateway-fabric/tree/main/deploy). |[Examples](https://github.com/nginx/nginx-gateway-fabric/tree/main/examples). |
52
52
53
53
### Versioning
@@ -69,6 +69,7 @@ The following table lists the software versions NGINX Gateway Fabric supports.
69
69
| NGINX Gateway Fabric | Gateway API | Kubernetes | NGINX OSS | NGINX Plus | NGINX Agent |
@@ -207,7 +207,7 @@ The following table lists the configurable parameters of the NGINX Gateway Fabri
207
207
|`certGenerator.ttlSecondsAfterFinished`| How long to wait after the cert generator job has finished before it is removed by the job controller. | int |`30`|
208
208
|`clusterDomain`| The DNS cluster domain of your Kubernetes cluster. | string |`"cluster.local"`|
209
209
|`gateways`| A list of Gateway objects. View https://gateway-api.sigs.k8s.io/reference/spec/#gateway for full Gateway reference. | list |`[]`|
210
-
|`nginx`| The nginx section contains the configuration for all NGINX data plane deployments installed by the NGINX Gateway Fabric control plane. | object |`{"autoscaling":{"enable":false},"config":{},"container":{"hostPorts":[],"lifecycle":{},"readinessProbe":{},"resources":{},"volumeMounts":[]},"debug":false,"image":{"pullPolicy":"Always","repository":"ghcr.io/nginx/nginx-gateway-fabric/nginx","tag":"edge"},"imagePullSecret":"","imagePullSecrets":[],"kind":"deployment","nginxOneConsole":{"dataplaneKeySecretName":"","endpointHost":"agent.connect.nginx.com","endpointPort":443,"skipVerify":false},"patches":[],"plus":false,"pod":{},"replicas":1,"service":{"externalTrafficPolicy":"Local","loadBalancerClass":"","loadBalancerIP":"","loadBalancerSourceRanges":[],"nodePorts":[],"patches":[],"type":"LoadBalancer"},"usage":{"caSecretName":"","clientSSLSecretName":"","endpoint":"","enforceInitialReport":true,"resolver":"","secretName":"nplus-license","skipVerify":false}}`|
210
+
|`nginx`| The nginx section contains the configuration for all NGINX data plane deployments installed by the NGINX Gateway Fabric control plane. | object |`{"autoscaling":{"enable":false},"config":{},"container":{"hostPorts":[],"lifecycle":{},"readinessProbe":{},"resources":{},"volumeMounts":[]},"debug":false,"image":{"pullPolicy":"IfNotPresent","repository":"ghcr.io/nginx/nginx-gateway-fabric/nginx","tag":"2.2.0"},"imagePullSecret":"","imagePullSecrets":[],"kind":"deployment","nginxOneConsole":{"dataplaneKeySecretName":"","endpointHost":"agent.connect.nginx.com","endpointPort":443,"skipVerify":false},"patches":[],"plus":false,"pod":{},"replicas":1,"service":{"externalTrafficPolicy":"Local","loadBalancerClass":"","loadBalancerIP":"","loadBalancerSourceRanges":[],"nodePorts":[],"patches":[],"type":"LoadBalancer"},"usage":{"caSecretName":"","clientSSLSecretName":"","endpoint":"","enforceInitialReport":true,"resolver":"","secretName":"nplus-license","skipVerify":false}}`|
211
211
|`nginx.autoscaling`| Autoscaling configuration for the NGINX data plane. | object |`{"enable":false}`|
212
212
|`nginx.autoscaling.enable`| Enable or disable Horizontal Pod Autoscaler for the NGINX data plane. | bool |`false`|
213
213
|`nginx.config`| The configuration for the data plane that is contained in the NginxProxy resource. This is applied globally to all Gateways managed by this instance of NGINX Gateway Fabric. | object |`{}`|
@@ -245,7 +245,7 @@ The following table lists the configurable parameters of the NGINX Gateway Fabri
245
245
|`nginx.usage.resolver`| The nameserver used to resolve the NGINX Plus usage reporting endpoint. Used with NGINX Instance Manager. | string |`""`|
246
246
|`nginx.usage.secretName`| The name of the Secret containing the JWT for NGINX Plus usage reporting. Must exist in the same namespace that the NGINX Gateway Fabric control plane is running in (default namespace: nginx-gateway). | string |`"nplus-license"`|
247
247
|`nginx.usage.skipVerify`| Disable client verification of the NGINX Plus usage reporting server certificate. | bool |`false`|
248
-
| `nginxGateway` | The nginxGateway section contains configuration for the NGINX Gateway Fabric control plane deployment. | object | `{"affinity":{},"autoscaling":{"enable":false},"config":{"logging":{"level":"info"}},"configAnnotations":{},"extraVolumeMounts":[],"extraVolumes":[],"gatewayClassAnnotations":{},"gatewayClassName":"nginx","gatewayControllerName":"gateway.nginx.org/nginx-gateway-controller","gwAPIExperimentalFeatures":{"enable":false},"gwAPIInferenceExtension":{"enable":false},"image":{"pullPolicy":"Always","repository":"ghcr.io/nginx/nginx-gateway-fabric","tag":"edge"},"kind":"deployment","labels":{},"leaderElection":{"enable":true,"lockName":""},"lifecycle":{},"metrics":{"enable":true,"port":9113,"secure":false},"name":"","nodeSelector":{},"podAnnotations":{},"productTelemetry":{"enable":true},"readinessProbe":{"enable":true,"initialDelaySeconds":3,"port":8081},"replicas":1,"resources":{},"service":{"annotations":{},"labels":{}},"serviceAccount":{"annotations":{},"imagePullSecret":"","imagePullSecrets":[],"name":""},"snippetsFilters":{"enable":false},"terminationGracePeriodSeconds":30,"tolerations":[],"topologySpreadConstraints":[]}` |
248
+
| `nginxGateway` | The nginxGateway section contains configuration for the NGINX Gateway Fabric control plane deployment. | object | `{"affinity":{},"autoscaling":{"enable":false},"config":{"logging":{"level":"info"}},"configAnnotations":{},"extraVolumeMounts":[],"extraVolumes":[],"gatewayClassAnnotations":{},"gatewayClassName":"nginx","gatewayControllerName":"gateway.nginx.org/nginx-gateway-controller","gwAPIExperimentalFeatures":{"enable":false},"gwAPIInferenceExtension":{"enable":false},"image":{"pullPolicy":"IfNotPresent","repository":"ghcr.io/nginx/nginx-gateway-fabric","tag":"2.2.0"},"kind":"deployment","labels":{},"leaderElection":{"enable":true,"lockName":""},"lifecycle":{},"metrics":{"enable":true,"port":9113,"secure":false},"name":"","nodeSelector":{},"podAnnotations":{},"productTelemetry":{"enable":true},"readinessProbe":{"enable":true,"initialDelaySeconds":3,"port":8081},"replicas":1,"resources":{},"service":{"annotations":{},"labels":{}},"serviceAccount":{"annotations":{},"imagePullSecret":"","imagePullSecrets":[],"name":""},"snippetsFilters":{"enable":false},"terminationGracePeriodSeconds":30,"tolerations":[],"topologySpreadConstraints":[]}` |
249
249
|`nginxGateway.affinity`| The affinity of the NGINX Gateway Fabric control plane pod. | object |`{}`|
250
250
|`nginxGateway.autoscaling`| Autoscaling configuration for the NGINX Gateway Fabric control plane. | object |`{"enable":false}`|
251
251
|`nginxGateway.autoscaling.enable`| Enable or disable Horizontal Pod Autoscaler for the control plane. | bool |`false`|
@@ -258,7 +258,7 @@ The following table lists the configurable parameters of the NGINX Gateway Fabri
258
258
|`nginxGateway.gatewayControllerName`| The name of the Gateway controller. The controller name must be of the form: DOMAIN/PATH. The controller's domain is gateway.nginx.org. | string |`"gateway.nginx.org/nginx-gateway-controller"`|
259
259
|`nginxGateway.gwAPIExperimentalFeatures.enable`| Enable the experimental features of Gateway API which are supported by NGINX Gateway Fabric. Requires the Gateway APIs installed from the experimental channel. | bool |`false`|
260
260
|`nginxGateway.gwAPIInferenceExtension.enable`| Enable Gateway API Inference Extension support. Allows for configuring InferencePools to route traffic to AI workloads. | bool |`false`|
261
-
|`nginxGateway.image`| The image configuration for the NGINX Gateway Fabric control plane. | object |`{"pullPolicy":"Always","repository":"ghcr.io/nginx/nginx-gateway-fabric","tag":"edge"}`|
261
+
|`nginxGateway.image`| The image configuration for the NGINX Gateway Fabric control plane. | object |`{"pullPolicy":"IfNotPresent","repository":"ghcr.io/nginx/nginx-gateway-fabric","tag":"2.2.0"}`|
262
262
|`nginxGateway.image.repository`| The NGINX Gateway Fabric image to use | string |`"ghcr.io/nginx/nginx-gateway-fabric"`|
263
263
|`nginxGateway.kind`| The kind of the NGINX Gateway Fabric installation - currently, only deployment is supported. | string |`"deployment"`|
264
264
|`nginxGateway.labels`| Set of labels to be added for NGINX Gateway Fabric deployment. | object |`{}`|
0 commit comments