Behandeln von Problemen mit der Bicep-Installation

In diesem Artikel wird beschrieben, wie Sie potenzielle Fehler in einer Bicep-Installation beheben können.

.NET-Laufzeitfehler

Wenn Sie die Bicep-Erweiterung für Visual Studio Code installieren, werden möglicherweise die folgenden Fehlermeldungen angezeigt:

Failed to install .NET runtime v5.0

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

Warnung

Dies ist eine Notlösung, die bei der Aktualisierung von Versionen zu Problemen führen kann.

Um das Problem zu beheben, können Sie .NET manuell über die .NET-Websiteinstallieren und dann Visual Studio Code konfigurieren, um eine vorhandene Installation von .NET mit den folgenden Einstellungen wiederzuverwenden:

Windows

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

macOS

Wenn Sie eine x64-Installation benötigen, verwenden Sie Folgendes:

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

Verwenden Sie für andere macOS-Installationen Folgendes:

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

Informationen zum Konfigurieren der Visual Studio Code-Einstellungen finden Sie unter Benutzer- und Workspace-Einstellungen.

Visual Studio Code-Fehler

Wenn Sie die folgende Fehlermeldung in Visual Studio Code erhalten:

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

Öffnen Sie in VS Code die Ansicht Ausgabe im Bereich am unteren Bildschirmrand, und wählen Sie dann Bicep aus:

Wenn die folgende Ausgabe im Bereich angezeigt wird und Sie Bicep CLI Version 0.4.1124 oder höher verwenden, überprüfen Sie, ob Sie die Konfigurationsoption dotnetAcquisitionExtension.existingDotnetPath zu VS Code hinzugefügt haben. Siehe .NET-Laufzeitfehler. Wenn diese Konfigurationsoption vorhanden ist, entfernen Sie sie, und starten Sie VS Code neu.

It was not possible to find any compatible framework version.

Melden andernfalls ein Problem im Bicep-Repository und schließen Sie die Ausgabenachrichten ein.

Mehrere Versionen der Bicep CLI installiert

Wenn Sie die Bicep CLI manuell an mehreren Speicherorten installieren, kann es zu unerwartetem Verhalten kommen, z. B. dass die Bicep CLI nicht aktualisiert wird, wenn Sie den Befehl upgrade ausführen. Oder Sie stellen fest, dass die Ausführung von az bicep version eine Version, die von bicep --version aber eine andere Version zurückgibt.

Um dieses Problem zu lösen, können Sie entweder alle Speicherorte aktualisieren oder einen Speicherorten auswählen, den Sie beibehalten möchten, und die anderen Speicherorte löschen.

Öffnen Sie zunächst die Eingabeaufforderung (nicht PowerShell), und führen Sie where bicep aus. Dieser Befehl gibt die Speicherorte Ihrer Bicep-Installationen zurück. Wenn Sie die Instanz der Bicep CLI verwenden, die von der Azure CLI verwaltet wird, wird diese Installation nicht angezeigt, da sie PATH nicht hinzugefügt wurde. Wenn where bicep nur einen Speicherort zurückgibt, kann es sein, dass der auftretende Versionskonflikt zwischen der manuellen Installation und der Azure CLI-Installation besteht.

Um alle Installationsspeicherorte beizubehalten, verwenden Sie die Methode, die Sie zuvor für die manuelle Installation der Bicep CLI für alle Speicherorte verwendet haben, die Sie beibehalten möchten. Wenn Sie Azure CLI verwenden, führen Sie az bicep upgrade aus, um diese Version zu aktualisieren.

Um nur einen Installationsspeicherort beizubehalten, gehen Sie wie folgt vor:

1. Löschen Sie die Dateien der Installationen, die Sie nicht beibehalten möchten.
2. Entfernen Sie diese Speicherorte aus der Umgebungsvariablen PATH.

Wenn Sie sowohl eine manuelle Installation als auch die von der Azure CLI verwaltete Instanz haben, können Sie Ihre Nutzung in einer Instanz kombinieren.

1. Löschen Sie den manuellen Installationsspeicherort.
2. Fügen Sie den Speicherort der von der Azure CLI installierten Bicep CLI zur Variablen PATH hinzu. Unter Windows lautet der von der Azure CLI verwaltete Speicherort %USERPROFILE%\.Azure\bin.

Nachdem Sie die Azure CLI-Instanz zu PATH hinzugefügt haben, können Sie diese Version entweder mit az bicep oder bicep verwenden.

Nächste Schritte

Weitere Informationen zur Verwendung von Visual Studio Code und der BICEP-Erweiterung finden Sie unter Schnellstart: Erstellen von BICEP-Dateien mit Visual Studio Code.