Skip to content

Commit 1712d40

Browse files
authored
Release 1.6.0 (#3003)
Update files for 1.6.0 release.
1 parent 79c0f05 commit 1712d40

34 files changed

+264
-220
lines changed

CHANGELOG.md

+43
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,49 @@ 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 1.6.0
8+
9+
_January 15, 2025_
10+
11+
FEATURES:
12+
13+
- Add UpstreamSettingsPolicy to allow users to configure upstream settings for Services. [2941](https://github.com/nginx/nginx-gateway-fabric/pull/2941)
14+
- Add path support for RequestRedirect Filter. [2979](https://github.com/nginx/nginx-gateway-fabric/pull/2979)
15+
- Use state files for NGINX Plus upstream servers instead of the NGINX config. [2897](https://github.com/nginx/nginx-gateway-fabric/pull/2897)
16+
17+
BUG FIXES:
18+
19+
- Fix rewrite path for ReplacePrefixMatch to parse request arguments correctly. [2951](https://github.com/nginx/nginx-gateway-fabric/pull/2951)
20+
- Fix an issue where updating upstreams with the NGINX Plus API would not occur if metrics were disabled. [2897](https://github.com/nginx/nginx-gateway-fabric/pull/2897)
21+
- Support updating stream upstreams with the NGINX Plus API instead of reloading NGINX. [2897](https://github.com/nginx/nginx-gateway-fabric/pull/2897)
22+
23+
DOCUMENTATION:
24+
25+
- Docs: Update support referencing support package tool. [2789](https://github.com/nginx/nginx-gateway-fabric/pull/2789). Thanks to [mrajagopal](https://github.com/mrajagopal).
26+
- Add how-to guide for configuring upstream settings for services using the UpstreamSettingsPolicy API. Find it [here](https://docs.nginx.com/nginx-gateway-fabric/how-to/traffic-management/upstream-settings/). [2987](https://github.com/nginx/nginx-gateway-fabric/pull/2987)
27+
28+
HELM CHART:
29+
30+
- The version of the Helm chart is now 1.6.0
31+
32+
UPGRADE:
33+
34+
- The Gateway API version has been updated to 1.2.1. [2868](https://github.com/nginx/nginx-gateway-fabric/pull/2868)
35+
- ObservabilityPolicy API version has been increased to `v1alpha2` due to a strengthening of validation rules. [2998](https://github.com/nginx/nginx-gateway-fabric/pull/2998)
36+
37+
COMPATIBILITY:
38+
39+
- Gateway API version: `1.2.1`
40+
- NGINX version: `1.27.3`
41+
- NGINX Plus version: `R33`
42+
- Kubernetes version: `1.25+`
43+
44+
CONTAINER IMAGES:
45+
46+
- Control plane: `ghcr.io/nginx/nginx-gateway-fabric:1.6.0`
47+
- Data plane: `ghcr.io/nginx/nginx-gateway-fabric/nginx:1.6.0`
48+
- Data plane with NGINX Plus: `private-registry.nginx.com/nginx-gateway-fabric/nginx-plus:1.6.0`
49+
750
## Release 1.5.1
851

952
_December 16, 2024_

Makefile

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
# variables that should not be overridden by the user
2-
VERSION = edge
2+
VERSION = 1.6.0
33
SELF_DIR := $(dir $(abspath $(lastword $(MAKEFILE_LIST))))
44
CHART_DIR = $(SELF_DIR)charts/nginx-gateway-fabric
55
NGINX_CONF_DIR = internal/mode/static/nginx/conf

README.md

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

37-
The latest release is [1.5.1](https://github.com/nginx/nginx-gateway-fabric/releases/tag/v1.5.1).
37+
The latest release is [1.6.0](https://github.com/nginx/nginx-gateway-fabric/releases/tag/v1.6.0).
3838

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

4646
| Version | Description | Installation Manifests | Documentation and Examples |
4747
|----------------|------------------------------------------|-----------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
48-
| Latest release | For production use | [Manifests](https://github.com/nginx/nginx-gateway-fabric/tree/v1.5.1/deploy). | [Documentation](https://docs.nginx.com/nginx-gateway-fabric). [Examples](https://github.com/nginx/nginx-gateway-fabric/tree/v1.5.1/examples). |
48+
| Latest release | For production use | [Manifests](https://github.com/nginx/nginx-gateway-fabric/tree/v1.6.0/deploy). | [Documentation](https://docs.nginx.com/nginx-gateway-fabric). [Examples](https://github.com/nginx/nginx-gateway-fabric/tree/v1.6.0/examples). |
4949
| Edge | For experimental use and latest features | [Manifests](https://github.com/nginx/nginx-gateway-fabric/tree/main/deploy). | [Documentation](https://github.com/nginx/nginx-gateway-fabric/tree/main/site/content). [Examples](https://github.com/nginx/nginx-gateway-fabric/tree/main/examples). |
5050

5151
### Versioning
@@ -67,6 +67,7 @@ The following table lists the software versions NGINX Gateway Fabric supports.
6767
| NGINX Gateway Fabric | Gateway API | Kubernetes | NGINX OSS | NGINX Plus |
6868
|----------------------|-------------|------------|-----------|------------|
6969
| Edge | 1.2.1 | 1.25+ | 1.27.3 | R33 |
70+
| 1.6.0 | 1.2.1 | 1.25+ | 1.27.3 | R33 |
7071
| 1.5.1 | 1.2.0 | 1.25+ | 1.27.2 | R33 |
7172
| 1.5.0 | 1.2.0 | 1.25+ | 1.27.2 | R33 |
7273
| 1.4.0 | 1.1.0 | 1.25+ | 1.27.1 | R32 |

charts/nginx-gateway-fabric/Chart.yaml

+2-2
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: 1.5.1
6-
appVersion: "edge"
5+
version: 1.6.0
6+
appVersion: "1.6.0"
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

+5-5
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11

22
# NGINX Gateway Fabric Helm Chart
33

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

66
- [NGINX Gateway Fabric Helm Chart](#nginx-gateway-fabric-helm-chart)
77
- [Introduction](#introduction)
@@ -263,9 +263,9 @@ The following table lists the configurable parameters of the NGINX Gateway Fabri
263263
| `nginx.config` | The configuration for the data plane that is contained in the NginxProxy resource. | object | `{}` |
264264
| `nginx.debug` | Enable debugging for NGINX. Uses the nginx-debug binary. The NGINX error log level should be set to debug in the NginxProxy resource. | bool | `false` |
265265
| `nginx.extraVolumeMounts` | extraVolumeMounts are the additional volume mounts for the nginx container. | list | `[]` |
266-
| `nginx.image.pullPolicy` | | string | `"Always"` |
266+
| `nginx.image.pullPolicy` | | string | `"IfNotPresent"` |
267267
| `nginx.image.repository` | The NGINX image to use. | string | `"ghcr.io/nginx/nginx-gateway-fabric/nginx"` |
268-
| `nginx.image.tag` | | string | `"edge"` |
268+
| `nginx.image.tag` | | string | `"1.6.0"` |
269269
| `nginx.lifecycle` | The lifecycle of the nginx container. | object | `{}` |
270270
| `nginx.plus` | Is NGINX Plus image being used | bool | `false` |
271271
| `nginx.usage.caSecretName` | The name of the Secret containing the NGINX Instance Manager CA certificate. Must exist in the same namespace that the NGINX Gateway Fabric control plane is running in (default namespace: nginx-gateway). | string | `""` |
@@ -281,9 +281,9 @@ The following table lists the configurable parameters of the NGINX Gateway Fabri
281281
| `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"` |
282282
| `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"` |
283283
| `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` |
284-
| `nginxGateway.image.pullPolicy` | | string | `"Always"` |
284+
| `nginxGateway.image.pullPolicy` | | string | `"IfNotPresent"` |
285285
| `nginxGateway.image.repository` | The NGINX Gateway Fabric image to use | string | `"ghcr.io/nginx/nginx-gateway-fabric"` |
286-
| `nginxGateway.image.tag` | | string | `"edge"` |
286+
| `nginxGateway.image.tag` | | string | `"1.6.0"` |
287287
| `nginxGateway.kind` | The kind of the NGINX Gateway Fabric installation - currently, only deployment is supported. | string | `"deployment"` |
288288
| `nginxGateway.leaderElection.enable` | Enable leader election. Leader election is used to avoid multiple replicas of the NGINX Gateway Fabric reporting the status of the Gateway API resources. If not enabled, all replicas of NGINX Gateway Fabric will update the statuses of the Gateway API resources. | bool | `true` |
289289
| `nginxGateway.leaderElection.lockName` | The name of the leader election lock. A Lease object with this name will be created in the same Namespace as the controller. | string | Autogenerated if not set or set to "". |

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

+4-4
Original file line numberDiff line numberDiff line change
@@ -219,7 +219,7 @@
219219
"image": {
220220
"properties": {
221221
"pullPolicy": {
222-
"default": "Always",
222+
"default": "IfNotPresent",
223223
"enum": [
224224
"Always",
225225
"IfNotPresent",
@@ -236,7 +236,7 @@
236236
"type": "string"
237237
},
238238
"tag": {
239-
"default": "edge",
239+
"default": "1.6.0",
240240
"required": [],
241241
"title": "tag",
242242
"type": "string"
@@ -394,7 +394,7 @@
394394
"image": {
395395
"properties": {
396396
"pullPolicy": {
397-
"default": "Always",
397+
"default": "IfNotPresent",
398398
"enum": [
399399
"Always",
400400
"IfNotPresent",
@@ -411,7 +411,7 @@
411411
"type": "string"
412412
},
413413
"tag": {
414-
"default": "edge",
414+
"default": "1.6.0",
415415
"required": [],
416416
"title": "tag",
417417
"type": "string"

charts/nginx-gateway-fabric/values.yaml

+4-4
Original file line numberDiff line numberDiff line change
@@ -82,14 +82,14 @@ nginxGateway:
8282
image:
8383
# -- The NGINX Gateway Fabric image to use
8484
repository: ghcr.io/nginx/nginx-gateway-fabric
85-
tag: edge
85+
tag: 1.6.0
8686
# @schema
8787
# enum:
8888
# - Always
8989
# - IfNotPresent
9090
# - Never
9191
# @schema
92-
pullPolicy: Always
92+
pullPolicy: IfNotPresent
9393

9494
securityContext:
9595
# -- Some environments may need this set to true in order for the control plane to successfully reload NGINX.
@@ -122,14 +122,14 @@ nginx:
122122
image:
123123
# -- The NGINX image to use.
124124
repository: ghcr.io/nginx/nginx-gateway-fabric/nginx
125-
tag: edge
125+
tag: 1.6.0
126126
# @schema
127127
# enum:
128128
# - Always
129129
# - IfNotPresent
130130
# - Never
131131
# @schema
132-
pullPolicy: Always
132+
pullPolicy: IfNotPresent
133133

134134
# -- Is NGINX Plus image being used
135135
plus: false

config/tests/static-deployment.yaml

+7-7
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ metadata:
88
labels:
99
app.kubernetes.io/name: nginx-gateway
1010
app.kubernetes.io/instance: nginx-gateway
11-
app.kubernetes.io/version: "edge"
11+
app.kubernetes.io/version: "1.6.0"
1212
spec:
1313
replicas: 1
1414
selector:
@@ -23,8 +23,8 @@ spec:
2323
spec:
2424
initContainers:
2525
- name: init
26-
image: ghcr.io/nginx/nginx-gateway-fabric:edge
27-
imagePullPolicy: Always
26+
image: ghcr.io/nginx/nginx-gateway-fabric:1.6.0
27+
imagePullPolicy: IfNotPresent
2828
command:
2929
- /usr/bin/gateway
3030
- initialize
@@ -81,8 +81,8 @@ spec:
8181
valueFrom:
8282
fieldRef:
8383
fieldPath: metadata.uid
84-
image: ghcr.io/nginx/nginx-gateway-fabric:edge
85-
imagePullPolicy: Always
84+
image: ghcr.io/nginx/nginx-gateway-fabric:1.6.0
85+
imagePullPolicy: IfNotPresent
8686
name: nginx-gateway
8787
ports:
8888
- name: health
@@ -118,8 +118,8 @@ spec:
118118
mountPath: /var/run/nginx
119119
- name: nginx-includes
120120
mountPath: /etc/nginx/includes
121-
- image: ghcr.io/nginx/nginx-gateway-fabric/nginx:edge
122-
imagePullPolicy: Always
121+
- image: ghcr.io/nginx/nginx-gateway-fabric/nginx:1.6.0
122+
imagePullPolicy: IfNotPresent
123123
name: nginx
124124
ports:
125125
- containerPort: 80

deploy/aws-nlb/deploy.yaml

+14-14
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ metadata:
99
labels:
1010
app.kubernetes.io/instance: nginx-gateway
1111
app.kubernetes.io/name: nginx-gateway
12-
app.kubernetes.io/version: edge
12+
app.kubernetes.io/version: 1.6.0
1313
name: nginx-gateway
1414
namespace: nginx-gateway
1515
---
@@ -19,7 +19,7 @@ metadata:
1919
labels:
2020
app.kubernetes.io/instance: nginx-gateway
2121
app.kubernetes.io/name: nginx-gateway
22-
app.kubernetes.io/version: edge
22+
app.kubernetes.io/version: 1.6.0
2323
name: nginx-gateway
2424
rules:
2525
- apiGroups:
@@ -133,7 +133,7 @@ metadata:
133133
labels:
134134
app.kubernetes.io/instance: nginx-gateway
135135
app.kubernetes.io/name: nginx-gateway
136-
app.kubernetes.io/version: edge
136+
app.kubernetes.io/version: 1.6.0
137137
name: nginx-gateway
138138
roleRef:
139139
apiGroup: rbac.authorization.k8s.io
@@ -153,7 +153,7 @@ metadata:
153153
labels:
154154
app.kubernetes.io/instance: nginx-gateway
155155
app.kubernetes.io/name: nginx-gateway
156-
app.kubernetes.io/version: edge
156+
app.kubernetes.io/version: 1.6.0
157157
name: nginx-includes-bootstrap
158158
namespace: nginx-gateway
159159
---
@@ -166,7 +166,7 @@ metadata:
166166
labels:
167167
app.kubernetes.io/instance: nginx-gateway
168168
app.kubernetes.io/name: nginx-gateway
169-
app.kubernetes.io/version: edge
169+
app.kubernetes.io/version: 1.6.0
170170
name: nginx-gateway
171171
namespace: nginx-gateway
172172
spec:
@@ -191,7 +191,7 @@ metadata:
191191
labels:
192192
app.kubernetes.io/instance: nginx-gateway
193193
app.kubernetes.io/name: nginx-gateway
194-
app.kubernetes.io/version: edge
194+
app.kubernetes.io/version: 1.6.0
195195
name: nginx-gateway
196196
namespace: nginx-gateway
197197
spec:
@@ -236,8 +236,8 @@ spec:
236236
valueFrom:
237237
fieldRef:
238238
fieldPath: metadata.uid
239-
image: ghcr.io/nginx/nginx-gateway-fabric:edge
240-
imagePullPolicy: Always
239+
image: ghcr.io/nginx/nginx-gateway-fabric:1.6.0
240+
imagePullPolicy: IfNotPresent
241241
name: nginx-gateway
242242
ports:
243243
- containerPort: 9113
@@ -275,8 +275,8 @@ spec:
275275
name: nginx-run
276276
- mountPath: /etc/nginx/includes
277277
name: nginx-includes
278-
- image: ghcr.io/nginx/nginx-gateway-fabric/nginx:edge
279-
imagePullPolicy: Always
278+
- image: ghcr.io/nginx/nginx-gateway-fabric/nginx:1.6.0
279+
imagePullPolicy: IfNotPresent
280280
name: nginx
281281
ports:
282282
- containerPort: 80
@@ -322,8 +322,8 @@ spec:
322322
valueFrom:
323323
fieldRef:
324324
fieldPath: metadata.uid
325-
image: ghcr.io/nginx/nginx-gateway-fabric:edge
326-
imagePullPolicy: Always
325+
image: ghcr.io/nginx/nginx-gateway-fabric:1.6.0
326+
imagePullPolicy: IfNotPresent
327327
name: init
328328
securityContext:
329329
capabilities:
@@ -372,7 +372,7 @@ metadata:
372372
labels:
373373
app.kubernetes.io/instance: nginx-gateway
374374
app.kubernetes.io/name: nginx-gateway
375-
app.kubernetes.io/version: edge
375+
app.kubernetes.io/version: 1.6.0
376376
name: nginx
377377
spec:
378378
controllerName: gateway.nginx.org/nginx-gateway-controller
@@ -383,7 +383,7 @@ metadata:
383383
labels:
384384
app.kubernetes.io/instance: nginx-gateway
385385
app.kubernetes.io/name: nginx-gateway
386-
app.kubernetes.io/version: edge
386+
app.kubernetes.io/version: 1.6.0
387387
name: nginx-gateway-config
388388
namespace: nginx-gateway
389389
spec:

0 commit comments

Comments
 (0)