Skip to content

Commit 750b269

Browse files
committed
Removed isolation domain commands from quick-start and provided a link to how-to guide
1 parent 98be354 commit 750b269

File tree

3 files changed

+16
-128
lines changed

3 files changed

+16
-128
lines changed

articles/operator-nexus/includes/l2-isolation-domain.md

Lines changed: 0 additions & 33 deletions
This file was deleted.

articles/operator-nexus/includes/l3-isolation-domain.md

Lines changed: 0 additions & 57 deletions
This file was deleted.

articles/operator-nexus/quickstarts-tenant-workload-prerequisites.md

Lines changed: 16 additions & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -32,34 +32,11 @@ You need to create various networks based on your workload needs. The following
3232
- Determine the BGP peering info for each network, and whether the networks need to talk to each other. You should group networks that need to talk to each other into the same L3 isolation domain, because each L3 isolation domain can support multiple L3 networks.
3333
- The platform provides a proxy to allow your VM to reach other external endpoints. Creating a `cloudservicesnetwork` instance requires the endpoints to be proxied, so gather the list of endpoints. You can modify the list of endpoints after the network creation.
3434

35-
## Create networks for tenant workloads
36-
37-
The following sections explain the steps to create networks for tenant workloads (VMs and Kubernetes clusters).
38-
39-
### Create isolation domains
40-
41-
Isolation domains enable creation of layer 2 (L2) and layer 3 (L3) connectivity between network functions running on Azure Operator Nexus. This connectivity enables inter-rack and intra-rack communication between the workloads.
42-
You can create as many L2 and L3 isolation domains as needed.
43-
44-
You should have the following information already:
35+
## Create isolation domains
4536

46-
- The network fabric resource ID to create isolation domains.
47-
- VLAN and subnet info for each L3 network.
48-
- Which networks need to talk to each other. (Remember to put VLANs and subnets that need to talk to each other into the same L3 isolation domain.)
49-
- BGP peering and network policy information for your L3 isolation domains.
50-
- VLANs for all your L2 networks.
51-
- VLANs for all your trunked networks.
52-
- MTU values for your networks.
37+
The isolation-domains enable communication between workloads hosted in the same rack (intra-rack communication) or different racks (inter-rack communication). You can find more details about creating isolation domains [here](./howto-configure-isolation-domain.md).
5338

54-
#### L2 isolation domain
55-
56-
[!INCLUDE [l2-isolation-domain](./includes/l2-isolation-domain.md)]
57-
58-
#### L3 isolation domain
59-
60-
[!INCLUDE [l3-isolation-domain](./includes/l3-isolation-domain.md)]
61-
62-
### Create networks for tenant workloads
39+
## Create networks for tenant workloads
6340

6441
The following sections describe how to create these networks:
6542

@@ -68,13 +45,13 @@ The following sections describe how to create these networks:
6845
- Trunked network
6946
- Cloud services network
7047

71-
#### Create an L2 network
48+
### Create an L2 network
7249

7350
Create an L2 network, if necessary, for your workloads. You can repeat the instructions for each required L2 network.
7451

