Azure Landing Zone 檢查清單技能
此技能將引導您填寫 Microsoft Azure Landing Zone (ALZ) Accelerator 檢查清單 — 一份用於在透過 ALZ Accelerator 工具使用 Bicep 或 Terraform 部署 ALZ 之前,擷取所有必要決策的試算表。
目標是產出一份已填寫完成的 Excel 檢查清單,其中每項決策皆有理由,最佳做法已預設套用,而需要人工輸入的項目也已清楚標記以供使用者注意。
為何重要
ALZ Accelerator 檢查清單是平台登陸區部署的單一事實來源。填錯可能導致網路設定錯誤、安全漏洞,或需要數小時的重工。此技能透過套用 Microsoft Cloud Adoption Framework (CAF) 的建議,同時尊重使用者現有的基礎設施(IP 範圍、訂閱、命名慣例),來確保一致性。
工作流程
第一階段:讀取檢查清單
使用 openpyxl 讀取上傳的 .xlsx 檢查清單,以了解其結構。ALZ 檢查清單通常包含三個分頁:
- Accelerator - Bootstrap:IaC 類型、VCS、訂閱、命名、CI/CD 設定
- Accelerator - Bicep:情境選擇、元件開關、IP 定址、原則
- Accelerator - Terraform:與 Bicep 相同,但包含更多選項(AMBA、Sovereign LZ)
解析檢查清單以識別哪些欄位已有值(F 欄 =「已選擇值」),哪些為空白。這能告訴您哪些決策使用者已做出,哪些需要輸入。
第二階段:訪談使用者
透過結構化提問收集決策。為避免使用者感到負擔,每次以 3-4 個問題為一批進行提問。依下列優先順序進行:
第一批 — 基礎決策:
- IaC 類型(Bicep 或 Terraform)
- 版本控制系統(Azure DevOps、GitHub 或本機)
- 網路拓撲情境(中樞與分支 vs vWAN、單區域 vs 多區域、Azure Firewall vs NVA)
- Azure 區域
第二批 — 元件決策:
- 要部署哪些元件(DDoS、Private DNS、Bastion、VPN 閘道、ExpressRoute、Zero Trust)
- 安全態勢(AMA、Defender 方案)
第三批 — 環境特定細節:
- Azure DevOps / GitHub 組織與專案名稱
- 訂閱 ID(管理、連線、身分識別、安全性)
- 管線核准者
- IP 定址(詢問他們是否有既有文件)
當使用者說「使用最佳做法」或推遲決策時,套用 references/alz-best-practices.md 中的建議。務必解釋為何提出某項建議 — 使用者會信任他們理解的建議。
第三階段:對應訂閱
如果使用者提供訂閱清單(來自 az account list 或類似指令),透過比對命名模式將訂閱對應至 ALZ 角色:
| 模式 | ALZ 角色 |
|---|---|
*mgmt*、*management* | 管理 |
*connectivity*、*network*、*hub* | 連線 |
*identity*、*ad*、*entra* | 身分識別 |
*security*、*sentinel*、*defender* | 安全性 |
如果缺少必要的訂閱(通常是安全性),則以黃色高亮標記並加上註解說明選項:
- 建立專用訂閱(建議)
- 與管理訂閱共用(預算受限的替代方案)
第四階段:整合 IP 定址
如果使用者提供 IP 文件(Markdown、CSV、Excel 或純文字),解析它以提取:
- 訂閱層級 CIDR 區塊 — 對應至 ALZ 中樞/分支 VNet
- 現有中樞 VNet 佈局 — 識別子網路配置(閘道、防火牆、Bastion、共用服務)
- 內部部署公用 IP — 納入註解中,供 VPN/防火牆規則參考
- AKS 網路 — 適用的 Pod/服務 CIDR
對於 ALZ 中樞 VNet,使用連線訂閱的 CIDR 區塊建議此子網路佈局:
Hub VNet: <連線基底>/16
GatewaySubnet: <基底>.0.0/27 (30 個主機)
AzureFirewallSubnet: <基底>.0.64/26 (62 個主機)
AzureFirewallManagementSubnet:<基底>.0.128/26 (62 個主機)
AzureBastionSubnet: <基底>.0.192/26 (62 個主機)
共用服務: <基底>.1.0/24 (254 個主機)
DNS 解析器輸入: <基底>.2.0/28
DNS 解析器輸出: <基底>.2.16/28
如果未提供 IP 文件,則使用 ALZ 預設值並標記為待審查。
第五階段:填寫檢查清單
使用 openpyxl 將值寫入適當分頁的 F 欄(「已選擇值」)。套用一致的格式:
from openpyxl.styles import Font, PatternFill, Alignment
from openpyxl.comments import Comment
# 已確認的值 — 綠色背景
green_fill = PatternFill('solid', fgColor='CCE5CC')
# 需要使用者操作的項目 — 黃色背景 + 紅色粗體文字
yellow_fill = PatternFill('solid', fgColor='FFFF00')
action_font = Font(bold=True, color='FF0000', size=10)
# 資訊性備註 — 斜體黃色背景
note_fill = PatternFill('solid', fgColor='FFFFCC')
note_font = Font(italic=True, size=10)
對於您填寫的每個儲存格:
- 新增註解說明理由或最佳做法參考
- 對已確認的決策使用綠色填滿
- 對需要使用者操作的項目(例如「待定義」、「待提供」)使用黃色填滿 + 紅色文字
- 對使用預設值但使用者應審查的項目使用淺黃色填滿 + 斜體
分頁特定邏輯:
僅填寫與使用者 IaC 選擇相符的分頁。如果另一個分頁先前有值,則清除它。對於啟用的分頁:
- 情境區段:將所選情境設為「是」,其餘設為「否」。以更亮的綠色標記所選情境。
- 選項區段:套用使用者的元件選擇。對於任何未明確討論的選項,套用最佳做法預設值,並在註解中註明。
- Bootstrap 分頁:無論 IaC 選擇為何,一律填寫 — 它是共用的。
第六階段:呈現結果
儲存已填寫的檢查清單後:
- 列印一份摘要表格,顯示所有已填寫的值
- 列出標記為使用者操作的項目(黃色高亮)
- 指出任何架構考量(例如,如果 ALZ 區域與現有基礎設施不同,則需要跨區域對等互連)
- 提供檔案下載連結
最佳做法建議
請參閱 references/alz-best-practices.md 以取得完整的建議清單。當使用者推遲時,套用以下關鍵預設值:
- Private networking:true(狀態儲存絕不應公開可存取)
- Separate CI/CD template repo:true(程式碼與管線定義之間的安全界限)
- Branch policies:true(所有變更都需要 PR)
- Self-hosted agents/runners:true(Private networking 必要)
- DDoS Protection:是(為所有 VNet 資源提供網路層級保護)
- Private DNS Zones:是(中樞-分支內 Private Endpoints 所需)
- Azure Bastion:是(無須公開 IP 即可安全存取 VM)
- AMA (Azure Monitoring Agent):保持啟用(集中式監控)
- Defender plans:保持啟用(跨所有資源類型的威脅偵測)
- Zero Trust:是(最小權限存取與微分割)
- AMBA alerts(僅限 Terraform):是(主動監控平台資源)
- Sovereign Landing Zone:否(除非明確符合法規要求)
跨區域考量
如果使用者現有的基礎設施位於與 ALZ 部署不同的區域,請在 Bootstrap 分頁的區域註解中標記。他們需要規劃 ALZ 中樞與任何現有中樞-分支拓撲之間的跨區域 VNet 對等互連。
儲存格參考對應
檢查清單具有固定結構。在寫入值時,請使用這些精確的儲存格參考,以避免列偏移錯誤。在寫入 F 欄之前,務必檢查 B 欄(名稱)是否與預期欄位相符。
Bootstrap 分頁 (Accelerator - Bootstrap)
| 列 | 儲存格 | 欄位 (B 欄) | 設定 (D 欄) |
|---|---|---|---|
| 4 | F4 | Infrastructure as Code | iac_type |
| 5 | F5 | Version control system | bootstrap_module_name |
| 6 | F6 | Starter module | starter_module_name |
| 8 | F8 | Bootstrap resource region | bootstrap_location |
| 9 | F9 | Parent management group id | root_parent_management_group_id |
| 10 | F10 | Management subscription id | subscription_id_management |
| 11 | F11 | Connectivity subscription id | subscription_id_connectivity |
| 12 | F12 | Identity subscription id | subscription_id_identity |
| 13 | F13 | Security subscription id | subscription_id_identity (注意:範本筆誤) |
| 15 | F15 | Bootstrap subscription id | bootstrap_subscription_id |
| 16 | F16 | Resource naming: service name | service_name |
| 17 | F17 | Resource naming: environment name | environment_name |
| 18 | F18 | Resource naming: postfix number | postfix_number |
| 21 | F21 | Use separate repository for templates | use_separate_repository_for_templates |
| 22 | F22 | Use private networking | use_private_networking |
| 23 | F23 | Allow storage access from my IP | allow_storage_access_from_my_ip |
| 24 | F24 | Apply approvers | apply_approvers |
| 25 | F25 | Create branch policies | create_branch_policies |
| 28 | F28 | Azure DevOps PAT | azure_devops_personal_access_token |
| 29 | F29 | Azure DevOps Agent PAT | azure_devops_agents_personal_access_token |
| 30 | F30 | Azure DevOps Organization | azure_devops_organization_name |
| 31 | F31 | Azure DevOps legacy url | azure_devops_use_organisation_legacy_url |
| 32 | F32 | Create Azure DevOps Project | azure_devops_create_project |
| 33 | F33 | Azure DevOps Project | azure_devops_project_name |
| 34 | F34 | Use self hosted agents | use_self_hosted_agents |
注意:第 7、14、19、20、26、27、35、36、41 行為空白或區段標題 — 請跳過它們。
Bicep 分頁 (Accelerator - Bicep) — 情境
| 列 | 儲存格 | 情境 |
|---|---|---|
| 6 | F6 | Multi-Region Hub & Spoke + Azure Firewall |
| 7 | F7 | Multi-Region vWAN + Azure Firewall |
| 8 | F8 | Multi-Region Hub & Spoke + NVA |
| 9 | F9 | Multi-Region vWAN + NVA |
| 10 | F10 | Management Groups, Policy and Management Only |
| 11 | F11 | Single-Region Hub & Spoke + Azure Firewall |
| 12 | F12 | Single-Region vWAN + Azure Firewall |
| 13 | F13 | Single-Region Hub & Spoke + NVA |
| 14 | F14 | Single-Region vWAN + NVA |
Bicep 分頁 — 選項(第 17-30 列)
| 列 | 儲存格 | 選項 |
|---|---|---|
| 17 | F17 | Resource naming convention |
| 18 | F18 | Custom management group names |
| 19 | F19 | Deploy DDOS Protection Plan |
| 20 | F20 | Deploy Private DNS |
| 21 | F21 | Deploy Bastion Host |
| 22 | F22 | Deploy VPN Gateway |
| 23 | F23 | Deploy ExpressRoute Gateway |
| 24 | F24 | Deploy to more than 2 regions |
| 25 | F25 | IP Addressing |
| 26 | F26 | Change a policy assignment enforcement mode |
| 27 | F27 | Remove a policy assignment |
| 28 | F28 | Turn off Azure Monitoring Agent |
| 29 | F29 | Turn off Defender Plans |
| 30 | F30 | Zero Trust Security |
Terraform 分頁 (Accelerator - Terraform)
情境佈局與 Bicep 相同(第 6-14 列)。選項為第 17-32 列:
| 列 | 儲存格 | 選項 |
|---|---|---|
| 17 | F17 | Resource naming convention |
| 18 | F18 | Custom management group names |
| 19 | F19 | Deploy DDOS Protection Plan |
| 20 | F20 | Deploy Private DNS |
| 21 | F21 | Deploy Bastion Host |
| 22 | F22 | Deploy VPN Gateway |
| 23 | F23 | Deploy ExpressRoute Gateway |
| 24 | F24 | Deploy to more than 2 regions |
| 25 | F25 | IP Addressing |
| 26 | F26 | Change a policy assignment enforcement mode |
| 27 | F27 | Remove a policy assignment |
| 28 | F28 | Turn off Azure Monitoring Agent |
| 29 | F29 | Deploy Azure Monitoring Baseline Alerts (AMBA) |
| 30 | F30 | Turn off Defender Plans |
| 31 | F31 | Zero Trust Security |
| 32 | F32 | Sovereign Landing Zone |
驗證方式:在寫入任何值之前,請讀取儲存格 B{列} 並驗證它是否與預期的欄位名稱相符。如果不相符,請掃描工作表以尋找正確的列。這樣可以防止因範本版本差異導致資料無聲損毀。
輸出格式
最終交付物是一個 .xlsx 檔案,包含:
- 保留原始範本中的所有三個分頁
- F 欄已填寫所選擇的值
- 包含理由和最佳做法參考的儲存格註解
- 顏色編碼:綠色(已確認)、黃色(需要操作)、淺黃色(要審查的預設值)
- 對話中清晰的摘要,列出所有決策和標記的項目
注意事項
- openpyxl 列索引是從 1 開始 — 差一錯誤會無聲地毀損錯誤的列;在提交前使用
cell.value回讀驗證。 - 訂閱正則表達式比對在非標準命名時會失敗(例如
sub-xyz-platform-mgmt)— 當模式失敗時,回退到列舉。 - 跨區域考量:跨區域的 VNet 對等互連會產生輸出流量費用;預設 ALZ 範本未計算此費用。
- Excel 核取方塊 vs 儲存格值:openpyxl 無法寫入核取方塊狀態 — 使用儲存格值「✓」加上已命名範圍來表示已勾選。
- 訂閱配額佈建:要求的配額增加在配額實際套用之前顯示為「已核准」— 使用
az vm list-usage驗證。