Skip to content

Commit 297d0bf

Browse files
committed
Add lightweight MG split as optional Phase 0 in graduation guide
1 parent 9c76359 commit 297d0bf

File tree

1 file changed

+38
-1
lines changed

1 file changed

+38
-1
lines changed

docs/graduation-guide.md

Lines changed: 38 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,44 @@ You don't need all of these. If 2-3 apply simultaneously, start planning.
2626

2727
The good news: if you followed this guide, migration is incremental. You're adding layers, not rebuilding.
2828

29-
### Phase 1: Management Group Hierarchy (Week 1)
29+
### Phase 0: Lightweight Management Group Split (Optional)
30+
31+
If your team is growing (20–50 engineers) and you're starting to see a natural separation between infrastructure/platform responsibilities and application/product teams, consider this intermediate step before going full ALZ.
32+
33+
**From:**
34+
```
35+
Tenant Root Group
36+
└── mg-yourcompany
37+
├── sub-prod
38+
└── sub-nonprod
39+
```
40+
41+
**To:**
42+
```
43+
Tenant Root Group
44+
└── mg-yourcompany
45+
├── mg-platform (cross-cutting: monitoring, security, shared infra)
46+
│ └── sub-prod
47+
└── mg-landing-zones (workloads: application environments)
48+
└── sub-nonprod
49+
```
50+
51+
**Why this helps:**
52+
- Separates platform policies (security baselines, logging requirements) from workload policies (resource type restrictions, naming conventions)
53+
- Gives infrastructure and product teams clear boundaries without the overhead of dedicated Platform subscriptions
54+
- Makes the eventual move to full ALZ (Phase 1) smoother — the hierarchy is already in place
55+
56+
**Steps:**
57+
1. Create `mg-platform` and `mg-landing-zones` under your root MG
58+
2. Move `sub-prod` under `mg-platform` and `sub-nonprod` under `mg-landing-zones`
59+
3. Reassign policies to the appropriate MG level
60+
4. Verify policy inheritance works correctly
61+
62+
**Risk:** Low. Moving subscriptions between MGs is instant and doesn't affect running resources.
63+
64+
**When to skip this and go straight to Phase 1:** If you already need dedicated Connectivity or Management subscriptions, or have 5+ subscriptions, jump directly to the full ALZ hierarchy below.
65+
66+
### Phase 1: Full Management Group Hierarchy (Week 1)
3067

3168
**From:**
3269
```

0 commit comments

Comments
 (0)