Bicep のインストールのトラブルシューティング

  • [アーティクル]

この記事では、Bicep のインストールで発生する可能性のあるエラーを解決する方法について説明します。

Visual Studio Code エラー

Visual Studio Code に次のようなエラー メッセージ ポップアップが表示されることがあります。

The Bicep server crashed 5 times in the last 3 minutes. The server will not be restarted.

VS Code から、画面下部のペインで [出力] ビューを開き、[Bicep] を選びます。

Visual Studio Code の出力ペイン

ペインに次の出力が表示された場合は、VS Code に dotnetAcquisitionExtension.existingDotnetPath 設定を追加したかどうかを確認してください。 この設定が存在する場合は、それを削除して VS Code を再起動します。 Visual Studio Code 設定の構成については、「ユーザーとワークスペースの設定」を参照してください。

It was not possible to find any compatible framework version.

それ以外の場合は、Bicep リポジトリで問題を報告し、出力メッセージを含めます。

複数のバージョンの Bicep CLI がインストールされている

Bicep CLI を複数の場所に手動でインストールすると、アップグレード コマンドを実行したときに Bicep CLI が更新されないなど、予期しない動作が発生することがあります。 あるいは、az bicep version を実行するとあるバージョンが返されるが、bicep --version を実行すると違うバージョンが返される場合があります。

この問題を解決するには、すべての場所を更新するか、維持する場所を 1 つ選び他の場所を削除します。

まず、(PowerShell ではなく) コマンド プロンプトを開き、where bicep を実行します。 このコマンドは、Bicep インストールの場所を返します。 Azure CLI によって管理されている Bicep CLI のインスタンスを使用している場合は、PATH に追加されないので、このインストールは表示されません。 where bicep で 1 つの場所しか返されない場合は、手動インストールと Azure CLI インストールの間で表示されているバージョンが競合している可能性があります。

すべてのインストール場所を保持するには、前に使用したのと同じ方法を使用して、維持するすべての場所に Bicep CLI を手動でインストールします。 Azure CLI を使用している場合は、az bicep upgrade を実行してそのバージョンを更新します。

1 つのインストール場所のみを保持するには、次の手順を使用します。

  1. 保持しないインストールのファイルを削除します。
  2. PATH 環境変数からこれらの場所を削除します。

手動インストールと Azure CLI で管理されているインスタンスの両方がある場合は、利用を 1 つのインスタンスにまとめることができます。

  1. 手動インストールの場所を削除します。
  2. Azure CLI によってインストールされた Bicep CLI の場所を PATH 変数に追加します。 Windows では、Azure CLI によって管理される場所は %USERPROFILE%\.Azure\bin です。

Azure CLI インスタンスを PATH に追加した後、そのバージョンを az bicep か bicep のいずれかで使用できます。

次のステップ

Visual Studio Code と Bicep 拡張機能の使用方法の詳細については、「クイック スタート: Visual Studio Code を使用して Bicep ファイルを作成する」を参照してください。