Skip to content

Commit 17b0e2c

Browse files
author
Kristopher Turner
committed
refactor: restructure SDN operations and clean up content
- Delete redundant task-02-enable-sdn-integration.mdx (covered by post-deployment) - Rename task-03 (NSGs) to task-02, renumber steps - Rename phase from 'SDN Integration' to 'SDN Operations' - Add tip callout linking to post-deployment SDN doc - Fix stale 'Task 2: Enable SDN Integration' reference in script output - Replace 'Azure Local Cloudnology Team' with 'AzureLocal' in frontmatter and version history - Remove 'Azure Local Cloud' branding from recommendation section - Align resource names to naming standards (rg-azlocal-prod-eus-001, nsg-azlocal-prod-web) - Update navigation links across all remaining files
1 parent da72451 commit 17b0e2c

5 files changed

Lines changed: 41 additions & 533 deletions

File tree

docs/implementation/05-operational-foundations/phase-01-sdn-deployment/_category_.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
{
2-
"label": "Phase 01: SDN Integration",
2+
"label": "Phase 01: SDN Operations",
33
"position": 1,
44
"collapsible": true,
55
"collapsed": true

docs/implementation/05-operational-foundations/phase-01-sdn-deployment/index.mdx

Lines changed: 13 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,24 @@
11
---
2-
title: "Phase 01: SDN Integration (Optional)"
3-
sidebar_label: "Phase 01: SDN Integration"
2+
title: "Phase 01: SDN Operations (Optional)"
3+
sidebar_label: "Phase 01: SDN Operations"
44
sidebar_position: 1
5-
description: "Enable Software Defined Networking integration via Azure Arc for Azure Local (Optional)"
5+
description: "SDN prerequisites validation and NSG configuration for Azure Local — deployment is covered in Post-Deployment"
66
---
77

8-
# Phase 01: SDN Integration (Optional)
8+
# Phase 01: SDN Operations (Optional)
99

1010
[![Runbook](https://img.shields.io/badge/Type-Runbook-blue?style=flat-square)](./index.mdx)
1111
[![Azure](https://img.shields.io/badge/Platform-Azure_Local-0078D4?style=flat-square&logo=microsoftazure)](https://learn.microsoft.com/en-us/azure/azure-local/)
1212

1313
> **DOCUMENT CATEGORY**: Runbook
14-
> **SCOPE**: Software Defined Networking Integration
15-
> **PURPOSE**: Enable optional SDN features via Azure Arc
14+
> **SCOPE**: SDN prerequisites validation and NSG configuration
15+
> **PURPOSE**: Validate readiness before SDN deployment and configure NSGs after enablement
1616
> **MASTER REFERENCE**: [Microsoft Learn - SDN Overview](https://learn.microsoft.com/en-us/azure/azure-local/concepts/sdn-overview)
1717
18+
:::tip SDN Deployment
19+
The actual SDN enablement procedure is in [Post-Deployment: Deploy SDN](../../04-cluster-deployment/phase-06-post-deployment/task-01-deploy-sdn.mdx). This section covers the **before** (prerequisites) and **after** (NSG configuration) steps.
20+
:::
21+
1822
**Status**: Active
1923

2024
---
@@ -83,9 +87,9 @@ The following traditional SDN resources are **NOT available** with SDN enabled b
8387
| AKS on Azure Local | ❌ Not Supported with SDN |
8488
| Multi-cast workloads | ❌ Not Supported (unicast only) |
8589

86-
## Azure Local Cloud Recommendation
90+
## Recommendation
8791

88-
:::tip Azure Local Cloud Position on SDN
92+
:::tip Position on SDN
8993
**We recommend enabling SDN** for Azure Local deployments to leverage:
9094

9195
- **Network Security Groups (NSGs)** - Micro-segmentation for Azure Local VMs
@@ -131,8 +135,7 @@ SDN enabled by Arc supports specific Network ATC intent configurations:
131135
| Step | Title | Description |
132136
|------|-------|-------------|
133137
| 1 | [Validate SDN Prerequisites](task-01-validate-sdn-prerequisites.mdx) | Verify network intent compatibility and requirements |
134-
| 2 | [Enable SDN Integration](task-02-enable-sdn-integration.mdx) | Enable SDN via PowerShell `Add-EceFeature` |
135-
| 3 | [Configure Network Security Groups](task-03-configure-network-security-groups.mdx) | Create and apply NSGs to logical networks and VM NICs |
138+
| 2 | [Configure Network Security Groups](task-02-configure-network-security-groups.mdx) | Create and apply NSGs to logical networks and VM NICs |
136139

137140
## Prerequisites
138141

docs/implementation/05-operational-foundations/phase-01-sdn-deployment/task-01-validate-sdn-prerequisites.mdx

Lines changed: 10 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -6,10 +6,10 @@ description: "Verify network intent compatibility and requirements before enabli
66
category: "Runbook"
77
scope: "Verify network intent compatibility and requirements before enabling SDN on A..."
88
purpose: "Verify network intent compatibility and requirements before enabling SDN on Azure Local"
9-
author: "Azure Local Cloudnology Team"
9+
author: "AzureLocal"
1010
created: 2025-03-25
11-
updated: 2025-03-25
12-
version: "1.0.0"
11+
updated: 2026-04-01
12+
version: "1.1.0"
1313
tags:
1414
- azure-local
1515
- operational-foundations
@@ -366,7 +366,7 @@ Review the output above and verify:
366366
[ ] Network intent configuration is compatible
367367
[ ] No AKS workloads are running
368368
369-
If all prerequisites are met, proceed to Task 2: Enable SDN Integration.
369+
If all prerequisites are met, proceed to Post-Deployment: Deploy SDN.
370370
"@ -ForegroundColor Yellow
371371
```
372372

@@ -486,21 +486,22 @@ Complete this checklist before proceeding to SDN enablement:
486486

487487
## Next Steps
488488

489-
If all prerequisites are met, proceed to [Task 2: Enable SDN Integration](task-02-enable-sdn-integration.mdx).
489+
If all prerequisites are met, proceed to [Post-Deployment: Deploy SDN](../../04-cluster-deployment/phase-06-post-deployment/task-01-deploy-sdn.mdx).
490490

491491
---
492492

493493
## Navigation
494494

495495
| Previous | Up | Next |
496496
|----------|-----|------|
497-
| [← Phase 01: SDN Deployment](./index.mdx) | [Phase 01: SDN Deployment](./index.mdx) | [Task 02: Enable SDN Integration ](./task-02-enable-sdn-integration.mdx) |
497+
| [← Phase 01: SDN Operations](./index.mdx) | [Phase 01: SDN Operations](./index.mdx) | [Task 02: Configure NSGs ](./task-02-configure-network-security-groups.mdx) |
498498

499499
---
500500

501501
| Version | Date | Author | Changes |
502502
|---------|------|--------|---------|
503-
| 1.0.0 | 2026-03-24 | Azure Local Cloudnology Team | Initial release |
503+
| 1.0.0 | 2026-03-24 | AzureLocal | Initial release |
504+
| 1.1.0 | 2026-04-01 | AzureLocal | Align naming conventions, remove consulting language |
504505

505506

506507
---
@@ -518,4 +519,5 @@ If all prerequisites are met, proceed to [Task 2: Enable SDN Integration](task-0
518519

519520
| Version | Date | Author | Changes |
520521
|---------|------|--------|---------|
521-
| 1.0.0 | 2025-03-25 | Azure Local Cloudnology Team | Initial release |
522+
| 1.0.0 | 2025-03-25 | AzureLocal | Initial release |
523+
| 1.1.0 | 2026-04-01 | AzureLocal | Align naming conventions, remove consulting language |

docs/implementation/05-operational-foundations/phase-01-sdn-deployment/task-03-configure-network-security-groups.mdx renamed to docs/implementation/05-operational-foundations/phase-01-sdn-deployment/task-02-configure-network-security-groups.mdx

Lines changed: 17 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,15 @@
11
---
2-
title: "Task 3: Configure Network Security Groups"
3-
sidebar_label: "Task 03: Configure NSGs"
4-
sidebar_position: 3
2+
title: "Task 2: Configure Network Security Groups"
3+
sidebar_label: "Task 02: Configure NSGs"
4+
sidebar_position: 2
55
description: "Create and apply Network Security Groups to logical networks and VM NICs on Azure Local"
66
category: "Runbook"
77
scope: "Create and apply Network Security Groups to logical networks and VM NICs on A..."
88
purpose: "Create and apply Network Security Groups to logical networks and VM NICs on Azure Local"
9-
author: "Azure Local Cloudnology Team"
9+
author: "AzureLocal"
1010
created: 2025-03-25
11-
updated: 2025-03-25
12-
version: "1.0.0"
11+
updated: 2026-04-01
12+
version: "1.1.0"
1313
tags:
1414
- azure-local
1515
- operational-foundations
@@ -25,7 +25,7 @@ status: "Active"
2525
import Tabs from '@theme/Tabs';
2626
import TabItem from '@theme/TabItem';
2727

28-
# Task 03: Configure Network Security Groups
28+
# Task 02: Configure Network Security Groups
2929

3030
[![Runbook](https://img.shields.io/badge/Type-Runbook-blue?style=flat-square)](./index.mdx)
3131
[![Azure](https://img.shields.io/badge/Platform-Azure_Local-0078D4?style=flat-square&logo=microsoftazure)](https://learn.microsoft.com/en-us/azure/azure-local/)
@@ -83,7 +83,7 @@ NSGs include implicit default rules:
8383
| Variable | Config Path | Example |
8484
|----------|-------------|---------|
8585
| `AZURE_SUBSCRIPTION_ID` | `azure.subscription.id` | `00000000-0000-0000-0000-000000000000` |
86-
| `AZURE_RESOURCE_GROUP` | `azure.resource_group.name` | `rg-azurelocal-prod-eus2` |
86+
| `AZURE_RESOURCE_GROUP` | `azure.resource_group.name` | `rg-azlocal-prod-eus-001` |
8787
| `AZURE_REGION` | `azure.resource_group.location` | `eastus2` |
8888

8989
---
@@ -100,7 +100,7 @@ NSGs include implicit default rules:
100100
3. Configure:
101101
- **Subscription**: Select your subscription
102102
- **Resource Group**: Select the cluster's resource group
103-
- **Name**: e.g., `nsg-azl-prod-web`
103+
- **Name**: e.g., `nsg-azlocal-prod-web`
104104
- **Region**: Select the cluster's region
105105
4. Click **Review + Create****Create**
106106

@@ -257,9 +257,9 @@ Copy-paste ready NSG creation script — no config file, no helpers, no dependen
257257
258258
#region CONFIGURATION
259259
# ── Edit these values to match your environment ──────────────────────────────
260-
$ResourceGroupName = "rg-azurelocal-prod" # Target resource group
260+
$ResourceGroupName = "rg-azlocal-prod-eus-001" # Target resource group
261261
$Location = "eastus2" # Azure region
262-
$NsgName = "nsg-azl-prod-web" # NSG name
262+
$NsgName = "nsg-azlocal-prod-web" # NSG name
263263
$ManagementSubnet = "10.0.0.0/24" # Management subnet for RDP access
264264
#endregion CONFIGURATION
265265
@@ -373,7 +373,7 @@ Remove-NetRoute -InterfaceAlias "Ethernet 2" -DestinationPrefix "0.0.0.0/0" -Con
373373

374374
```bash
375375
# Azure CLI
376-
az network nsg rule list --resource-group rg-azurelocal-prod --nsg-name nsg-azl-prod-web -o table
376+
az network nsg rule list --resource-group rg-azlocal-prod-eus-001 --nsg-name nsg-azlocal-prod-web -o table
377377
```
378378

379379
### Verify NSG Association
@@ -410,18 +410,20 @@ Test-NetConnection -ComputerName <target-vm-ip> -Port 3389
410410

411411
| Previous | Up | Next |
412412
|----------|-----|------|
413-
| [← Task 02: Enable SDN Integration](./task-02-enable-sdn-integration.mdx) | [Phase 01: SDN Deployment](./index.mdx) | [Phase 02: Monitoring & Observability →](../phase-02-monitoring-observability/index.mdx) |
413+
| [← Task 01: Validate Prerequisites](./task-01-validate-sdn-prerequisites.mdx) | [Phase 01: SDN Operations](./index.mdx) | [Phase 02: Monitoring & Observability →](../phase-02-monitoring-observability/index.mdx) |
414414

415415
---
416416

417417
| Version | Date | Author | Changes |
418418
|---------|------|--------|---------|
419-
| 1.0.0 | 2026-03-24 | Azure Local Cloudnology Team | Initial release |
419+
| 1.0.0 | 2026-03-24 | AzureLocal | Initial release |
420+
| 1.1.0 | 2026-04-01 | AzureLocal | Align naming conventions, remove consulting language |
420421

421422
---
422423

423424
## Version Control
424425

425426
| Version | Date | Author | Changes |
426427
|---------|------|--------|---------|
427-
| 1.0.0 | 2025-03-25 | Azure Local Cloudnology Team | Initial release |
428+
| 1.0.0 | 2025-03-25 | AzureLocal | Initial release |
429+
| 1.1.0 | 2026-04-01 | AzureLocal | Align naming conventions, remove consulting language |

0 commit comments

Comments
 (0)