用途:在把基础设施部署到 Azure 之前,对 Bicep 部署做全面预检,支持 az 与 azd 两种工作流。适用于部署前、编写或审查 Bicep 文件时、预览部署变更、确认权限是否足够,以及运行 azd up、azd provision 或 az deployment 命令之前。
主要能力:按顺序执行校验流程,即使某步失败也继续,最终汇总所有问题。步骤包括:检测项目类型(根目录有 azure.yaml 则用 azd 工作流,否则用 az CLI;查找 .bicep 文件及匹配的 .bicepparam、.parameters.json 等参数文件);用 bicep build <bicep-file> --stdout 校验语法;执行预检(azd 项目用 azd provision --preview,可加 --environment <env-name>;独立 Bicep 按 targetScope 选择 az deployment group/sub/mg/tenant what-if,并加 --validation-level Provider);解析 what-if 输出,按 Create、Delete、Modify、NoChange、Ignore、Deploy 分类资源变更;最后在项目根目录生成 preflight-report.md,包含摘要、执行工具、问题、what-if 结果与建议。
使用方式:先确认工具可用,运行 az --version、azd version、bicep --version。若 --validation-level Provider 因 RBAC 权限失败,可回退为 ProviderNoRbac 并在报告中注明。需要提前收集资源组、订阅、位置、环境等信息,缺失时先询问用户。
限制:需要 Azure CLI 2.76.0+(推荐)、azd、Bicep CLI 及 Azure MCP 工具;未登录、权限不足、语法错误、工具未安装、资源组不存在等情况会在报告中记录并继续或跳过相应步骤。具体报告模板与错误处理细节见其参考文档。