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: docs/content/installation/installation-with-operator.md
+22-9Lines changed: 22 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -8,17 +8,22 @@ toc: true
8
8
docs: "DOCS-604"
9
9
---
10
10
11
-
This document describes how to install the F5 NGINX Ingress Controller in your Kubernetes cluster using the NGINX Ingress Operator.
11
+
This document describes how to install the F5 NGINX Ingress Controller in your Kubernetes cluster using the
12
+
NGINX Ingress Operator.
12
13
13
14
## Prerequisites
14
15
15
-
{{<note>}} All documentation should only be used with the latest stable release, indicated on [the releases page](https://github.com/nginxinc/kubernetes-ingress/releases) of the GitHub repository. {{</note>}}
16
+
**Note** All documentation should only be used with the latest stable release, indicated on
17
+
[the releases page](https://github.com/nginxinc/kubernetes-ingress/releases) of the GitHub repository.
16
18
17
19
1. Make sure you have access to the Ingress Controller image:
18
20
- For NGINX Ingress Controller, use the image `nginx/nginx-ingress` from [DockerHub](https://hub.docker.com/r/nginx/nginx-ingress).
19
-
- For NGINX Plus Ingress Controller, see [here](/nginx-ingress-controller/installation/pulling-ingress-controller-image) for details on how to pull the image from the F5 Docker registry.
20
-
- 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](/nginx-ingress-controller/installation/using-the-jwt-token-docker-secret).
21
-
- It is also possible to build your own image and push it to your private Docker registry by following the instructions from [here](/nginx-ingress-controller/installation/building-ingress-controller-image).
21
+
- For NGINX Plus Ingress Controller, see [here](/nginx-ingress-controller/installation/pulling-ingress-controller-image)
22
+
for details on how to pull the image from the F5 Docker registry.
23
+
- To pull from the F5 Container registry, configure a docker registry secret using your JWT token from the MyF5 portal
24
+
by following the instructions from [here](/nginx-ingress-controller/installation/using-the-jwt-token-docker-secret).
25
+
- It is also possible to build your own image and push it to your private Docker registry by following the instructions
26
+
from [here](/nginx-ingress-controller/installation/building-ingress-controller-image).
22
27
2. Install the NGINX Ingress Operator following the [instructions](https://github.com/nginxinc/nginx-ingress-helm-operator/blob/v2.0.0/docs/installation.md).
23
28
3. Create the SecurityContextConstraint as outlined in the ["Getting Started" instructions](https://github.com/nginxinc/nginx-ingress-helm-operator/blob/v2.0.0/README.md#getting-started).
24
29
@@ -38,24 +43,32 @@ spec:
38
43
pullPolicy: IfNotPresent
39
44
repository: nginx/nginx-ingress
40
45
tag: 3.3.0-ubi
41
-
ingressClass: nginx
46
+
ingressClass:
47
+
name: nginx
42
48
kind: deployment
43
49
nginxplus: false
44
50
replicaCount: 1
45
51
serviceAccount:
46
52
imagePullSecretName: ""
47
53
```
48
54
49
-
**Note:** For NGINX Plus, change the `image.repository` and `image.tag` values and change `nginxPlus` to `True`. If required, set the `serviceAccount.imagePullSecretName` to the name of the pre-created docker config secret that should be associated with the ServiceAccount.
55
+
**Note:** For NGINX Plus, change the `image.repository` and `image.tag` values and change `nginxPlus` to `True`.
56
+
If required, set the `serviceAccount.imagePullSecretName` to the name of the pre-created docker config secret that
57
+
should be associated with the ServiceAccount.
50
58
51
59
## 2. Create the NginxIngressController
52
60
53
61
```console
54
62
kubectl apply -f nginx-ingress-controller.yaml
55
63
```
56
64
57
-
A new instance of the NGINX Ingress Controller will be deployed by the NGINX Ingress Operator in the `default` namespace with default parameters.
65
+
A new instance of the NGINX Ingress Controller will be deployed by the NGINX Ingress Operator in the `default`
66
+
namespace with default parameters.
58
67
59
68
To configure other parameters of the NginxIngressController resource, check the [documentation](https://github.com/nginxinc/nginx-ingress-helm-operator/blob/v2.0.0/docs/nginx-ingress-controller.md).
60
69
61
-
**Note:** Some users reported an `OOMkilled` error when they deployed the NGINX Ingress Operator in a large cluster with multiple namespaces and Kubernetes objects. This is due to the helm operator caching every Kubernetes object in the cluster, and thus consuming too much system memory. If you encounter this issue, consider setting the operator to only watch one namespace. If watching multiple namespaces is required in your use case, try manually increasing the memory limit for the operator. Note that the value might be overwritten after a release update. We are working with the OpenShift team to resolve this issue.
70
+
**Note:** Some users reported an `OOMkilled` error when they deployed the NGINX Ingress Operator in a large cluster with
71
+
multiple namespaces and Kubernetes objects. This is due to the helm operator caching every Kubernetes object in the cluster,
72
+
and thus consuming too much system memory. If you encounter this issue, consider setting the operator to only watch one namespace.
73
+
If watching multiple namespaces is required in your use case, try manually increasing the memory limit for the operator.
74
+
Note that the value might be overwritten after a release update. We are working with the OpenShift team to resolve this issue.
0 commit comments