Skip to content

Commit da050bc

Browse files
salonichf5salonichf5
authored
Release 2.1.2 docs (#3963)
Release 2.1.2
1 parent 936fc8e commit da050bc

File tree

15 files changed

+193
-159
lines changed

15 files changed

+193
-159
lines changed

‎CHANGELOG.md‎

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,39 @@ This document includes a curated changelog for each release. We also publish a c
44
a [GitHub release](https://github.com/nginx/nginx-gateway-fabric/releases), which, by contrast, is auto-generated
55
and includes links to all PRs that went into the release.
66

7+
## Release 2.1.2
8+
9+
_September 25, 2025_
10+
11+
BUG FIXES:
12+
13+
- Fixes a bug where the subscribe method was incorrectly intercepting initial configuration operations after a ServiceAccountToken rotation and signaling broadcast completion. [3905](https://github.com/nginx/nginx-gateway-fabric/pull/3905)
14+
- Fixes an issue where a failed configuration reload caused all HTTPRoutes to be marked as invalid (Accepted: false). This led to external-dns removing DNS records even though the configuration had been rolled back. Routes now retain their valid state during reload failures, preventing unnecessary DNS disruptions. [3936](https://github.com/nginx/nginx-gateway-fabric/pull/3936)
15+
- Adds NGINX image version validation during agent connections to prevent newer config being sent to pods running previous image versions during upgrades. [3928](https://github.com/nginx/nginx-gateway-fabric/pull/3928)
16+
17+
NGINX AGENT BUG FIXES:
18+
19+
- The NGINX Agent v3.3.1 update fixes connection reset issues during config apply by reusing existing connections, adds rollback on failures, and improves logging for more reliable configuration updates. [1261](https://github.com/nginx/agent/pull/1261)
20+
21+
HELM CHART:
22+
23+
- The version of the Helm chart is now 2.1.2
24+
25+
COMPATIBILITY:
26+
27+
- Gateway API version: `1.3.0`
28+
- NGINX version: `1.29.1`
29+
- NGINX Plus version: `R35`
30+
- NGINX Agent version: `v3.3.1`
31+
- Kubernetes version: `1.25+`
32+
33+
CONTAINER IMAGES:
34+
35+
- Control plane: `ghcr.io/nginx/nginx-gateway-fabric:2.1.2`
36+
- Data plane: `ghcr.io/nginx/nginx-gateway-fabric/nginx:2.1.2`
37+
- Data plane with NGINX Plus: `private-registry.nginx.com/nginx-gateway-fabric/nginx-plus:2.1.2`
38+
39+
740
## Release 2.1.1
841

942
_September 3, 2025_

‎README.md‎

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,7 @@ You can find the comprehensive NGINX Gateway Fabric user documentation on the [N
3636
We publish NGINX Gateway Fabric releases on GitHub. See
3737
our [releases page](https://github.com/nginx/nginx-gateway-fabric/releases).
3838

39-
The latest release is [2.1.1](https://github.com/nginx/nginx-gateway-fabric/releases/tag/v2.1.1).
39+
The latest release is [2.1.2](https://github.com/nginx/nginx-gateway-fabric/releases/tag/v2.1.2).
4040

4141
The edge version is useful for experimenting with new features that are not yet published in a release. To use, choose
4242
the _edge_ version built from the [latest commit](https://github.com/nginx/nginx-gateway-fabric/commits/main)
@@ -47,7 +47,7 @@ to the correct versions:
4747

4848
| Version | Description | Installation Manifests | Documentation and Examples |
4949
|----------------|------------------------------------------|--------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------|
50-
| Latest release | For production use | [Manifests](https://github.com/nginx/nginx-gateway-fabric/tree/v2.1.1/deploy). | [Documentation](https://docs.nginx.com/nginx-gateway-fabric). [Examples](https://github.com/nginx/nginx-gateway-fabric/tree/v2.1.1/examples). |
50+
| Latest release | For production use | [Manifests](https://github.com/nginx/nginx-gateway-fabric/tree/v2.1.2/deploy). | [Documentation](https://docs.nginx.com/nginx-gateway-fabric). [Examples](https://github.com/nginx/nginx-gateway-fabric/tree/v2.1.2/examples). |
5151
| 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). |
5252

5353
### Versioning
@@ -69,6 +69,7 @@ The following table lists the software versions NGINX Gateway Fabric supports.
6969
| NGINX Gateway Fabric | Gateway API | Kubernetes | NGINX OSS | NGINX Plus | NGINX Agent |
7070
|----------------------|-------------|------------|-----------|------------|-------------|
7171
| Edge | 1.3.0 | 1.25+ | 1.29.1 | R35 | v3.3.1 |
72+
| 2.1.2 | 1.3.0 | 1.25+ | 1.29.1 | R35 | v3.3.1 |
7273
| 2.1.1 | 1.3.0 | 1.25+ | 1.29.1 | R35 | v3.2.1 |
7374
| 2.1.0 | 1.3.0 | 1.25+ | 1.29.1 | R35 | v3.2.1 |
7475
| 2.0.2 | 1.3.0 | 1.25+ | 1.28.0 | R34 | v3.0.1 |

‎charts/nginx-gateway-fabric/Chart.yaml‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,8 @@ apiVersion: v2
22
name: nginx-gateway-fabric
33
description: NGINX Gateway Fabric
44
type: application
5-
version: 2.1.1
6-
appVersion: "2.1.1"
5+
version: 2.1.2
6+
appVersion: "2.1.2"
77
kubeVersion: ">= 1.25.0-0"
88
home: https://github.com/nginx/nginx-gateway-fabric
99
icon: https://raw.githubusercontent.com/nginx/nginx-gateway-fabric/main/charts/nginx-gateway-fabric/chart-icon.png

‎charts/nginx-gateway-fabric/README.md‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11

22
# NGINX Gateway Fabric Helm Chart
33

4-
![Version: 2.1.1](https://img.shields.io/badge/Version-2.1.1-informational?style=flat-square) ![AppVersion: 2.1.1](https://img.shields.io/badge/AppVersion-2.1.1-informational?style=flat-square)
4+
![Version: 2.1.2](https://img.shields.io/badge/Version-2.1.2-informational?style=flat-square) ![AppVersion: 2.1.2](https://img.shields.io/badge/AppVersion-2.1.2-informational?style=flat-square)
55

66
- [NGINX Gateway Fabric Helm Chart](#nginx-gateway-fabric-helm-chart)
77
- [Introduction](#introduction)
@@ -264,7 +264,7 @@ The following table lists the configurable parameters of the NGINX Gateway Fabri
264264
| `certGenerator.ttlSecondsAfterFinished` | How long to wait after the cert generator job has finished before it is removed by the job controller. | int | `30` |
265265
| `clusterDomain` | The DNS cluster domain of your Kubernetes cluster. | string | `"cluster.local"` |
266266
| `gateways` | A list of Gateway objects. View https://gateway-api.sigs.k8s.io/reference/spec/#gateway for full Gateway reference. | list | `[]` |
267-
| `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.1.1"},"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":"","resolver":"","secretName":"nplus-license","skipVerify":false}}` |
267+
| `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.1.2"},"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":"","resolver":"","secretName":"nplus-license","skipVerify":false}}` |
268268
| `nginx.autoscaling` | Autoscaling configuration for the NGINX data plane. | object | `{"enable":false}` |
269269
| `nginx.autoscaling.enable` | Enable or disable Horizontal Pod Autoscaler for the NGINX data plane. | bool | `false` |
270270
| `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 | `{}` |
@@ -301,7 +301,7 @@ The following table lists the configurable parameters of the NGINX Gateway Fabri
301301
| `nginx.usage.resolver` | The nameserver used to resolve the NGINX Plus usage reporting endpoint. Used with NGINX Instance Manager. | string | `""` |
302302
| `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"` |
303303
| `nginx.usage.skipVerify` | Disable client verification of the NGINX Plus usage reporting server certificate. | bool | `false` |
304-
| `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},"image":{"pullPolicy":"IfNotPresent","repository":"ghcr.io/nginx/nginx-gateway-fabric","tag":"2.1.1"},"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":[]}` |
304+
| `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},"image":{"pullPolicy":"IfNotPresent","repository":"ghcr.io/nginx/nginx-gateway-fabric","tag":"2.1.2"},"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":[]}` |
305305
| `nginxGateway.affinity` | The affinity of the NGINX Gateway Fabric control plane pod. | object | `{}` |
306306
| `nginxGateway.autoscaling` | Autoscaling configuration for the NGINX Gateway Fabric control plane. | object | `{"enable":false}` |
307307
| `nginxGateway.autoscaling.enable` | Enable or disable Horizontal Pod Autoscaler for the control plane. | bool | `false` |
@@ -313,7 +313,7 @@ The following table lists the configurable parameters of the NGINX Gateway Fabri
313313
| `nginxGateway.gatewayClassName` | The name of the GatewayClass that will be created as part of this release. Every NGINX Gateway Fabric must have a unique corresponding GatewayClass resource. NGINX Gateway Fabric only processes resources that belong to its class - i.e. have the "gatewayClassName" field resource equal to the class. | string | `"nginx"` |
314314
| `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"` |
315315
| `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` |
316-
| `nginxGateway.image` | The image configuration for the NGINX Gateway Fabric control plane. | object | `{"pullPolicy":"IfNotPresent","repository":"ghcr.io/nginx/nginx-gateway-fabric","tag":"2.1.1"}` |
316+
| `nginxGateway.image` | The image configuration for the NGINX Gateway Fabric control plane. | object | `{"pullPolicy":"IfNotPresent","repository":"ghcr.io/nginx/nginx-gateway-fabric","tag":"2.1.2"}` |
317317
| `nginxGateway.image.repository` | The NGINX Gateway Fabric image to use | string | `"ghcr.io/nginx/nginx-gateway-fabric"` |
318318
| `nginxGateway.kind` | The kind of the NGINX Gateway Fabric installation - currently, only deployment is supported. | string | `"deployment"` |
319319
| `nginxGateway.labels` | Set of labels to be added for NGINX Gateway Fabric deployment. | object | `{}` |

‎charts/nginx-gateway-fabric/values.schema.json‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -424,7 +424,7 @@
424424
"type": "string"
425425
},
426426
"tag": {
427-
"default": "2.1.1",
427+
"default": "2.1.2",
428428
"required": [],
429429
"title": "tag",
430430
"type": "string"
@@ -796,7 +796,7 @@
796796
"type": "string"
797797
},
798798
"tag": {
799-
"default": "2.1.1",
799+
"default": "2.1.2",
800800
"required": [],
801801
"title": "tag",
802802
"type": "string"

‎charts/nginx-gateway-fabric/values.yaml‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -116,7 +116,7 @@ nginxGateway:
116116
image:
117117
# -- The NGINX Gateway Fabric image to use
118118
repository: ghcr.io/nginx/nginx-gateway-fabric
119-
tag: 2.1.1
119+
tag: 2.1.2
120120
# @schema
121121
# enum:
122122
# - Always
@@ -271,7 +271,7 @@ nginx:
271271
image:
272272
# -- The NGINX image to use.
273273
repository: ghcr.io/nginx/nginx-gateway-fabric/nginx
274-
tag: 2.1.1
274+
tag: 2.1.2
275275
# @schema
276276
# enum:
277277
# - Always

‎deploy/azure/deploy.yaml‎

Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ metadata:
1010
labels:
1111
app.kubernetes.io/instance: nginx-gateway
1212
app.kubernetes.io/name: nginx-gateway
13-
app.kubernetes.io/version: 2.1.1
13+
app.kubernetes.io/version: 2.1.2
1414
name: nginx-gateway
1515
namespace: nginx-gateway
1616
---
@@ -21,7 +21,7 @@ metadata:
2121
labels:
2222
app.kubernetes.io/instance: nginx-gateway
2323
app.kubernetes.io/name: nginx-gateway
24-
app.kubernetes.io/version: 2.1.1
24+
app.kubernetes.io/version: 2.1.2
2525
name: nginx-gateway-cert-generator
2626
namespace: nginx-gateway
2727
---
@@ -31,7 +31,7 @@ metadata:
3131
labels:
3232
app.kubernetes.io/instance: nginx-gateway
3333
app.kubernetes.io/name: nginx-gateway
34-
app.kubernetes.io/version: 2.1.1
34+
app.kubernetes.io/version: 2.1.2
3535
name: nginx-gateway-cert-generator
3636
namespace: nginx-gateway
3737
rules:
@@ -50,7 +50,7 @@ metadata:
5050
labels:
5151
app.kubernetes.io/instance: nginx-gateway
5252
app.kubernetes.io/name: nginx-gateway
53-
app.kubernetes.io/version: 2.1.1
53+
app.kubernetes.io/version: 2.1.2
5454
name: nginx-gateway
5555
rules:
5656
- apiGroups:
@@ -183,7 +183,7 @@ metadata:
183183
labels:
184184
app.kubernetes.io/instance: nginx-gateway
185185
app.kubernetes.io/name: nginx-gateway
186-
app.kubernetes.io/version: 2.1.1
186+
app.kubernetes.io/version: 2.1.2
187187
name: nginx-gateway-cert-generator
188188
namespace: nginx-gateway
189189
roleRef:
@@ -201,7 +201,7 @@ metadata:
201201
labels:
202202
app.kubernetes.io/instance: nginx-gateway
203203
app.kubernetes.io/name: nginx-gateway
204-
app.kubernetes.io/version: 2.1.1
204+
app.kubernetes.io/version: 2.1.2
205205
name: nginx-gateway
206206
roleRef:
207207
apiGroup: rbac.authorization.k8s.io
@@ -218,7 +218,7 @@ metadata:
218218
labels:
219219
app.kubernetes.io/instance: nginx-gateway
220220
app.kubernetes.io/name: nginx-gateway
221-
app.kubernetes.io/version: 2.1.1
221+
app.kubernetes.io/version: 2.1.2
222222
name: nginx-gateway
223223
namespace: nginx-gateway
224224
spec:
@@ -238,7 +238,7 @@ metadata:
238238
labels:
239239
app.kubernetes.io/instance: nginx-gateway
240240
app.kubernetes.io/name: nginx-gateway
241-
app.kubernetes.io/version: 2.1.1
241+
app.kubernetes.io/version: 2.1.2
242242
name: nginx-gateway
243243
namespace: nginx-gateway
244244
spec:
@@ -286,8 +286,8 @@ spec:
286286
fieldRef:
287287
fieldPath: metadata.labels['app.kubernetes.io/instance']
288288
- name: IMAGE_NAME
289-
value: ghcr.io/nginx/nginx-gateway-fabric:2.1.1
290-
image: ghcr.io/nginx/nginx-gateway-fabric:2.1.1
289+
value: ghcr.io/nginx/nginx-gateway-fabric:2.1.2
290+
image: ghcr.io/nginx/nginx-gateway-fabric:2.1.2
291291
imagePullPolicy: IfNotPresent
292292
name: nginx-gateway
293293
ports:
@@ -334,7 +334,7 @@ metadata:
334334
labels:
335335
app.kubernetes.io/instance: nginx-gateway
336336
app.kubernetes.io/name: nginx-gateway
337-
app.kubernetes.io/version: 2.1.1
337+
app.kubernetes.io/version: 2.1.2
338338
name: nginx-gateway-cert-generator
339339
namespace: nginx-gateway
340340
spec:
@@ -355,7 +355,7 @@ spec:
355355
valueFrom:
356356
fieldRef:
357357
fieldPath: metadata.namespace
358-
image: ghcr.io/nginx/nginx-gateway-fabric:2.1.1
358+
image: ghcr.io/nginx/nginx-gateway-fabric:2.1.2
359359
imagePullPolicy: IfNotPresent
360360
name: cert-generator
361361
securityContext:
@@ -381,7 +381,7 @@ metadata:
381381
labels:
382382
app.kubernetes.io/instance: nginx-gateway
383383
app.kubernetes.io/name: nginx-gateway
384-
app.kubernetes.io/version: 2.1.1
384+
app.kubernetes.io/version: 2.1.2
385385
name: nginx
386386
spec:
387387
controllerName: gateway.nginx.org/nginx-gateway-controller
@@ -397,7 +397,7 @@ metadata:
397397
labels:
398398
app.kubernetes.io/instance: nginx-gateway
399399
app.kubernetes.io/name: nginx-gateway
400-
app.kubernetes.io/version: 2.1.1
400+
app.kubernetes.io/version: 2.1.2
401401
name: nginx-gateway-config
402402
namespace: nginx-gateway
403403
spec:
@@ -410,7 +410,7 @@ metadata:
410410
labels:
411411
app.kubernetes.io/instance: nginx-gateway
412412
app.kubernetes.io/name: nginx-gateway
413-
app.kubernetes.io/version: 2.1.1
413+
app.kubernetes.io/version: 2.1.2
414414
name: nginx-gateway-proxy-config
415415
namespace: nginx-gateway
416416
spec:
@@ -420,7 +420,7 @@ spec:
420420
image:
421421
pullPolicy: IfNotPresent
422422
repository: ghcr.io/nginx/nginx-gateway-fabric/nginx
423-
tag: 2.1.1
423+
tag: 2.1.2
424424
pod:
425425
nodeSelector:
426426
kubernetes.io/os: linux

0 commit comments

Comments
 (0)