Skip to content

Commit 9392927

Browse files
author
Kristopher Turner
committed
docs: add training buildout plan and project management files
1 parent 2730136 commit 9392927

1 file changed

Lines changed: 303 additions & 0 deletions

File tree

‎project_management/training-buildout-plan.md‎

Lines changed: 303 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,303 @@
1+
# Plan: Azure Local Training Repo Buildout
2+
3+
## TL;DR
4+
5+
Rebuild the `azurelocal-training` repo from legacy Azure Stack HCI workshop materials into a modern Azure Local operator training curriculum. The old content covers Compute, Storage, Networking, SDN, Hybrid, Security, AKS, and Troubleshooting across a 3-day modular workshop. The new curriculum retains the modular structure but reframes everything through the Azure Arc management plane, adds new Azure Local-specific topics (cloud deployment, Arc VMs, Update Manager, AKS Arc, AVD on Azure Local, Arc-managed SDN), drops obsolete tooling (SCVMM, WAC), and shifts from "on-prem admin" to "cloud-connected operator" persona.
6+
7+
## Confirmed Decisions (from user review)
8+
9+
- Lab environment: BOTH sandbox and customer lab
10+
- Content depth: L200-L300 core, L100 for intro only
11+
- Slide decks: Must be updated/created — separate task, aligned 1:1 with training modules. Placeholder pages in docs linking to new decks.
12+
- SDN: Cover Arc-managed SDN for Azure Local (NOT the old 8-module deep-dive)
13+
- SCVMM: DROP entirely
14+
- WAC (Windows Admin Center): DROP entirely
15+
- PowerPoint archive: Stays in `referrence/` (archived). Docs get placeholder/links to new decks.
16+
- Old materials: Move to `/archive`
17+
- AVD: ADD as a new training module
18+
- AKS: Part of cluster deployment now — focus on deploying AKS clusters and managing workloads
19+
20+
---
21+
22+
## Phase 1: Foundation & Structure
23+
24+
### Step 1 — Create the docs folder structure
25+
26+
Create the following folder/file layout under `docs/`:
27+
28+
```text
29+
docs/
30+
├── index.md (landing page — rewrite)
31+
├── delivery-guide.md (consolidated delivery guide)
32+
├── 00-introduction/
33+
│ ├── index.md (Azure Local overview & positioning)
34+
│ ├── what-is-azure-local.md (replaces old ASHCI intro)
35+
│ ├── azure-local-vs-windows-server.md
36+
│ └── use-cases.md
37+
├── 01-management/
38+
│ ├── index.md
39+
│ ├── azure-portal.md (NEW — primary management plane)
40+
│ ├── powershell-and-cli.md (KEEP — updated cmdlets)
41+
│ └── azure-arc-integration.md (NEW — Arc as the management fabric)
42+
├── 02-compute/
43+
│ ├── index.md
44+
│ ├── arc-vm-deployment.md (NEW — portal-based VM creation)
45+
│ ├── arc-vm-management.md (NEW — lifecycle, sizing, disk, network)
46+
│ ├── vm-images-and-gallery.md (NEW — Azure Marketplace images on Azure Local)
47+
│ ├── live-migration.md (KEEP — updated)
48+
│ └── high-availability.md (KEEP — Failover Clustering, updated)
49+
├── 03-storage/
50+
│ ├── index.md
51+
│ ├── storage-spaces-direct.md (KEEP — fundamentals still apply)
52+
│ ├── disk-types-and-cache.md (KEEP — updated for NVMe/PM)
53+
│ ├── fault-tolerance.md (KEEP)
54+
│ ├── storage-resync.md (KEEP)
55+
│ └── monitoring-storage.md (KEEP — updated tools)
56+
├── 04-networking/
57+
│ ├── index.md
58+
│ ├── network-atc.md (KEEP — still core)
59+
│ ├── virtual-switch.md (KEEP)
60+
│ ├── rdma-and-offloads.md (KEEP)
61+
│ ├── logical-networks.md (NEW — Arc VM logical networks)
62+
│ └── arc-managed-sdn.md (NEW — Arc-managed SDN for Azure Local)
63+
├── 05-hybrid-services/
64+
│ ├── index.md
65+
│ ├── azure-site-recovery.md (KEEP — updated for Arc)
66+
│ ├── azure-backup.md (KEEP — updated for Arc)
67+
│ ├── azure-monitor.md (KEEP — updated, Insights)
68+
│ ├── azure-update-manager.md (NEW — replaces old WSUS/Update Management)
69+
│ └── defender-for-cloud.md (NEW — replaces old Security Center)
70+
├── 06-security/
71+
│ ├── index.md
72+
│ ├── secured-core-server.md (KEEP — expanded)
73+
│ ├── bitlocker-and-encryption.md (KEEP)
74+
│ ├── smi-and-drift-protection.md (NEW — security baselines)
75+
│ └── network-security.md (KEEP)
76+
├── 07-azure-kubernetes/
77+
│ ├── index.md
78+
│ ├── aks-on-azure-local.md (REWRITE — AKS is part of cluster deployment now)
79+
│ ├── deploying-aks-clusters.md (NEW — focus area)
80+
│ └── managing-workloads.md (NEW — focus area)
81+
├── 08-azure-virtual-desktop/
82+
│ ├── index.md (NEW — entire module)
83+
│ ├── avd-on-azure-local.md (NEW — AVD architecture on Azure Local)
84+
│ ├── deploying-avd.md (NEW — session hosts, host pools)
85+
│ └── managing-avd.md (NEW — user sessions, scaling, FSLogix)
86+
├── 09-operations/
87+
│ ├── index.md
88+
│ ├── monitoring-and-alerts.md (KEEP — consolidated)
89+
│ ├── troubleshooting.md (KEEP — updated tools/methods)
90+
│ ├── backup-and-restore.md (KEEP — operational procedures)
91+
│ └── disaster-recovery.md (KEEP — failover/failback procedures)
92+
├── 10-cloud-deployment/
93+
│ ├── index.md (NEW — entire section)
94+
│ ├── deployment-overview.md (NEW — Azure Portal cloud deployment)
95+
│ ├── prerequisites.md (NEW)
96+
│ └── registration-and-arc.md (NEW — Arc registration flow)
97+
├── presentations/
98+
│ └── index.md (placeholder — links to new slide decks per module, status of each)
99+
└── labs/
100+
├── index.md (lab environment setup — sandbox + customer lab)
101+
├── lab-01-deploy-arc-vm.md
102+
├── lab-02-manage-arc-vm.md
103+
├── lab-03-storage-operations.md
104+
├── lab-04-networking.md
105+
├── lab-05-site-recovery.md
106+
├── lab-06-backup-restore.md
107+
├── lab-07-update-manager.md
108+
├── lab-08-monitoring.md
109+
├── lab-09-deploy-aks-cluster.md
110+
└── lab-10-avd-deployment.md
111+
```
112+
113+
### Step 2 — Update `mkdocs.yml` nav
114+
115+
Update the `nav:` section to match the new folder structure with proper section labels and ordering.
116+
117+
### Step 3 — Rewrite `docs/index.md`
118+
119+
Replace the current placeholder with a proper landing page that includes:
120+
121+
- Training overview and objectives
122+
- Target audience (Infrastructure Ops, SysAdmins, Cloud Admins)
123+
- Prerequisite knowledge
124+
- Module summary table (all modules, not just 6)
125+
- Delivery options (remote, on-site, self-paced)
126+
- Duration estimates per module and total
127+
- The existing placeholder warning (keep until content is complete)
128+
129+
---
130+
131+
## Phase 2: Content — What to KEEP, EDIT, ADD, or DROP
132+
133+
### KEEP (update terminology Azure Stack HCI → Azure Local, update procedures)
134+
135+
| Old Topic | New Location | Changes Needed |
136+
|-----------|-------------|----------------|
137+
| Storage Spaces Direct fundamentals | `03-storage/` | Terminology update, add NVMe/PM tiers, remove outdated perf numbers |
138+
| Disk types, cache, fault tolerance | `03-storage/` | Minor updates |
139+
| Storage ReSync | `03-storage/` | Minor updates |
140+
| Core Networking (vSwitch, Network ATC, RDMA, SR-IOV) | `04-networking/` | Terminology update, Network ATC v2 changes |
141+
| Hyper-V / VM High Availability / Live Migration | `02-compute/` | Reframe under Arc VMs, keep clustering fundamentals |
142+
| Azure Site Recovery | `05-hybrid-services/` | Update for Arc-based protection, new portal flows |
143+
| Azure Backup | `05-hybrid-services/` | Update for Arc-based backup, MARS agent changes |
144+
| Azure Monitor integration | `05-hybrid-services/` | Update for Azure Monitor Agent, Insights |
145+
| Security features (Secured-core, BitLocker) | `06-security/` | Expand significantly |
146+
| Troubleshooting (VMs, Clustering, S2D) | `09-operations/` | Update tools, add Arc-specific troubleshooting |
147+
148+
### ADD (new content — did not exist in old training)
149+
150+
| Topic | Location | Reason |
151+
|-------|----------|--------|
152+
| Azure Portal as primary management | `01-management/azure-portal.md` | Azure Local is now cloud-first managed |
153+
| Azure Arc integration & management fabric | `01-management/azure-arc-integration.md` | Core to Azure Local identity |
154+
| Azure Arc VM deployment (portal-based) | `02-compute/arc-vm-deployment.md` | Primary VM creation method now |
155+
| Azure Arc VM management (lifecycle) | `02-compute/arc-vm-management.md` | Portal-based VM operations |
156+
| VM images & Azure Marketplace gallery | `02-compute/vm-images-and-gallery.md` | New capability |
157+
| Logical Networks for Arc VMs | `04-networking/logical-networks.md` | New networking model |
158+
| Arc-managed SDN for Azure Local | `04-networking/arc-managed-sdn.md` | SDN reframed as Arc-managed |
159+
| Azure Update Manager | `05-hybrid-services/azure-update-manager.md` | Replaces WSUS/old Update Management |
160+
| Microsoft Defender for Cloud | `05-hybrid-services/defender-for-cloud.md` | Replaces old Security Center |
161+
| SMI & drift protection | `06-security/smi-and-drift-protection.md` | New security baseline feature |
162+
| AKS cluster deployment & workload mgmt | `07-azure-kubernetes/` | AKS is now part of cluster deployment |
163+
| Azure Virtual Desktop on Azure Local | `08-azure-virtual-desktop/` | NEW module — AVD architecture, session hosts, host pools, FSLogix, scaling |
164+
| Cloud Deployment via Azure Portal | `10-cloud-deployment/` | Entirely new deployment model |
165+
| Hands-on Labs (10 labs) | `labs/` | Structured labs aligned to modules, both sandbox + customer lab |
166+
| Consolidated Delivery Guide | `delivery-guide.md` | Single guide with modular delivery options |
167+
| Presentations placeholder | `presentations/index.md` | Links to new slide decks per module, tracks status |
168+
169+
### DROP (obsolete — do not carry forward)
170+
171+
| Old Topic | Reason |
172+
|-----------|--------|
173+
| System Center Virtual Machine Manager (SCVMM) | Deprecated for Azure Local management |
174+
| Windows Admin Center (WAC) | Dropped — Azure Portal + Arc is the management plane |
175+
| Azure File Sync | Not core to Azure Local operator training |
176+
| SDN deep-dive (8-module track) | Replaced by Arc-managed SDN overview in networking module |
177+
| Chalk and Talk (90-min intro) | Replace with "What is Azure Local" section |
178+
| Legacy deployment methods (WAC-based cluster creation) | Cloud deployment is now primary |
179+
| Cloud Witness as standalone topic | Fold into HA/clustering section |
180+
| Old SharePoint content links | Dead links to Microsoft internal SharePoint |
181+
182+
### EDIT (significant rewrites needed)
183+
184+
| Topic | What Changes |
185+
|-------|-------------|
186+
| Full Delivery Guide | Rewrite as modern delivery guide with Azure Local branding, updated durations, updated prereqs, modular delivery tracks |
187+
| Compute module | Reframe from "Hyper-V administration" to "Azure Arc VM operations" — Hyper-V is the engine but Arc is the interface |
188+
| Hybrid Features module | Split into "Hybrid Services" (ASR, Backup, Monitor, Update Manager) and fold security items into Security module |
189+
| AKS module | Complete rewrite — AKS is now part of cluster deployment, focus on deploying AKS clusters and managing workloads |
190+
| Networking module | Add Arc-managed SDN as topic alongside core networking |
191+
| Security module | Expand from thin 2-hour overview to comprehensive module covering Secured-core, BitLocker, Defender for Cloud, SMI, WDAC |
192+
193+
---
194+
195+
## Phase 3: Delivery Guide & Curriculum Design
196+
197+
### Step 4 — Create `delivery-guide.md`
198+
199+
Consolidate the 9 old delivery guides into a single modern delivery guide with:
200+
201+
- **Track A: Essentials (2 days)** — Modules 00-02, 05, 09 (Intro, Management, Compute, Hybrid Services, Operations)
202+
- **Track B: Full (4 days)** — All modules 00-10
203+
- **Track C: Infrastructure Deep-Dive (3 days)** — Modules 00-04, 06, 09 (adds Storage, Networking, Security, Operations)
204+
- **Track D: Cloud-Native (2 days)** — Modules 00-01, 07, 10 (Intro, Management, AKS, Cloud Deployment)
205+
- **Track E: VDI/AVD (2 days)** — Modules 00-02, 08, 09 (Intro, Management, Compute, AVD, Operations)
206+
- Each track with: knowledge level, duration, target audience, prerequisites, agenda, lab mapping
207+
208+
### Step 5 — Write module index pages
209+
210+
Each module's `index.md` should contain: learning objectives, topics covered, estimated duration, prerequisite modules, key terminology.
211+
212+
### Step 6 — Create presentations placeholder
213+
214+
- `presentations/index.md` — Table of all modules with columns: Module, Slide Deck Name, Status (To Create / In Progress / Complete), Link
215+
- This tracks the slide deck creation effort aligned to each training module
216+
217+
---
218+
219+
## Phase 4: Lab Development
220+
221+
### Step 7 — Create lab framework
222+
223+
- `labs/index.md` — Lab environment options: (A) Azure Local sandbox/jumpstart, (B) customer's own lab, with setup guidance for both
224+
- 10 labs, each with: objectives, prerequisites, step-by-step instructions, validation steps, cleanup
225+
- Labs are independent and map to specific modules
226+
- Lab environment setup guide covering what's needed for each option
227+
228+
---
229+
230+
## Phase 5: Slide Deck Creation
231+
232+
### Step 8 — Create new PowerPoint decks
233+
234+
Create new slide decks aligned 1:1 with training modules:
235+
236+
- `00-Introduction.pptx`
237+
- `01-Management.pptx`
238+
- `02-Compute.pptx`
239+
- `03-Storage.pptx`
240+
- `04-Networking.pptx`
241+
- `05-Hybrid-Services.pptx`
242+
- `06-Security.pptx`
243+
- `07-Azure-Kubernetes.pptx`
244+
- `08-Azure-Virtual-Desktop.pptx`
245+
- `09-Operations.pptx`
246+
- `10-Cloud-Deployment.pptx`
247+
248+
Old PowerPoints in `referrence/PowerPoint/` serve as content reference for updating. New decks should use Azure Local branding and reflect current Azure Portal/Arc workflows.
249+
250+
---
251+
252+
## Phase 6: Update Infrastructure & Cleanup
253+
254+
### Step 9 — Update `mkdocs.yml`
255+
256+
- Add full nav tree matching folder structure
257+
- Ensure admonition extensions work for warnings/notes
258+
- Add any needed plugins (e.g., search, tags)
259+
260+
### Step 10 — Rename `referrence/` to `archive/`
261+
262+
- `git mv referrence archive` — preserve all old materials, don't delete
263+
- Old PowerPoints stay archived here for reference
264+
265+
### Step 11 — Update `README.md`
266+
267+
- Repo purpose, contribution guide link, build instructions
268+
269+
---
270+
271+
## Relevant Files
272+
273+
- `docs/index.md` — Rewrite landing page (currently placeholder)
274+
- `mkdocs.yml` — Update nav to match new structure
275+
- `referrence/Delivery Guide/*.md` — Source material for content (9 delivery guides)
276+
- `referrence/PowerPoint/` — 24 .pptx files organized by topic (reference for content accuracy)
277+
- `README.md` — Update with repo description
278+
279+
---
280+
281+
## Verification
282+
283+
1. Run `mkdocs serve` locally after structure is created — verify all pages render, nav works
284+
2. Check that every nav entry in `mkdocs.yml` has a corresponding `.md` file
285+
3. Verify no broken internal links between docs
286+
4. Verify the MkDocs Material admonition renders the placeholder warning correctly
287+
5. Push to main and verify GitHub Pages deployment at `https://azurelocal.cloud/azurelocal-training/`
288+
289+
---
290+
291+
## Key Decisions
292+
293+
| Decision | Rationale |
294+
|----------|-----------|
295+
| **SDN** | Reduced to overview in Networking section — SDN deep-dive track (8 modules) is dropped because Azure Local is moving toward simplified Arc-based networking. Can be added back as an advanced elective later. |
296+
| **SCVMM** | Dropped entirely — Azure Portal + Azure Arc is the management plane for Azure Local. |
297+
| **WAC** | Dropped entirely — Azure Portal + Azure Arc is the management plane for Azure Local. |
298+
| **Lab environment** | Both sandbox/jumpstart AND customer's own lab. Provide setup guidance for both. |
299+
| **PowerPoint decks** | Old decks archived. New slide decks created 1:1 with modules as a separate effort. |
300+
| **Old reference materials** | Preserved in `archive/` (renamed from `referrence/`), not deleted. |
301+
| **Content depth** | L200-L300 core, L100 for intro module only. |
302+
| **AVD** | Added as new module 08 — AVD on Azure Local is a key workload scenario. |
303+
| **AKS** | Rewritten to focus on deploying AKS clusters and managing workloads (not old standalone AKS-HCI). |

0 commit comments

Comments
 (0)