Skip to content

Commit 707cc6d

Browse files
Update NGINX Ingress Controller to 3.2.0 (#139)
1 parent e6d6140 commit 707cc6d

22 files changed

+86
-71
lines changed

bundle/manifests/nginx-ingress-operator.clusterserviceversion.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -63,7 +63,7 @@ metadata:
6363
"image": {
6464
"pullPolicy": "IfNotPresent",
6565
"repository": "nginx/nginx-ingress",
66-
"tag": "3.1.1-ubi"
66+
"tag": "3.2.0-ubi"
6767
},
6868
"includeYear": false,
6969
"ingressClass": "nginx",

config/samples/charts_v1alpha1_nginxingress.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,7 @@ spec:
2525
customPorts: []
2626
image:
2727
repository: nginx/nginx-ingress
28-
tag: "3.1.1-ubi"
28+
tag: "3.2.0-ubi"
2929
# digest: "sha256:CHANGEME"
3030
pullPolicy: IfNotPresent
3131
lifecycle: {}

docs/nginx-ingress-controller.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,7 @@ spec:
3636
customPorts: []
3737
image:
3838
repository: nginx/nginx-ingress
39-
tag: "3.1.1-ubi"
39+
tag: "3.2.0-ubi"
4040
# digest: "sha256:CHANGEME"
4141
pullPolicy: IfNotPresent
4242
lifecycle: {}
@@ -220,7 +220,7 @@ Parameter | Description | Default
220220
`controller.logLevel` | The log level of the Ingress Controller. | 1
221221
`controller.image.digest ` | The image digest of the Ingress Controller. | None
222222
`controller.image.repository` | The image repository of the Ingress Controller. | nginx/nginx-ingress
223-
`controller.image.tag` | The tag of the Ingress Controller image. | 3.1.1
223+
`controller.image.tag` | The tag of the Ingress Controller image. | 3.2.0
224224
`controller.image.pullPolicy` | The pull policy for the Ingress Controller image. | IfNotPresent
225225
`controller.lifecycle` | The lifecycle of the Ingress Controller pods. | {}
226226
`controller.customConfigMap` | The name of the custom ConfigMap used by the Ingress Controller. If set, then the default config is ignored. | ""

examples/deployment-oss-min/nginx-ingress-controller.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ spec:
1111
image:
1212
pullPolicy: IfNotPresent
1313
repository: nginx/nginx-ingress
14-
tag: 3.1.1-ubi
14+
tag: 3.2.0-ubi
1515
ingressClass: nginx
1616
kind: deployment
1717
nginxplus: false

examples/deployment-plus-min/nginx-ingress-controller.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ spec:
1111
image:
1212
pullPolicy: IfNotPresent
1313
repository: nginx/nginx-ingress
14-
tag: 3.1.1-ubi
14+
tag: 3.2.0-ubi
1515
ingressClass: nginx
1616
kind: deployment
1717
nginxplus: true
Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,17 +1,17 @@
11
apiVersion: v2
2-
name: nginx-ingress
3-
version: 0.17.1
4-
appVersion: 3.1.1
5-
kubeVersion: ">= 1.22.0-0"
6-
type: application
2+
appVersion: 3.2.0
73
description: NGINX Ingress Controller
8-
icon: https://raw.githubusercontent.com/nginxinc/kubernetes-ingress/v3.1.1/deployments/helm-chart/chart-icon.png
94
home: https://github.com/nginxinc/kubernetes-ingress
10-
sources:
11-
- https://github.com/nginxinc/kubernetes-ingress/tree/v3.1.1/deployments/helm-chart
5+
icon: https://raw.githubusercontent.com/nginxinc/kubernetes-ingress/v3.2.0/deployments/helm-chart/chart-icon.png
126
keywords:
13-
- ingress
14-
- nginx
7+
- ingress
8+
- nginx
9+
kubeVersion: '>= 1.22.0-0'
1510
maintainers:
16-
- name: nginxinc
17-
11+
12+
name: nginxinc
13+
name: nginx-ingress
14+
sources:
15+
- https://github.com/nginxinc/kubernetes-ingress/tree/v3.2.0/deployments/helm-chart
16+
type: application
17+
version: 0.18.0

helm-charts/nginx-ingress/README.md

Lines changed: 36 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -6,14 +6,14 @@ This chart deploys the NGINX Ingress Controller in your Kubernetes cluster.
66

77
## Prerequisites
88

9-
- A [Kubernetes Version Supported by the Ingress Controller](https://docs.nginx.com/nginx-ingress-controller/technical-specifications/#supported-kubernetes-versions)
10-
- Helm 3.0+.
11-
- If you’d like to use NGINX Plus:
12-
- To pull from the F5 Container registry, configure a docker registry secret using your JWT token from the MyF5 portal by following the instructions from [here](https://docs.nginx.com/nginx-ingress-controller/installation/using-the-jwt-token-docker-secret). Make sure to specify the secret using `controller.serviceAccount.imagePullSecretName` parameter.
13-
- Alternatively, pull an Ingress Controller image with NGINX Plus and push it to your private registry by following the instructions from [here](https://docs.nginx.com/nginx-ingress-controller/installation/pulling-ingress-controller-image).
14-
- Alternatively, you can build an Ingress Controller image with NGINX Plus and push it to your private registry by following the instructions from [here](https://docs.nginx.com/nginx-ingress-controller/installation/building-ingress-controller-image).
15-
- Update the `controller.image.repository` field of the `values-plus.yaml` accordingly.
16-
- If you’d like to use App Protect DoS, please install App Protect DoS Arbitrator [helm chart](https://github.com/nginxinc/nap-dos-arbitrator-helm-chart). Make sure to install in the same namespace as the NGINX Ingress Controller. Note that if you install multiple NGINX Ingress Controllers in the same namespace, they will need to share the same Arbitrator because it is not possible to install more than one Arbitrator in a single namespace.
9+
- A [Kubernetes Version Supported by the Ingress Controller](https://docs.nginx.com/nginx-ingress-controller/technical-specifications/#supported-kubernetes-versions)
10+
- Helm 3.0+.
11+
- If you’d like to use NGINX Plus:
12+
- To pull from the F5 Container registry, configure a docker registry secret using your JWT token from the MyF5 portal by following the instructions from [here](https://docs.nginx.com/nginx-ingress-controller/installation/using-the-jwt-token-docker-secret). Make sure to specify the secret using `controller.serviceAccount.imagePullSecretName` parameter.
13+
- Alternatively, pull an Ingress Controller image with NGINX Plus and push it to your private registry by following the instructions from [here](https://docs.nginx.com/nginx-ingress-controller/installation/pulling-ingress-controller-image).
14+
- Alternatively, you can build an Ingress Controller image with NGINX Plus and push it to your private registry by following the instructions from [here](https://docs.nginx.com/nginx-ingress-controller/installation/building-ingress-controller-image).
15+
- Update the `controller.image.repository` field of the `values-plus.yaml` accordingly.
16+
- If you’d like to use App Protect DoS, please install App Protect DoS Arbitrator [helm chart](https://github.com/nginxinc/nap-dos-arbitrator-helm-chart). Make sure to install in the same namespace as the NGINX Ingress Controller. Note that if you install multiple NGINX Ingress Controllers in the same namespace, they will need to share the same Arbitrator because it is not possible to install more than one Arbitrator in a single namespace.
1717

1818
## CRDs
1919

@@ -26,8 +26,9 @@ If you do not use the custom resources that require those CRDs (which correspond
2626
To upgrade the CRDs, pull the chart sources as described in [Pulling the Chart](#pulling-the-chart) and then run:
2727

2828
```console
29-
$ kubectl apply -f crds/
29+
kubectl apply -f crds/
3030
```
31+
3132
> **Note**
3233
>
3334
> The following warning is expected and can be ignored: `Warning: kubectl apply should be used on resource created by either kubectl create --save-config or kubectl apply`.
@@ -39,26 +40,29 @@ $ kubectl apply -f crds/
3940
To remove the CRDs, pull the chart sources as described in [Pulling the Chart](#pulling-the-chart) and then run:
4041

4142
```console
42-
$ kubectl delete -f crds/
43+
kubectl delete -f crds/
4344
```
45+
4446
> **Note**
4547
>
4648
> This command will delete all the corresponding custom resources in your cluster across all namespaces. Please ensure there are no custom resources that you want to keep and there are no other Ingress Controller releases running in the cluster.
4749
48-
4950
## Managing the Chart via OCI Registry
51+
5052
### Installing the Chart
5153

5254
To install the chart with the release name my-release (my-release is the name that you choose):
5355

5456
For NGINX:
57+
5558
```console
56-
$ helm install my-release oci://ghcr.io/nginxinc/charts/nginx-ingress --version 0.17.1
59+
helm install my-release oci://ghcr.io/nginxinc/charts/nginx-ingress --version 0.18.0
5760
```
5861

5962
For NGINX Plus: (assuming you have pushed the Ingress Controller image `nginx-plus-ingress` to your private registry `myregistry.example.com`)
63+
6064
```console
61-
$ helm install my-release oci://ghcr.io/nginxinc/charts/nginx-ingress --version 0.17.1 --set controller.image.repository=myregistry.example.com/nginx-plus-ingress --set controller.nginxplus=true
65+
helm install my-release oci://ghcr.io/nginxinc/charts/nginx-ingress --version 0.18.0 --set controller.image.repository=myregistry.example.com/nginx-plus-ingress --set controller.nginxplus=true
6266
```
6367

6468
This will install the latest `edge` version of the Ingress Controller from GitHub Container Registry. If you prefer to use Docker Hub, you can replace `ghcr.io/nginxinc/charts/nginx-ingress` with `registry-1.docker.io/nginxcharts/nginx-ingress`.
@@ -70,16 +74,17 @@ Helm does not upgrade the CRDs during a release upgrade. Before you upgrade a re
7074
To upgrade the release `my-release`:
7175

7276
```console
73-
$ helm upgrade my-release oci://ghcr.io/nginxinc/charts/nginx-ingress --version 0.17.1
77+
helm upgrade my-release oci://ghcr.io/nginxinc/charts/nginx-ingress --version 0.18.0
7478
```
7579

7680
### Uninstalling the Chart
7781

7882
To uninstall/delete the release `my-release`:
7983

8084
```console
81-
$ helm uninstall my-release
85+
helm uninstall my-release
8286
```
87+
8388
The command removes all the Kubernetes components associated with the release and deletes the release.
8489

8590
Uninstalling the release does not remove the CRDs. To remove the CRDs, see [Uninstalling the CRDs](#uninstalling-the-crds).
@@ -90,42 +95,45 @@ To test the latest changes in NGINX Ingress Controller before a new release, you
9095
You can install the `edge` version by specifying the `--version` flag with the value `0.0.0-edge`:
9196

9297
```console
93-
$ helm install my-release oci://ghcr.io/nginxinc/charts/nginx-ingress --version 0.0.0-edge
98+
helm install my-release oci://ghcr.io/nginxinc/charts/nginx-ingress --version 0.0.0-edge
9499
```
95100

96101
> **Warning**
97102
>
98103
> The `edge` version is not intended for production use. It is intended for testing and development purposes only.
99104
100-
101105
## Managing the Chart via Sources
102106

103107
### Pulling the Chart
104108

105109
This step is required if you're installing the chart using its sources. Additionally, the step is also required for managing the custom resource definitions (CRDs), which the Ingress Controller requires by default, or for upgrading/deleting the CRDs.
106110

107111
1. Pull the chart sources:
112+
108113
```console
109-
$ helm pull oci://ghcr.io/nginxinc/charts/nginx-ingress --untar --version 0.17.1
114+
helm pull oci://ghcr.io/nginxinc/charts/nginx-ingress --untar --version 0.18.0
110115
```
111116

112117
2. Change your working directory to nginx-ingress:
118+
113119
```console
114-
$ cd nginx-ingress
120+
cd nginx-ingress
115121
```
116122

117123
### Installing the Chart
118124

119125
To install the chart with the release name my-release (my-release is the name that you choose):
120126

121127
For NGINX:
128+
122129
```console
123-
$ helm install my-release .
130+
helm install my-release .
124131
```
125132

126133
For NGINX Plus:
134+
127135
```console
128-
$ helm install my-release -f values-plus.yaml .
136+
helm install my-release -f values-plus.yaml .
129137
```
130138

131139
The command deploys the Ingress Controller in your Kubernetes cluster in the default configuration. The configuration section lists the parameters that can be configured during installation.
@@ -137,15 +145,15 @@ Helm does not upgrade the CRDs during a release upgrade. Before you upgrade a re
137145
To upgrade the release `my-release`:
138146

139147
```console
140-
$ helm upgrade my-release .
148+
helm upgrade my-release .
141149
```
142150

143151
### Uninstalling the Chart
144152

145153
To uninstall/delete the release `my-release`:
146154

147155
```console
148-
$ helm uninstall my-release
156+
helm uninstall my-release
149157
```
150158

151159
The command removes all the Kubernetes components associated with the release and deletes the release.
@@ -158,7 +166,6 @@ If you are running multiple Ingress Controller releases in your cluster with ena
158166

159167
See [running multiple Ingress Controllers](https://docs.nginx.com/nginx-ingress-controller/installation/running-multiple-ingress-controllers/) for more details.
160168

161-
162169
## Configuration
163170

164171
The following tables lists the configurable parameters of the NGINX Ingress Controller chart and their default values.
@@ -174,9 +181,9 @@ The following tables lists the configurable parameters of the NGINX Ingress Cont
174181
|`controller.dnsPolicy` | DNS policy for the Ingress Controller pods. | ClusterFirst |
175182
|`controller.nginxDebug` | Enables debugging for NGINX. Uses the `nginx-debug` binary. Requires `error-log-level: debug` in the ConfigMap via `controller.config.entries`. | false |
176183
|`controller.logLevel` | The log level of the Ingress Controller. | 1 |
177-
|`controller.image.digest ` | The image digest of the Ingress Controller. | None |
184+
|`controller.image.digest` | The image digest of the Ingress Controller. | None |
178185
|`controller.image.repository` | The image repository of the Ingress Controller. | nginx/nginx-ingress |
179-
|`controller.image.tag` | The tag of the Ingress Controller image. | 3.1.1 |
186+
|`controller.image.tag` | The tag of the Ingress Controller image. | 3.2.0 |
180187
|`controller.image.pullPolicy` | The pull policy for the Ingress Controller image. | IfNotPresent |
181188
|`controller.lifecycle` | The lifecycle of the Ingress Controller pods. | {} |
182189
|`controller.customConfigMap` | The name of the custom ConfigMap used by the Ingress Controller. If set, then the default config is ignored. | "" |
@@ -293,5 +300,6 @@ The following tables lists the configurable parameters of the NGINX Ingress Cont
293300
|`nginxServiceMesh.enableEgress` | Enable NGINX Service Mesh workloads to route egress traffic through the Ingress Controller. See the NGINX Service Mesh [docs](https://docs.nginx.com/nginx-service-mesh/tutorials/kic/deploy-with-kic/#enabling-egress) for more details. Requires `nginxServiceMesh.enable`. | false |
294301

295302
## Notes
296-
* The values-icp.yaml file is used for deploying the Ingress Controller on IBM Cloud Private. See the [blog post](https://www.nginx.com/blog/nginx-ingress-controller-ibm-cloud-private/) for more details.
297-
* The values-nsm.yaml file is used for deploying the Ingress Controller with NGINX Service Mesh. See the NGINX Service Mesh [docs](https://docs.nginx.com/nginx-service-mesh/tutorials/kic/deploy-with-kic/) for more details.
303+
304+
- The values-icp.yaml file is used for deploying the Ingress Controller on IBM Cloud Private. See the [blog post](https://www.nginx.com/blog/nginx-ingress-controller-ibm-cloud-private/) for more details.
305+
- The values-nsm.yaml file is used for deploying the Ingress Controller with NGINX Service Mesh. See the NGINX Service Mesh [docs](https://docs.nginx.com/nginx-service-mesh/tutorials/kic/deploy-with-kic/) for more details.
-7.97 KB
Binary file not shown.

helm-charts/nginx-ingress/crds/appprotectdos.f5.com_dosprotectedresources.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@ apiVersion: apiextensions.k8s.io/v1
22
kind: CustomResourceDefinition
33
metadata:
44
annotations:
5-
controller-gen.kubebuilder.io/version: v0.11.4
5+
controller-gen.kubebuilder.io/version: v0.12.0
66
name: dosprotectedresources.appprotectdos.f5.com
77
spec:
88
group: appprotectdos.f5.com

helm-charts/nginx-ingress/crds/externaldns.nginx.org_dnsendpoints.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@ apiVersion: apiextensions.k8s.io/v1
22
kind: CustomResourceDefinition
33
metadata:
44
annotations:
5-
controller-gen.kubebuilder.io/version: v0.11.4
5+
controller-gen.kubebuilder.io/version: v0.12.0
66
name: dnsendpoints.externaldns.nginx.org
77
spec:
88
group: externaldns.nginx.org

0 commit comments

Comments
 (0)