DOC: add instructions for hairpin-proxy
This commit is contained in:
parent
dd730bd1d2
commit
d745d5245d
1 changed files with 13 additions and 1 deletions
14
README.md
14
README.md
|
@ -13,13 +13,25 @@
|
|||
ProxyProtocol needs to be enabled for ingress-nginx to see the clients IP in ingress log.
|
||||
|
||||
Add the ProxyProtocol annotation to the ingress-nginx service:
|
||||
|
||||
```
|
||||
annotations:
|
||||
service.beta.kubernetes.io/linode-loadbalancer-proxy-protocol: v2
|
||||
service.beta.kubernetes.io/linode-loadbalancer-proxy-protocol: v2
|
||||
```
|
||||
|
||||
Update the ingress-nginx ConfigMap to make nginx expect ProxyProtocol data:
|
||||
|
||||
```
|
||||
data:
|
||||
use-proxy-protocol: "true"
|
||||
```
|
||||
|
||||
#### cert-manager
|
||||
|
||||
> However, when you have the PROXY protocol enabled, the external load balancer does modify the traffic, prepending the PROXY line before each TCP connection. If you connect directly to the web server internally, bypassing the external load balancer, then it will receive traffic without the PROXY line.
|
||||
>
|
||||
> This is particularly a problem when using cert-manager for provisioning SSL certificates.
|
||||
|
||||
After enabling the PROXY protocol cert-manager is unable to perform a self check ("propagation check failed", "failed to perform self check GET request").
|
||||
|
||||
[hairpin-proxy](https://github.com/compumike/hairpin-proxy) adds PROXY protocol support for internal-to-LoadBalancer traffic for Kubernetes Ingress users, specifically for cert-manager self-checks (no further configuration needed).
|
||||
|
|
Loading…
Reference in a new issue