你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
什么是部署故障排除?
使用 Bicep 文件或 Azure 资源管理器模板(ARM 模板)来部署 Azure 资源时,可能会出现错误。 可以借助故障排除工具在部署之前解决语法错误。 可以从 Azure 门户、Azure PowerShell 和 Azure CLI 获取有关错误代码和部署错误的详细信息。 本文档有助于查找用于排查错误的解决方案。
错误类型
验证错误发生在部署开始之前,由可以通过代码编辑器(如 Visual Studio Code)识别的错误语法引发。 例如,属性名称拼写错误,或者函数缺少参数。
在 Azure 中运行部署命令但未部署资源时,会发生预检验证错误。 例如,如果使用了不正确的参数值,部署命令会返回错误消息。
部署错误只能通过尝试进行部署并与 Azure 环境交互来确定。 例如,虚拟机 (VM) 需要一个网络接口卡 (NIC)。 如果在部署 VM 时该 NIC 不存在,则会出现部署错误。
故障排除工具
有多种故障排除工具可用于解决错误。
语法错误
若要在部署之前识别语法错误,请使用最新版 Visual Studio Code。 安装适用于 Bicep 或 ARM 模板的最新版本的扩展。
若要遵循开发部署模板的最佳做法,请使用以下工具:
资源提供程序和 API 版本
若要对部署进行故障排除,则需了解资源提供程序的属性或 API 版本。 有关详细信息,请参阅使用 Bicep 和 ARM 模板来定义资源。
错误详细信息
部署时,可以通过 Azure 门户在资源组的“部署”或“活动日志”中查找错误原因。 如果使用的是 Azure PowerShell,请使用 Get-AzResourceGroupDeploymentOperation 和 Get-AzActivityLog 之类的命令。 对于 Azure CLI,请使用 az deployment operation group 和 az monitor activity-log list 之类的命令。
后续步骤
- 若要详细了解如何查找部署错误代码并排查部署问题,请参阅查找错误代码。
- 有关基于错误代码的解决方案,请参阅排查常见的 Azure 部署错误。
- 有关查找错误代码的简介,请参阅快速入门:排查 ARM 模板 JSON 部署问题或快速入门:排查 Bicep 文件部署问题。