Skip to content

Commit 10b4ab6

Browse files
committed
reorder sections, add configuration reqs, add URLs
1 parent 50b4c9f commit 10b4ab6

File tree

2 files changed

+30
-10
lines changed

2 files changed

+30
-10
lines changed

articles/azure-arc/resource-bridge/includes/network-requirements.md

Lines changed: 4 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,4 @@
11
---
2-
author: MikeRayMSFT
3-
ms.author: mikeray
4-
ms.service: azure-arc
52
ms.topic: include
63
ms.date: 01/27/2023
74
---
@@ -22,10 +19,7 @@ The firewall and proxy URLs below must be allowlisted in order to enable communi
2219
|Azure Arc for Kubernetes container image download| 443 | `https://azurearcfork8sdev.azurecr.io`| Appliance VM IP and Control Plane IP need outbound connection. | Required to pull container images. |
2320
|ADHS telemetry service | 443 | `adhs.events.data.microsoft.com`| Appliance VM IP and Control Plane IP need outbound connection. | Runs inside the appliance/mariner OS. Used periodically to send Microsoft required diagnostic data from control plane nodes. Used when telemetry is coming off Mariner, which would mean any Kubernetes control plane. |
2421
|Microsoft events data service | 443 |`v20.events.data.microsoft.com`| Appliance VM IP and Control Plane IP need outbound connection. | Used periodically to send Microsoft required diagnostic data from the Azure Stack HCI or Windows Server host. Used when telemetry is coming off Windows like Windows Server or HCI. |
25-
26-
### SSL proxy configuration
27-
28-
Azure Arc resource bridge must be configured for proxy so that it can connect to the Azure services. This configuration is handled automatically. However, proxy configuration of the management machine isn't configured by the Azure Arc resource bridge.
29-
30-
There are only two certificates that should be relevant when deploying the Arc resource bridge behind an SSL proxy: the SSL certificate for your SSL proxy (so that the host and guest trust your proxy FQDN and can establish an SSL connection to it), and the SSL certificate of the Microsoft download servers. This certificate must be trusted by your proxy server itself, as the proxy is the one establishing the final connection and needs to trust the endpoint. Non-Windows machines may not trust this second certificate by default, so you may need to ensure that it's trusted.
31-
22+
|Log collection for Arc Resource Bridge| 443 | `linuxgeneva-microsoft.azurecr.io`| Appliance VM IP and Control Plane IP need outbound connection. | Push logs for Appliance managed components.|
23+
|Resource bridge components download| 443 | `kvamanagementoperator.azurecr.io`| Appliance VM IP and Control Plane IP need outbound connection. | Required to pull artifacts for Appliance managed components.|
24+
|Microsoft Container Registry| 443 | `https://mcr.microsoft.com`| Management machine, Appliance VM IP and Control Plane IP need outbound connection. | Download container images for Arc Resource Bridge.|
25+
|Custom Locations| 443 | `sts.windows.net`| Appliance VM IP and Control Plane IP need outbound connection. | Required for use by the Custom Locations cluster extension.|

articles/azure-arc/resource-bridge/network-requirements.md

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,26 @@ ms.date: 01/27/2023
99

1010
This article describes the networking requirements for deploying Azure Arc resource bridge (preview) in your enterprise.
1111

12+
## Configuration requirements
13+
14+
### Static Configuration
15+
16+
Static configuration is recommended for Arc resource bridge because the resource bridge needs three static IPs in the same subnet for the control plane, appliance VM, and reserved appliance VM (for upgrade). The control plane corresponds to the `controlplanenedpoint` parameter, the appliance VM IP to `k8snodeippoolstart`, and reserved appliance VM to `k8snodeippoolend` in the `createconfig` command that creates the bridge configuration files. If using DHCP, reserve those IP addresses, ensuring they are outside the DHCP range.
17+
18+
### IP Address Prefix
19+
20+
The subnet of the IP addresses for Arc resource bridge must lie in the IP address prefix that is passed in the `ipaddressprefix` parameter of the `createconfig` command. The IP address prefix is the IP prefix that is exposed by the network to which Arc resource bridge is connected. It is entered as the subnet's IP address range for the virtual network and subnet mask (IP Mask) in CIDR notation, for example `192.168.7.1/24`. Consult your system or network administrator to obtain the IP address prefix in CIDR notation. An IP Subnet CIDR calculator may be used to obtain this value.
21+
22+
### Gateway
23+
24+
The gateway address provided in the `createconfig` command must be in the same subnet specified in the IP address prefix.
25+
26+
### DNS Server
27+
28+
DNS Server must have internal and external endpoint resolution. The appliance VM and control plane need to resolve the management machine and vice versa. All three must be able to reach the required URLs for deployment.
29+
30+
## General network requirements
31+
1232
[!INCLUDE [network-requirement-principles](../includes/network-requirement-principles.md)]
1333

1434
[!INCLUDE [network-requirements](includes/network-requirements.md)]
@@ -20,6 +40,12 @@ In addition, resource bridge (preview) requires [Arc-enabled Kubernetes endpoint
2040
> [!NOTE]
2141
> The URLs listed here are required for Arc resource bridge only. Other Arc products (such as Arc-enabled VMware vSphere) may have additional required URLs. For details, see [Azure Arc network requirements](../network-requirements-consolidated.md).
2242
43+
## SSL proxy configuration
44+
45+
Azure Arc resource bridge must be configured for proxy so that it can connect to the Azure services. This configuration is handled automatically. However, proxy configuration of the management machine isn't configured by the Azure Arc resource bridge.
46+
47+
There are only two certificates that should be relevant when deploying the Arc resource bridge behind an SSL proxy: the SSL certificate for your SSL proxy (so that the host and guest trust your proxy FQDN and can establish an SSL connection to it), and the SSL certificate of the Microsoft download servers. This certificate must be trusted by your proxy server itself, as the proxy is the one establishing the final connection and needs to trust the endpoint. Non-Windows machines may not trust this second certificate by default, so you may need to ensure that it's trusted.
48+
2349
## Next steps
2450

2551
- Review the [Azure Arc resource bridge (preview) overview](overview.md) to understand more about requirements and technical details.

0 commit comments

Comments
 (0)