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

  • [アーティクル]

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

.NET ランタイム エラー

Visual Studio Code 用の Bicep 拡張機能をインストールするときに、次のエラー メッセージが表示される場合があります。

Failed to install .NET runtime v5.0

Failed to download .NET 5.0.x ....... Error!

警告

これは最後の手段で、バージョン更新時に問題が発生する可能性があります。

この問題を解決するには、.NET Web サイトから .NET を手動でインストールし、以下の設定を使って .NET の既存のインストールを再利用するように Visual Studio Code を構成します。

Windows

"dotnetAcquisitionExtension.existingDotnetPath": [
  {
    "extensionId": "ms-azuretools.vscode-bicep",
    "path": "C:\\Program Files\\dotnet\\dotnet.exe"
  }
]

macOS

x64 インストールが必要な場合は、次のコマンドを使用します。

"dotnetAcquisitionExtension.existingDotnetPath": [
  {
    "extensionId": "ms-azuretools.vscode-bicep",
    "path": "/usr/local/share/dotnet/x64/dotnet"
  }
]

その他の macOS インストールでは、次のコマンドを使用します。

"dotnetAcquisitionExtension.existingDotnetPath": [
  {
    "extensionId": "ms-azuretools.vscode-bicep",
    "path": "/usr/local/share/dotnet/dotnet"
  }
]

Visual Studio Code 設定の構成については、「ユーザーとワークスペースの設定」を参照してください。

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 の出力ペイン

ペインに次の出力が表示され、Bicep CLI バージョン 0.4.1124 以降を使用している場合は、dotnetAcquisitionExtension.existingDotnetPath 構成オプションを VS Code に追加したかどうかを確認します。 「.NET ランタイム エラー」を参照してください。 この構成オプションが存在する場合は、それを削除して VS 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 ファイルを作成する」を参照してください。