7552
Gather the resource ID of the L2 isolation domain that you [created](#l2-isolation-domain) to configure the VLAN for this network.
7653

77-
### [Azure CLI](#tab/azure-cli)
54+
#### [Azure CLI](#tab/azure-cli)
7855

7956
```azurecli-interactive
8057
az networkcloud l2network create --name "<YourL2NetworkName>" \
@@ -85,7 +62,7 @@ Gather the resource ID of the L2 isolation domain that you [created](#l2-isolati
8562
--l2-isolation-domain-id "<YourL2IsolationDomainId>"
8663
```
8764

88-
### [Azure PowerShell](#tab/azure-powershell)
65+
#### [Azure PowerShell](#tab/azure-powershell)
8966

9067
```azurepowershell-interactive
9168
New-AzNetworkCloudL2Network -Name "<YourL2NetworkName>" `
@@ -100,7 +77,7 @@ New-AzNetworkCloudL2Network -Name "<YourL2NetworkName>" `
10077

10178
---
10279

103-
#### Create an L3 network
80+
### Create an L3 network
10481

10582
Create an L3 network, if necessary, for your workloads. Repeat the instructions for each required L3 network.
10683

@@ -112,7 +89,7 @@ You need:
11289
- The `ip-allocation-type` value, which can be `IPv4`, `IPv6`, or `DualStack` (default).
11390
- The `vlan` value, which must match what's in the L3 isolation domain.
11491

115-
### [Azure CLI](#tab/azure-cli)
92+
#### [Azure CLI](#tab/azure-cli)
11693

11794
```azurecli-interactive
11895
az networkcloud l3network create --name "<YourL3NetworkName>" \
@@ -127,7 +104,7 @@ You need:
127104
--vlan <YourNetworkVlan>
128105
```
129106

130-
### [Azure PowerShell](#tab/azure-powershell)
107+
#### [Azure PowerShell](#tab/azure-powershell)
131108

132109
```azurepowershell-interactive
133110
New-AzNetworkCloudL3Network -Name "<YourL3NetworkName>" `
@@ -144,13 +121,13 @@ New-AzNetworkCloudL3Network -Name "<YourL3NetworkName>" `
144121

145122
---
146123

147-
#### Create a trunked network
124+
### Create a trunked network
148125

149126
Create a trunked network, if necessary, for your VM. Repeat the instructions for each required trunked network.
150127

151128
Gather the `resourceId` values of the L2 and L3 isolation domains that you created earlier to configure the VLANs for this network. You can include as many L2 and L3 isolation domains as needed.
152129

153-
### [Azure CLI](#tab/azure-cli)
130+
#### [Azure CLI](#tab/azure-cli)
154131

155132
```azurecli-interactive
156133
az networkcloud trunkednetwork create --name "<YourTrunkedNetworkName>" \
@@ -167,7 +144,8 @@ Gather the `resourceId` values of the L2 and L3 isolation domains that you creat
167144
"<YourL3IsolationDomainId3>" \
168145
--vlans <YourVlanList>
169146
```
170-
### [Azure PowerShell](#tab/azure-powershell)
147+
148+
#### [Azure PowerShell](#tab/azure-powershell)
171149

172150
```azurepowershell-interactive
173151
New-AzNetworkCloudTrunkedNetwork -Name "<YourTrunkedNetworkName>" `
@@ -183,7 +161,7 @@ New-AzNetworkCloudTrunkedNetwork -Name "<YourTrunkedNetworkName>" `
183161

184162
---
185163

186-
#### Create a cloud services network
164+
### Create a cloud services network
187165

188166
To create an Operator Nexus virtual machine (VM) or Operator Nexus Kubernetes cluster, you must have a cloud services network. Without this network, you can't create a VM or cluster.
189167

@@ -197,7 +175,7 @@ The egress endpoints must comply with the domain name structures and hostname sp
197175
- `api.v1.contoso.com`: Incorporates two subdomains (`v1` and `api`) above the base domain contoso.com.
198176
- `.api.contoso.com`: A wildcard for any subdomain under `api.contoso.com`, covering multiple third-level domains.
199177

200-
### [Azure CLI](#tab/azure-cli)
178+
#### [Azure CLI](#tab/azure-cli)
201179

202180
```azurecli-interactive
203181
az networkcloud cloudservicesnetwork create --name "<YourCloudServicesNetworkName>" \
@@ -208,7 +186,7 @@ The egress endpoints must comply with the domain name structures and hostname sp
208186
--additional-egress-endpoints "[{\"category\":\"<YourCategory >\",\"endpoints\":[{\"<domainName1 >\":\"< endpoint1 >\",\"port\":<portnumber1 >}]}]"
209187
```
210188

211-
### [Azure PowerShell](#tab/azure-powershell)
189+
#### [Azure PowerShell](#tab/azure-powershell)
212190

213191
```azurepowershell-interactive
214192
$endpointEgressList = @()

0 commit comments

Comments
 (0)