什么是部署故障排除？

使用 Bicep 文件或 Azure 资源管理器模板（ARM 模板）部署 Azure 资源时，可能会收到错误。 有一些故障排除工具可帮助您在部署之前解决语法错误。 可以从 Azure 门户、Azure PowerShell 和 Azure CLI 获取有关错误代码和部署错误的详细信息。 本文档可帮助您找到排查错误的解决方案。

错误类型

验证错误发生在部署开始之前，并且是由不正确的语法引起的，这些语法可由 Visual Studio Code 等代码编辑器识别。 例如，拼写错误的属性名称或缺少参数的函数。

当运行部署命令但未在 Azure 中部署资源时，会发生印前验证错误。 例如，如果使用的参数值不正确，则部署命令将返回错误消息。

部署错误只能通过尝试部署并与 Azure 环境交互来确定。 例如，虚拟机 （VM） 需要网络接口卡 （NIC）。 如果在部署 VM 时 NIC 不存在，则会收到部署错误。

故障排除工具

有几种故障排除工具可用于解决错误。

语法错误

为了帮助在部署之前识别语法错误，请使用最新版本的 Visual Studio Code。 为 Bicep 或 ARM 模板安装最新版本的扩展。

• 肱二头肌
• Azure 资源管理器工具

要遵循开发部署模板的最佳实践，请使用以下工具：

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

资源提供程序和 API 版本

要对部署进行故障排除，了解资源提供程序的属性或 API 版本会很有帮助。 有关详细信息，请参阅 使用 Bicep 和 ARM 模板定义资源。

错误详细信息

部署时，可以在 Azure 门户的资源组的 Deployments 或 Activity 日志中找到错误的原因。 如果使用的是 Azure PowerShell，请使用 Get-AzResourceGroupDeploymentOperation 和 Get-AzActivityLog 等命令。 对于 Azure CLI，请使用 az deployment operation group 和 az monitor activity-log list 等命令。

后续步骤

• 要了解有关如何查找部署错误代码和排查部署问题的更多信息，请参阅 查找错误代码。
• 有关基于错误代码的解决方案，请参阅 排查常见的 Azure 部署错误。
• 有关查找错误代码的简介，请参阅 快速入门：ARM 模板 JSON 部署疑难解答 或 快速入门：Bicep 文件部署疑难解答。