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

docs: add nginxinc ingress controller example to tasks #1683

Merged
merged 2 commits into from
Oct 3, 2023
Merged

docs: add nginxinc ingress controller example to tasks #1683

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
a1fb65d
docs: add nginxinc ingress controller example to tasks
yohanb Sep 18, 2023
e9939d6
Merge branch 'main' into docs/add_nginx_inc_ingress_to_tasks
yohanb Oct 3, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
44 changes: 42 additions & 2 deletions linkerd.io/content/2.14/tasks/using-ingress.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -69,7 +69,8 @@ details](#ingress-details) below.
Common ingress options that Linkerd has been used with include:

- [Ambassador (aka Emissary)](#ambassador)
- [Nginx](#nginx)
- [Nginx (community version)](#nginx-community-version)
- [Nginx (F5 NGINX version)](#nginx-f5-nginx-version)
- [Traefik](#traefik)
- [Traefik 1.x](#traefik-1x)
- [Traefik 2.x](#traefik-2x)
Expand Down Expand Up @@ -107,7 +108,11 @@ For a more detailed guide, we recommend reading [Installing the Emissary ingress
with the Linkerd service
mesh](https://buoyant.io/2021/05/24/emissary-and-linkerd-the-best-of-both-worlds/).

## Nginx
## Nginx (community version)

This section refers to the Kubernetes community version
of the Nginx ingress controller
[kubernetes/ingress-nginx](https://github.com/kubernetes/ingress-nginx).

Nginx can be meshed normally: it does not require the [ingress
mode](#ingress-mode) annotation.
Expand Down Expand Up @@ -160,6 +165,41 @@ Kubernetes resources:
Setting the injection annotation at the namespace level would mesh the
short-lived pod, which would prevent it from terminating as designed.

## Nginx (F5 NGINX version)

This section refers to the Nginx ingress controller
developed and maintained by F5 NGINX
[nginxinc/kubernetes-ingress](https://github.com/nginxinc/kubernetes-ingress).

This version of Nginx can also be meshed normally
and does not require the [ingress mode](#ingress-mode) annotation.

The [VirtualServer/VirtualServerRoute CRD resource](https://docs.nginx.com/nginx-ingress-controller/configuration/virtualserver-and-virtualserverroute-resources/#virtualserverroute)
should be used in favor of the `ingress` resource (see
[this Github issue](https://github.com/nginxinc/kubernetes-ingress/issues/2529)
for more information).

The `use-cluster-ip` field should be set to `true`. For example:

```yaml
apiVersion: k8s.nginx.org/v1
kind: VirtualServer
metadata:
name: emojivoto-web-ingress
namespace: emojivoto
spec:
ingressClassName: nginx
upstreams:
- name: web
service: web-svc
port: 80
use-cluster-ip: true
routes:
- path: /
action:
pass: web
```

## Traefik

Traefik should be meshed with [ingress mode enabled](#ingress-mode), i.e. with
Expand Down
Loading