Skip to content

Commit 50bed80

Browse files
authored
Release 2.1.1 docs (#3833)
Release 2.1.1
1 parent d42d0fb commit 50bed80

File tree

15 files changed

+191
-160
lines changed

15 files changed

+191
-160
lines changed

CHANGELOG.md

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,36 @@ 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.1
8+
9+
_September 3, 2025_
10+
11+
BUG FIXES:
12+
13+
- Fix remove patch label/ annotation cross contamination. [3754](https://github.com/nginx/nginx-gateway-fabric/pull/3754)
14+
- Fix host readiness probe on ipv6 in addition to ipv4. [3765](https://github.com/nginx/nginx-gateway-fabric/pull/3765). Thanks to [lucasl0st](https://github.com/lucasl0st).
15+
- Prevent policy `includes` duplication in advanced routing configuration. [3799](https://github.com/nginx/nginx-gateway-fabric/pull/3799)
16+
- Adjust nginx agent backoff settings and revert request timeout. [3820](https://github.com/nginx/nginx-gateway-fabric/pull/3820)
17+
18+
HELM CHART:
19+
20+
- The version of the Helm chart is now 2.1.1
21+
- Add patches to helm chart spec. [3773](https://github.com/nginx/nginx-gateway-fabric/pull/3773)
22+
23+
COMPATIBILITY:
24+
25+
- Gateway API version: `1.3.0`
26+
- NGINX version: `1.29.1`
27+
- NGINX Plus version: `R35`
28+
- NGINX Agent version: `v3.2.1`
29+
- Kubernetes version: `1.25+`
30+
31+
CONTAINER IMAGES:
32+
33+
- Control plane: `ghcr.io/nginx/nginx-gateway-fabric:2.1.1`
34+
- Data plane: `ghcr.io/nginx/nginx-gateway-fabric/nginx:2.1.1`
35+
- Data plane with NGINX Plus: `private-registry.nginx.com/nginx-gateway-fabric/nginx-plus:2.1.1`
36+
737
## Release 2.1.0
838

939
_August 14, 2025_

README.md

Lines changed: 4 additions & 3 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.0](https://github.com/nginx/nginx-gateway-fabric/releases/tag/v2.1.0).
39+
The latest release is [2.1.1](https://github.com/nginx/nginx-gateway-fabric/releases/tag/v2.1.1).
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.0/deploy). | [Documentation](https://docs.nginx.com/nginx-gateway-fabric). [Examples](https://github.com/nginx/nginx-gateway-fabric/tree/v2.1.0/examples). |
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). |
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
@@ -68,7 +68,8 @@ The following table lists the software versions NGINX Gateway Fabric supports.
6868

6969
| NGINX Gateway Fabric | Gateway API | Kubernetes | NGINX OSS | NGINX Plus | NGINX Agent |
7070
|----------------------|-------------|------------|-----------|------------|-------------|
71-
| Edge | 1.3.0 | 1.25+ | 1.29.1 | R35 | v3.2.1 |
71+
| Edge | 1.3.0 | 1.25+ | 1.29.1 | R35 | v3.3.0 |
72+
| 2.1.1 | 1.3.0 | 1.25+ | 1.29.1 | R35 | v3.2.1 |
7273
| 2.1.0 | 1.3.0 | 1.25+ | 1.29.1 | R35 | v3.2.1 |
7374
| 2.0.2 | 1.3.0 | 1.25+ | 1.28.0 | R34 | v3.0.1 |
7475
| 2.0.1 | 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.0
6-
appVersion: "2.1.0"
5+
version: 2.1.1
6+
appVersion: "2.1.1"
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.0](https://img.shields.io/badge/Version-2.1.0-informational?style=flat-square) ![AppVersion: 2.1.0](https://img.shields.io/badge/AppVersion-2.1.0-informational?style=flat-square)
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)
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.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":"","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.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}}` |
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.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":[]}` |
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":[]}` |
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.0"}` |
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"}` |
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.0",
427+
"default": "2.1.1",
428428
"required": [],
429429
"title": "tag",
430430
"type": "string"
@@ -796,7 +796,7 @@
796796
"type": "string"
797797
},
798798
"tag": {
799-
"default": "2.1.0",
799+
"default": "2.1.1",
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.0
119+
tag: 2.1.1
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.0
274+
tag: 2.1.1
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.0
13+
app.kubernetes.io/version: 2.1.1
1414
name: nginx-gateway
1515
namespace: nginx-gateway
1616
---
@@ -20,7 +20,7 @@ metadata:
2020
labels:
2121
app.kubernetes.io/instance: nginx-gateway
2222
app.kubernetes.io/name: nginx-gateway
23-
app.kubernetes.io/version: 2.1.0
23+
app.kubernetes.io/version: 2.1.1
2424
name: nginx-gateway-cert-generator
2525
namespace: nginx-gateway
2626
---
@@ -30,7 +30,7 @@ metadata:
3030
labels:
3131
app.kubernetes.io/instance: nginx-gateway
3232
app.kubernetes.io/name: nginx-gateway
33-
app.kubernetes.io/version: 2.1.0
33+
app.kubernetes.io/version: 2.1.1
3434
name: nginx-gateway-cert-generator
3535
namespace: nginx-gateway
3636
rules:
@@ -49,7 +49,7 @@ metadata:
4949
labels:
5050
app.kubernetes.io/instance: nginx-gateway
5151
app.kubernetes.io/name: nginx-gateway
52-
app.kubernetes.io/version: 2.1.0
52+
app.kubernetes.io/version: 2.1.1
5353
name: nginx-gateway
5454
rules:
5555
- apiGroups:
@@ -182,7 +182,7 @@ metadata:
182182
labels:
183183
app.kubernetes.io/instance: nginx-gateway
184184
app.kubernetes.io/name: nginx-gateway
185-
app.kubernetes.io/version: 2.1.0
185+
app.kubernetes.io/version: 2.1.1
186186
name: nginx-gateway-cert-generator
187187
namespace: nginx-gateway
188188
roleRef:
@@ -200,7 +200,7 @@ metadata:
200200
labels:
201201
app.kubernetes.io/instance: nginx-gateway
202202
app.kubernetes.io/name: nginx-gateway
203-
app.kubernetes.io/version: 2.1.0
203+
app.kubernetes.io/version: 2.1.1
204204
name: nginx-gateway
205205
roleRef:
206206
apiGroup: rbac.authorization.k8s.io
@@ -217,7 +217,7 @@ metadata:
217217
labels:
218218
app.kubernetes.io/instance: nginx-gateway
219219
app.kubernetes.io/name: nginx-gateway
220-
app.kubernetes.io/version: 2.1.0
220+
app.kubernetes.io/version: 2.1.1
221221
name: nginx-gateway
222222
namespace: nginx-gateway
223223
spec:
@@ -237,7 +237,7 @@ metadata:
237237
labels:
238238
app.kubernetes.io/instance: nginx-gateway
239239
app.kubernetes.io/name: nginx-gateway
240-
app.kubernetes.io/version: 2.1.0
240+
app.kubernetes.io/version: 2.1.1
241241
name: nginx-gateway
242242
namespace: nginx-gateway
243243
spec:
@@ -285,8 +285,8 @@ spec:
285285
fieldRef:
286286
fieldPath: metadata.labels['app.kubernetes.io/instance']
287287
- name: IMAGE_NAME
288-
value: ghcr.io/nginx/nginx-gateway-fabric:2.1.0
289-
image: ghcr.io/nginx/nginx-gateway-fabric:2.1.0
288+
value: ghcr.io/nginx/nginx-gateway-fabric:2.1.1
289+
image: ghcr.io/nginx/nginx-gateway-fabric:2.1.1
290290
imagePullPolicy: IfNotPresent
291291
name: nginx-gateway
292292
ports:
@@ -333,7 +333,7 @@ metadata:
333333
labels:
334334
app.kubernetes.io/instance: nginx-gateway
335335
app.kubernetes.io/name: nginx-gateway
336-
app.kubernetes.io/version: 2.1.0
336+
app.kubernetes.io/version: 2.1.1
337337
name: nginx-gateway-cert-generator
338338
namespace: nginx-gateway
339339
spec:
@@ -353,7 +353,7 @@ spec:
353353
valueFrom:
354354
fieldRef:
355355
fieldPath: metadata.namespace
356-
image: ghcr.io/nginx/nginx-gateway-fabric:2.1.0
356+
image: ghcr.io/nginx/nginx-gateway-fabric:2.1.1
357357
imagePullPolicy: IfNotPresent
358358
name: cert-generator
359359
securityContext:
@@ -379,7 +379,7 @@ metadata:
379379
labels:
380380
app.kubernetes.io/instance: nginx-gateway
381381
app.kubernetes.io/name: nginx-gateway
382-
app.kubernetes.io/version: 2.1.0
382+
app.kubernetes.io/version: 2.1.1
383383
name: nginx
384384
spec:
385385
controllerName: gateway.nginx.org/nginx-gateway-controller
@@ -395,7 +395,7 @@ metadata:
395395
labels:
396396
app.kubernetes.io/instance: nginx-gateway
397397
app.kubernetes.io/name: nginx-gateway
398-
app.kubernetes.io/version: 2.1.0
398+
app.kubernetes.io/version: 2.1.1
399399
name: nginx-gateway-config
400400
namespace: nginx-gateway
401401
spec:
@@ -408,7 +408,7 @@ metadata:
408408
labels:
409409
app.kubernetes.io/instance: nginx-gateway
410410
app.kubernetes.io/name: nginx-gateway
411-
app.kubernetes.io/version: 2.1.0
411+
app.kubernetes.io/version: 2.1.1
412412
name: nginx-gateway-proxy-config
413413
namespace: nginx-gateway
414414
spec:
@@ -418,7 +418,7 @@ spec:
418418
image:
419419
pullPolicy: IfNotPresent
420420
repository: ghcr.io/nginx/nginx-gateway-fabric/nginx
421-
tag: 2.1.0
421+
tag: 2.1.1
422422
pod:
423423
nodeSelector:
424424
kubernetes.io/os: linux

0 commit comments

Comments
 (0)