Skip to content

Commit d2a49b3

Browse files
Merge pull request #17846 from abhilashaagarwala/patch-85
Update configure-proxy-settings-23h2.md
2 parents 7e2e128 + 45785db commit d2a49b3

File tree

1 file changed

+7
-7
lines changed

1 file changed

+7
-7
lines changed

azure-local/manage/configure-proxy-settings-23h2.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,7 @@ Here are some important considerations to keep in mind before you configure prox
2727
- Understand that proxy settings are separate for different components and features of Azure Local (`WinInet`,`WinHTTP`, and `Environment Variables`). You must configure the proxy settings for all the required components and any other features that you plan on using.
2828
- Although each component has specific command parameters and proxy bypass list string requirements, we recommend keeping the same proxy configuration across the different component and features.
2929
- Authenticated proxies using username and password aren't supported due to security constraints.
30+
- Proxy server endpoints with a `.local` domain aren't supported. For example - `http://proxy.contosos.local`.
3031
- If you're using SSL inspection in your proxy, you need to bypass the required Azure Local and its components (Arc Resource Bridge, Azure Kubernetes Service (AKS), etc.) outbound URLs.
3132
- Each of the three proxy components on the operating system has specific proxy bypass list string requirements. Don't use the same string for all three components.
3233
- Proxy Auto-Configuration (PAC) files aren't supported.
@@ -165,7 +166,7 @@ When configuring the `WinHTTP` proxy bypass list string, keep the following poin
165166
166167
## Configure proxy settings for Environment Variables
167168
168-
You must configure the proxy for Azure Resource Bridge and AKS before you [Register the machines with Azure Arc](../deploy/deployment-arc-register-server-permissions.md).
169+
You must configure the proxy for Azure Resource Bridge, AKS and Arc enabled Kubernetes agents before you [Register the machines with Azure Arc](../deploy/deployment-arc-register-server-permissions.md).
169170
170171
To set the proxy server Environment Variable, run the following commands as administrator on each machine in the system:
171172
@@ -186,7 +187,7 @@ The parameters are described in the following table:
186187
|---|---|
187188
| HTTPS_PROXY variable | Specifies the proxy server endpoint in the format `http://[Proxy_Server_Address]:[Proxy_Port]`. For example, `http://proxy.contoso.com:8080`. |
188189
| HTTP_PROXY variable | Specifies the proxy server endpoint in the format `http://[Proxy_Server_Address]:[Proxy_Port]`. For example, `http://proxy.contoso.com:8080`. |
189-
| NO_PROXY variable | String to bypass local intranet URLs, domains, and subnets. On your Azure Local the list must include:<br><br>- At least the IP address of each machine.<br>- At least the IP address of system.<br>- At least the IPs you defined for your infrastructure network. Arc Resource Bridge, AKS, and future infrastructure services using these IPs require outbound connectivity.<br>- Or you can bypass the entire infrastructure subnet.<br>- NetBIOS name of each machine.<br>- NetBIOS name of the system.<br>- Domain name or domain name with dot `.` wildcard for any host or subdomain.<br>- `.svc` for internal Kubernetes service traffic.|
190+
| NO_PROXY variable | String to bypass local intranet URLs, domains, and subnets. On your Azure Local the list must include: <br><br>- At least the IP address of each machine. <br>- At least the IP address of system. <br>- NetBIOS name of each machine. <br>- NetBIOS name of the system. <br>- Domain name or domain name with dot `.` wildcard for any host or subdomain. <br>- At least the IPs you defined for your infrastructure network. Arc Resource Bridge, and future infrastructure services using these IPs require outbound connectivity. <br>- Or you can bypass the entire infrastructure subnet. <br>- The subnets on which you plan on deploying your AKS clusters. <br>- `.svc`, `kubernetes.default.svc` and `.svc.cluster.local` for internal Kubernetes service traffic. <br>- `10.0.0.0/8`, `172.16.0.0/12` and `192.168.0.0/16`. These subnets are required for creating AKS clusters and Azure Arc agents. |
190191

191192
Here's an example of the command usage:
192193

@@ -195,7 +196,7 @@ Here's an example of the command usage:
195196
$env:HTTPS_PROXY = [System.Environment]::GetEnvironmentVariable("HTTPS_PROXY", "Machine")
196197
[Environment]::SetEnvironmentVariable("HTTP_PROXY", "http://192.168.1.250:8080", "Machine")
197198
$env:HTTP_PROXY = [System.Environment]::GetEnvironmentVariable("HTTP_PROXY", "Machine")
198-
$no_proxy = "localhost,127.0.0.1,.svc,192.168.1.0/24,.contoso.com,node1,node2,s-cluster"
199+
$no_proxy = "localhost,127.0.0.1,.svc,kubernetes.default.svc,.svc.cluster.local,192.168.1.0/24,10.0.0.0/8,172.16.0.0/12,192.168.0.0/16,.contoso.com,node1,node2,s-cluster"
199200
[Environment]::SetEnvironmentVariable("NO_PROXY", $no_proxy, "Machine")
200201
$env:NO_PROXY = [System.Environment]::GetEnvironmentVariable("NO_PROXY", "Machine")
201202
```
@@ -209,9 +210,8 @@ When configuring the Environment Variables proxy bypass list string, keep the fo
209210
- Asterisk `*` as wildcards to bypass subnets or domain names isn't supported.
210211
- Dots `.` Should be used as wildcards to bypass domain names or local services. For example `.contoso.com` or `.svc`.
211212
- Proxy name must be specified with `http://` and the port for both HTTP_PROXY and HTTPS_PROXY variables. For example, `http://192.168.1.250:8080`.
212-
- `.svc` bypass is for AKS internal services communication in Linux notation. This is required for Arc Resource Bridge and AKS.
213-
- AKS requires to bypass the following subnets. 10.0.0.0/8, 172.16.0.0/12 and 192.168.0.0/16. These subnets will be added to the Environment Variables bypass list automatically if they aren't defined.
214-
- The use of `<local>` strings isn't supported in the proxy bypass list.
213+
- `.svc`, `kubernetes.default.svc` and `.svc.cluster.local` bypass is for AKS internal services communication in Linux notation. This is required for Arc Resource Bridge and AKS.
214+
- AKS requires to bypass the following subnets. `10.0.0.0/8`, `172.16.0.0/12` and `192.168.0.0/16`. These subnets will be added to the Environment Variables bypass list automatically if they aren't defined.
215215

216216
### Confirm and remove the Environment Variables proxy configuration
217217

@@ -269,4 +269,4 @@ If you're using or plan to use any of the following Azure services, refer to the
269269

270270
For more information, see:
271271

272-
- [Firewall requirements for Azure Local](../concepts/firewall-requirements.md).
272+
- [Firewall requirements for Azure Local](../concepts/firewall-requirements.md).

0 commit comments

Comments
 (0)