Azure Landing Zone 检查表技能
此技能将引导您完成 Microsoft Azure Landing Zone (ALZ) 加速器检查表的填写——该电子表格记录了通过 ALZ 加速器工具使用 Bicep 或 Terraform 部署 ALZ 之前所需的所有决策。
目标是生成一份已填写的 Excel 检查表,其中每个决策都有依据,默认应用最佳实践,并且需要人工输入的项目会明确标记以引起用户注意。
为何重要
ALZ 加速器检查表是平台登陆区部署的单一事实来源。填写错误意味着网络配置错误、安全漏洞或数小时的重做工作。此技能通过应用 Microsoft Cloud Adoption Framework (CAF) 的建议,同时尊重用户现有的基础设施(IP 范围、订阅、命名约定),确保一致性。
工作流程
阶段 1:读取检查表
使用 openpyxl 读取上传的 .xlsx 检查表以了解其结构。ALZ 检查表通常包含三个选项卡:
- Accelerator - Bootstrap:IaC 类型、VCS、订阅、命名、CI/CD 设置
- Accelerator - Bicep:场景选择、组件开关、IP 寻址、策略
- Accelerator - Terraform:与 Bicep 相同,但包含额外选项(AMBA、Sovereign LZ)
解析检查表以识别哪些字段已有值(F 列 = "Chosen Value")以及哪些为空。这可以告诉您用户已经决定了什么以及需要什么输入。
阶段 2:面试用户
通过结构化的提问收集决策。一次询问 3-4 个问题,以免让用户不知所措。按以下顺序优先询问:
第一批——基础决策:
- IaC 类型(Bicep 或 Terraform)
- 版本控制系统(Azure DevOps、GitHub 或本地)
- 网络拓扑场景(Hub & Spoke 与 vWAN、单区域与多区域、Azure Firewall 与 NVA)
- Azure 区域
第二批——组件决策:
- 部署哪些组件(DDoS、Private DNS、Bastion、VPN Gateway、ExpressRoute、Zero Trust)
- 安全态势(AMA、Defender 计划)
第三批——环境特定细节:
- Azure DevOps / GitHub 组织和项目名称
- 订阅 ID(管理、连接、身份、安全)
- 管道审批者
- IP 寻址(询问他们是否已有现有文档)
当用户说“使用最佳实践”或推迟决策时,应用 references/alz-best-practices.md 中的建议。始终解释提出建议的原因——用户信任他们理解的建议。
阶段 3:映射订阅
如果用户提供订阅列表(来自 az account list 或类似命令),通过匹配命名模式将订阅映射到 ALZ 角色:
| 模式 | ALZ 角色 |
|---|---|
*mgmt*, *management* | 管理 |
*connectivity*, *network*, *hub* | 连接 |
*identity*, *ad*, *entra* | 身份 |
*security*, *sentinel*, *defender* | 安全 |
如果缺少必需的订阅(通常是安全),用黄色高亮标记并添加注释解释选项:
- 创建专用订阅(推荐)
- 与管理订阅共享(预算受限的替代方案)
阶段 4:集成 IP 寻址
如果用户提供 IP 文档(Markdown、CSV、Excel 或文本),解析它以提取:
- 订阅级 CIDR 块——映射到 ALZ 中心/分支 VNet
- 现有中心 VNet 布局——识别子网分配(网关、防火墙、堡垒机、共享服务)
- 本地公共 IP——包含在注释中,用于 VPN/防火墙规则参考
- AKS 网络——Pod/服务 CIDR(如适用)
对于 ALZ 中心 VNet,使用连接订阅的 CIDR 块推荐以下子网布局:
Hub VNet: <connectivity-base>/16
GatewaySubnet: <base>.0.0/27 (30 个主机)
AzureFirewallSubnet: <base>.0.64/26 (62 个主机)
AzureFirewallManagementSubnet:<base>.0.128/26 (62 个主机)
AzureBastionSubnet: <base>.0.192/26 (62 个主机)
Shared Services: <base>.1.0/24 (254 个主机)
DNS Resolver Inbound: <base>.2.0/28
DNS Resolver Outbound: <base>.2.16/28
如果未提供 IP 文档,使用 ALZ 默认值并标记以供审查。
阶段 5:填写检查表
使用 openpyxl 将值写入相应选项卡的 F 列("Chosen Value")。应用一致的格式:
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 选择如何,始终填写——它是共享的。
阶段 6:呈现结果
保存填写好的检查表后:
- 打印一个汇总表,显示所有已填写的值
- 列出标记为需要用户操作的项目(黄色高亮)
- 指出任何体系结构注意事项(例如,如果 ALZ 区域与现有基础架构不同,则需要跨区域对等)
- 提供文件下载链接
最佳实践建议
阅读 references/alz-best-practices.md 以获取完整的建议集。用户推迟决策时应用的关键默认值:
- Private networking:true(状态存储不应公开访问)
- Separate CI/CD template repo:true(代码与管道定义之间的安全边界)
- Branch policies:true(所有更改都需要 PR)
- Self-hosted agents/runners:true(私有网络所需)
- 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 对等互连。
单元格参考映射
检查表具有固定结构。写入值时使用这些精确的单元格引用,以避免出现行偏移错误。始终通过检查 B 列(“名称”)是否与预期字段匹配来验证,然后再写入 F 列。
Bootstrap 选项卡 (Accelerator - Bootstrap)
| 行 | 单元格 | 字段 (col B) | 配置设置 (col D) |
|---|---|---|---|
| 4 | F4 | 基础设施即代码 | iac_type |
| 5 | F5 | 版本控制系统 | bootstrap_module_name |
| 6 | F6 | 启动模块 | starter_module_name |
| 8 | F8 | Bootstrap 资源区域 | bootstrap_location |
| 9 | F9 | 父管理组 ID | root_parent_management_group_id |
| 10 | F10 | 管理订阅 ID | subscription_id_management |
| 11 | F11 | 连接订阅 ID | subscription_id_connectivity |
| 12 | F12 | 身份订阅 ID | subscription_id_identity |
| 13 | F13 | 安全订阅 ID | subscription_id_identity (注意:模板拼写错误) |
| 15 | F15 | Bootstrap 订阅 ID | bootstrap_subscription_id |
| 16 | F16 | 资源命名:服务名称 | service_name |
| 17 | F17 | 资源命名:环境名称 | environment_name |
| 18 | F18 | 资源命名:后缀编号 | postfix_number |
| 21 | F21 | 为模板使用单独仓库 | use_separate_repository_for_templates |
| 22 | F22 | 使用私有网络 | use_private_networking |
| 23 | F23 | 允许从我的 IP 访问存储 | allow_storage_access_from_my_ip |
| 24 | F24 | 应用审批者 | apply_approvers |
| 25 | F25 | 创建分支策略 | 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 组织 | azure_devops_organization_name |
| 31 | F31 | Azure DevOps 旧版 URL | azure_devops_use_organisation_legacy_url |
| 32 | F32 | 创建 Azure DevOps 项目 | azure_devops_create_project |
| 33 | F33 | Azure DevOps 项目 | azure_devops_project_name |
| 34 | F34 | 使用自托管代理 | use_self_hosted_agents |
注意:第 7、14、19、20、26、27、35、36、41 行为空白或节标题——跳过它们。
Bicep 选项卡 (Accelerator - Bicep) —— 场景
| 行 | 单元格 | 场景 |
|---|---|---|
| 6 | F6 | 多区域 Hub & Spoke + Azure Firewall |
| 7 | F7 | 多区域 vWAN + Azure Firewall |
| 8 | F8 | 多区域 Hub & Spoke + NVA |
| 9 | F9 | 多区域 vWAN + NVA |
| 10 | F10 | 仅管理组、策略和管理 |
| 11 | F11 | 单区域 Hub & Spoke + Azure Firewall |
| 12 | F12 | 单区域 vWAN + Azure Firewall |
| 13 | F13 | 单区域 Hub & Spoke + NVA |
| 14 | F14 | 单区域 vWAN + NVA |
Bicep 选项卡 —— 选项(第 17-30 行)
| 行 | 单元格 | 选项 |
|---|---|---|
| 17 | F17 | 资源命名约定 |
| 18 | F18 | 自定义管理组名称 |
| 19 | F19 | 部署 DDOS 保护计划 |
| 20 | F20 | 部署私有 DNS |
| 21 | F21 | 部署 Bastion 主机 |
| 22 | F22 | 部署 VPN 网关 |
| 23 | F23 | 部署 ExpressRoute 网关 |
| 24 | F24 | 部署到 2 个以上区域 |
| 25 | F25 | IP 寻址 |
| 26 | F26 | 更改策略分配强制模式 |
| 27 | F27 | 删除策略分配 |
| 28 | F28 | 关闭 Azure 监控代理 |
| 29 | F29 | 关闭 Defender 计划 |
| 30 | F30 | 零信任安全 |
Terraform 选项卡 (Accelerator - Terraform)
与 Bicep 相同的场景布局(第 6-14 行)。选项为第 17-32 行:
| 行 | 单元格 | 选项 |
|---|---|---|
| 17 | F17 | 资源命名约定 |
| 18 | F18 | 自定义管理组名称 |
| 19 | F19 | 部署 DDOS 保护计划 |
| 20 | F20 | 部署私有 DNS |
| 21 | F21 | 部署 Bastion 主机 |
| 22 | F22 | 部署 VPN 网关 |
| 23 | F23 | 部署 ExpressRoute 网关 |
| 24 | F24 | 部署到 2 个以上区域 |
| 25 | F25 | IP 寻址 |
| 26 | F26 | 更改策略分配强制模式 |
| 27 | F27 | 删除策略分配 |
| 28 | F28 | 关闭 Azure 监控代理 |
| 29 | F29 | 部署 Azure 监控基线警报 (AMBA) |
| 30 | F30 | 关闭 Defender 计划 |
| 31 | F31 | 零信任安全 |
| 32 | F32 | 主权登陆区 |
验证方法:在写入任何值之前,读取单元格 B{row} 并验证它与预期字段名称匹配。如果不匹配,扫描工作表以找到正确的行。这可以防止模板版本差异导致的静默数据损坏。
输出格式
最终交付物为 .xlsx 文件,其中包含:
- 保留原始模板的所有三个选项卡
- F 列中填充选定的值
- 包含理由和最佳实践参考的单元格注释
- 颜色编码:绿色(已确认)、黄色(需要操作)、浅黄色(需要审查的默认值)
- 对话中清晰的摘要,列出所有决策和标记的项目
注意事项
- openpyxl 行索引从 1 开始 —— 差一错误会静默破坏错误行;在提交前使用
cell.value回读验证。 - 订阅正则表达式匹配在非标准命名上会失败(例如
sub-xyz-platform-mgmt)—— 当模式失败时回退到枚举。 - 跨区域注意事项:跨区域 VNet 对等会产生出站流量成本;默认 ALZ 模板未计入此项。
- Excel 复选框与单元格值:openpyxl 无法写入复选框状态——使用单元格值“✓”+ 命名范围指示已选中。
- 订阅配额传播:请求的配额增加在配额实际应用之前显示为“已批准”——使用
az vm list-usage验证。