次の方法で共有


デプロイのトラブルシューティングとは

Bicep ファイルまたは Azure Resource Manager テンプレート (ARM テンプレート) を使用して Azure リソースをデプロイすると、エラーが発生する場合があります。 デプロイ前に構文エラーを解決するのに役立つトラブルシューティング ツールがあります。 エラー コードとデプロイ エラーの詳細については、Azure portal、Azure PowerShell、Azure CLI から取得できます。 このドキュメントは、エラーのトラブルシューティングの解決策を見つけるのに役立ちます。

エラーの種類

検証エラーは、デプロイが開始される前に発生し、Visual Studio Code などのコード エディターで識別できる構文が正しくないことが原因で発生します。 たとえば、プロパティ名のスペルが間違っている、または引数がない関数などです。

プレフライト検証エラーは、デプロイ コマンドが実行されても、リソースが Azure にデプロイされていない場合に発生します。 たとえば、正しくないパラメータ値を使用すると、デプロイメント・コマンドはエラー・メッセージを返します。

デプロイ エラーは、デプロイを試行し、Azure 環境と対話することによってのみ判断できます。 たとえば、仮想マシン (VM) にはネットワーク インターフェイス カード (NIC) が必要です。 VM のデプロイ時に NIC が存在しない場合は、デプロイ エラーが発生します。

トラブルシューティング ツール

エラーを解決するために使用できるトラブルシューティングツールがいくつかあります。

構文エラー

デプロイ前に構文エラーを特定するには、最新バージョンの Visual Studio Code を使用します。 Bicep または ARM テンプレートの拡張機能の最新バージョンをインストールします。

デプロイメントテンプレートの開発に関するベストプラクティスに従うには、次のツールを使用します。

リソース プロバイダーと API のバージョン

デプロイのトラブルシューティングを行うには、リソース プロバイダーのプロパティまたは API バージョンについて学習すると役立ちます。 詳細については、「 Bicep テンプレートと ARM テンプレートを使用してリソースを定義する」を参照してください。

エラーの詳細

デプロイすると、Azure portal のリソース グループの デプロイログまたはアクティビティ ログでエラーの原因を見つけることができます。 Azure PowerShell を使用している場合は、 Get-AzResourceGroupDeploymentOperationGet-AzActivityLog などのコマンドを使用します。 Azure CLI の場合は、 az deployment operation groupaz monitor activity-log list などのコマンドを使用します。

次のステップ