Skip to content

Commit 6063bfb

Browse files
authored
Merge pull request #78234 from dfitzmau/OCPBUGS-36292
OCPBUGS-36292: Expanded Configuring the PROXY protocol for an Ingress…
2 parents c9ba50d + b0ad7b4 commit 6063bfb

File tree

1 file changed

+7
-7
lines changed

1 file changed

+7
-7
lines changed

modules/nw-ingress-controller-configuration-proxy-protocol.adoc

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -6,18 +6,18 @@
66
[id="nw-ingress-controller-configuration-proxy-protocol_{context}"]
77
= Configuring the PROXY protocol for an Ingress Controller
88

9-
A cluster administrator can configure https://www.haproxy.org/download/1.8/doc/proxy-protocol.txt[the PROXY protocol] when an Ingress Controller uses either the `HostNetwork` or `NodePortService` endpoint publishing strategy types. The PROXY protocol enables the load balancer to preserve the original client addresses for connections that the Ingress Controller receives. The original client addresses are useful for logging, filtering, and injecting HTTP headers. In the default configuration, the connections that the Ingress Controller receives only contain the source address that is associated with the load balancer.
9+
A cluster administrator can configure link:https://www.haproxy.org/download/1.8/doc/proxy-protocol.txt[the PROXY protocol] when an Ingress Controller uses either the `HostNetwork`, `NodePortService`, or `Private` endpoint publishing strategy types. The PROXY protocol enables the load balancer to preserve the original client addresses for connections that the Ingress Controller receives. The original client addresses are useful for logging, filtering, and injecting HTTP headers. In the default configuration, the connections that the Ingress Controller receives only contain the source address that is associated with the load balancer.
1010

11-
This feature is not supported in cloud deployments. This restriction is because when {product-title} runs in a cloud platform, and an IngressController specifies that a service load balancer should be used, the Ingress Operator configures the load balancer service and enables the PROXY protocol based on the platform requirement for preserving source addresses.
12-
13-
[IMPORTANT]
11+
[WARNING]
1412
====
15-
You must configure both {product-title} and the external load balancer to either use the PROXY protocol or to use TCP.
13+
The PROXY protocol is unsupported for the default Ingress Controller with installer-provisioned clusters on non-cloud platforms that use a Keepalived Ingress VIP.
1614
====
1715

18-
[WARNING]
16+
This feature is not supported in cloud deployments. This restriction is because when {product-title} runs in a cloud platform, and an Ingress Controller specifies that a service load balancer should be used, the Ingress Operator configures the load balancer service and enables the PROXY protocol based on the platform requirement for preserving source addresses.
17+
18+
[IMPORTANT]
1919
====
20-
The PROXY protocol is unsupported for the default Ingress Controller with installer-provisioned clusters on non-cloud platforms that use a Keepalived Ingress VIP.
20+
You must configure both {product-title} and the external load balancer to either use the PROXY protocol or to use Transmission Control Protocol (TCP).
2121
====
2222

2323
.Prerequisites

0 commit comments

Comments
 (0)