什么是部署故障排除？

部署 Bicep 文件或 Azure 资源管理器模板（ARM 模板）时，可能会出现错误。 本文档可帮助你找到针对该错误的可能解决方案。

错误类型

可能会出现两种类型的错误 - 验证错误和部署错误。

验证错误发生在部署启动之前。 可以在不与当前 Azure 环境交互的情况下确定这些错误。 例如，可以在部署启动之前，通过验证来了解函数是否存在语法错误或缺少参数的情况。

部署错误只能通过尝试进行部署并与 Azure 环境交互来确定。 例如，虚拟机 (VM) 需要一个网络接口卡 (NIC)。 如果在部署 VM 时该 NIC 不存在，则会出现部署错误。

故障排除工具

若要在部署之前识别语法错误，请使用最新版 Visual Studio Code。 安装以下扩展之一的最新版：

• Bicep 扩展
• Azure 资源管理器 工具扩展

若要对部署进行故障排除，则需了解资源提供程序的属性或 API 版本。

若要遵循开发模板的最佳做法，请使用以下方法之一：

• Bicep Linter
• ARM 模板测试工具包

部署时，可以通过 Azure 门户在资源组的“部署”或“活动日志”中查找错误原因。 如果使用的是 Azure PowerShell，请使用 Get-AzResourceGroupDeploymentOperation 和 Get-AzActivityLog 之类的命令。 对于 Azure CLI，请使用 az deployment operation group 和 az monitor activity-log list 之类的命令。

后续步骤

• 有关基于错误代码的解决方案，请参阅排查常见的 Azure 部署错误。
• 有关查找错误代码的简介，请参阅快速入门：排查 ARM 模板部署问题或快速入门：排查 Bicep 文件部署问题。