Skip to content

Commit

Permalink
Improve docs for multiple instances of controller on one cluster (#10882
Browse files Browse the repository at this point in the history
)

* Added note to include '--ingress-class-by-name=true' for Multiple Ingress controllers instruction.

* Add note to include '-ingress-class-by-name=true' for Multiple Controllers instruction.
  • Loading branch information
phuang07 authored Jan 19, 2024
1 parent bf84f0e commit 66cbd57
Showing 1 changed file with 4 additions and 1 deletion.
5 changes: 4 additions & 1 deletion docs/user-guide/multiple-ingress.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,9 @@ But, when user has deployed with `scope.enabled`, then the ingress class resourc

If all ingress controllers respect IngressClasses (e.g. multiple instances of ingress-nginx v1.0), you can deploy two Ingress controllers by granting them control over two different IngressClasses, then selecting one of the two IngressClasses with `ingressClassName`.

First, ensure the `--controller-class=` and `--ingress-class` are set to something different on each ingress controller, If your additional ingress controller is to be installed in a namespace, where there is/are one/more-than-one ingress-nginx-controller(s) already installed, then you need to specify a different unique `--election-id` for the new instance of the controller.
First, ensure the `--controller-class=` and `--ingress-class` are set to something different on each ingress controller, If your additional ingress controller is to be installed in a namespace, where there is/are one/more-than-one ingress-nginx-controller(s) already installed, then you need to specify a different unique `--election-id` for the new instance of the controller.

In addition, you need to specify `--ingress-class-by-name=true` in the controller args list. The `--ingress-class-by-name` defines if Ingress Controller should watch for Ingress Class by Name together with Controller Class. (default false).

```yaml
# ingress-nginx Deployment/Statefulset
Expand All @@ -24,6 +26,7 @@ spec:
- '--election-id=ingress-controller-leader'
- '--controller-class=k8s.io/internal-ingress-nginx'
- '--ingress-class=internal-nginx'
- '--ingress-class-by-name=true'
...
```

Expand Down

0 comments on commit 66cbd57

Please sign in to comment.