Skip to content

Commit b1443d1

Browse files
authored
Merge pull request #75056 from mburke5678/winc-cluster-wide-proxy-limitation
Add details on WMCO and cluster-wide proxy
2 parents 2033ee2 + 9a44dd0 commit b1443d1

File tree

2 files changed

+27
-0
lines changed

2 files changed

+27
-0
lines changed

modules/wmco-cluster-wide-proxy.adoc

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
// Module included in the following assemblies:
2+
//
3+
// windows_containers/enabling-windows-container-workloads.adoc
4+
5+
:_mod-docs-content-type: CONCEPT
6+
[id="wmco-cluster-wide-proxy_{context}"]
7+
= Using Windows containers in a proxy-enabled cluster
8+
9+
The Windows Machine Config Operator (WMCO) can consume and use a cluster-wide egress proxy configuration when making external requests outside the cluster’s internal network.
10+
11+
This allows you to add Windows nodes and run workloads in a proxy-enabled cluster, allowing your Windows nodes to pull images from registries that are secured behind your proxy server or to make
12+
requests to off-cluster services and services that use a custom public key infrastructure.
13+
14+
[NOTE]
15+
====
16+
The cluster-wide proxy affects system components only, not user workloads.
17+
====
18+
19+
In proxy-enabled clusters, the WMCO is aware of the `NO_PROXY`, `HTTP_PROXY`, and `HTTPS_PROXY` values that are set for the cluster. The WMCO periodically checks whether the proxy environment variables have changed. If there is a discrepancy, the WMCO reconciles and updates the proxy environment variables on the Windows instances.
20+
21+
Windows workloads created on Windows nodes in proxy-enabled clusters do not inherit proxy settings from the node by default, the same as with Linux nodes. Also, by default PowerShell sessions do not inherit proxy settings on Windows nodes in proxy-enabled clusters.

windows_containers/enabling-windows-container-workloads.adoc

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -46,6 +46,12 @@ include::modules/installing-wmco-using-cli.adoc[leveloffset=+2]
4646

4747
include::modules/configuring-secret-for-wmco.adoc[leveloffset=+1]
4848

49+
include::modules/wmco-cluster-wide-proxy.adoc[leveloffset=+1]
50+
51+
.Additional references
52+
53+
* xref:../networking/enable-cluster-wide-proxy.adoc#enable-cluster-wide-proxy[Configuring the cluster-wide proxy].
54+
4955

5056
[role="_additional-resources"]
5157
== Additional resources

0 commit comments

Comments
 (0)