什麼是部署疑難排解?

當您使用 Bicep 檔案或 Azure Resource Manager 範本 (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-AzResourceGroupDeploymentOperationGet-AzActivityLog 等命令。 若使用 Azure CLI,請使用例如 az deployment operation groupaz monitor activity-log list 等命令。

下一步