Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Update operator docs for latest release #2752

Merged
merged 1 commit into from
Jun 13, 2022
Merged

Update operator docs for latest release #2752

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
39 changes: 21 additions & 18 deletions docs/content/installation/installation-with-operator.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,10 +8,6 @@ toc: true
docs: "DOCS-604"
---

{{< note >}}
An NGINX Ingress Operator version compatible with the 2.2.2 NGINX Ingress Controller release is not available yet. We will update this document and remove this note once we publish a compatible Operator version.
{{< /note >}}

This document describes how to install the NGINX Ingress Controller in your Kubernetes cluster using the NGINX Ingress Operator.

## Prerequisites
Expand All @@ -21,29 +17,36 @@ This document describes how to install the NGINX Ingress Controller in your Kube
* 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.
* 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).
* 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).
1. Install the NGINX Ingress Operator following the [instructions](https://github.com/nginxinc/nginx-ingress-operator/blob/main/docs/installation.md).
2. Install the NGINX Ingress Operator following the [instructions](https://github.com/nginxinc/nginx-ingress-helm-operator/blob/v1.0.0/docs/installation.md).
3. Create the default server secret and SecurityContextConstraint as oulined in the [instructions](https://github.com/nginxinc/nginx-ingress-helm-operator/blob/v1.0.0/docs/installation.md).

## 1. Create the NginxIngressController manifest

Create a manifest `nginx-ingress-controller.yaml` with the following content:

```yaml
apiVersion: k8s.nginx.org/v1alpha1
kind: NginxIngressController
apiVersion: charts.nginx.org/v1alpha1
kind: NginxIngress
metadata:
name: my-nginx-ingress-controller
namespace: default
name: nginxingress-sample
namespace: nginx-ingress
spec:
type: deployment
image:
repository: nginx/nginx-ingress
tag: 2.2.2
pullPolicy: Always
serviceType: NodePort
nginxPlus: False
controller:
defaultTLS:
secret: nginx-ingress/default-server-secret
image:
pullPolicy: IfNotPresent
repository: nginx/nginx-ingress
tag: 2.2.2-ubi
ingressClass: nginx
kind: deployment
nginxplus: false
replicaCount: 1
serviceAccount:
imagePullSecretName: ""
```

**Note:** For NGINX Plus, change the `image.repository` and `image.tag` values and change `nginxPlus` to `True`.
**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 precreated docker config secret that should be associated with the ServiceAccount.

## 2. Create the NginxIngressController

Expand All @@ -53,4 +56,4 @@ $ kubectl apply -f nginx-ingress-controller.yaml

A new instance of the NGINX Ingress Controller will be deployed by the NGINX Ingress Operator in the `default` namespace with default parameters.

To configure other parameters of the NginxIngressController resource, check the [documentation](https://github.com/nginxinc/nginx-ingress-operator/blob/main/docs/nginx-ingress-controller.md).
To configure other parameters of the NginxIngressController resource, check the [documentation](https://github.com/nginxinc/nginx-ingress-helm-operator/blob/v1.0.0/docs/nginx-ingress-controller.md).