Felsöka Bicep-installation

I den här artikeln beskrivs hur du löser potentiella fel i Bicep-installationen.

.NET-körningsfel

När du installerar Bicep-tillägget för Visual Studio Code kan du stöta på följande felmeddelanden:

Failed to install .NET runtime v5.0

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

Varning

Det här är en sista utväg som kan orsaka problem vid uppdatering av versioner.

För att lösa problemet kan du installera .NET manuellt från .NET-webbplatsen och sedan konfigurera Visual Studio Code för att återanvända en befintlig installation av .NET med följande inställningar:

Windows

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

macOS

Om du behöver en x64-installation använder du:

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

För andra macOS-installationer använder du:

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

Mer information om hur du konfigurerar Visual Studio Code-inställningar finns i Inställningar för användare och arbetsytor.

Visual Studio Code-fel

Om du ser följande popup-meddelande i Visual Studio Code:

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

Från VS Code öppnar du utdatavyn i fönstret längst ned på skärmen och väljer sedan Bicep:

Om du ser följande utdata i fönstret och du använder Bicep CLI version 0.4.1124 eller senare kontrollerar du om du har lagt till konfigurationsalternativet dotnetAcquisitionExtension.existingDotnetPath i VS Code. Se .NET-körningsfel. Om det här konfigurationsalternativet finns tar du bort det och startar om VS Code.

It was not possible to find any compatible framework version.

Annars skapar du ett problem i Bicep-lagringsplatsen och tar med utdatameddelandena.

Flera versioner av Bicep CLI installerat

Om du installerar Bicep CLI manuellt på mer än en plats kan du märka ett oväntat beteende, till exempel att Bicep CLI inte uppdateras när du kör uppgraderingskommandot. Eller så kanske du märker att körningen az bicep version returnerar en version, men bicep --version returnerar en annan version.

Du kan lösa problemet genom att antingen uppdatera alla platser eller välja en plats för att underhålla och ta bort de andra platserna.

Öppna först kommandotolken (inte PowerShell) och kör where bicep. Det här kommandot returnerar platserna för dina Bicep-installationer. Om du använder instansen av Bicep CLI som hanteras av Azure CLI visas inte den här installationen eftersom den inte har lagts till i PATH. Om where bicep endast returnerar en plats kan det bero på att de motstridiga versioner som du ser är mellan den manuella installationen och Azure CLI-installationen.

Om du vill behålla alla installationsplatser använder du samma metod som du använde tidigare för att manuellt installera Bicep CLI för alla platser som du vill underhålla. Om du använder Azure CLI kör az bicep upgrade du för att uppdatera den versionen.

Använd följande steg om du bara vill behålla en installationsplats:

1. Ta bort filerna för de installationer som du inte vill behålla.
2. Ta bort dessa platser från path-miljövariabeln.

Om du har både en manuell installation och instansen som hanteras av Azure CLI kan du kombinera din användning till en instans.

1. Ta bort den manuella installationsplatsen.
2. Lägg till platsen för Bicep CLI som installerats av Azure CLI i PATH-variabeln . För Windows är %USERPROFILE%\.Azure\binplatsen som underhålls av Azure CLI .

När du har lagt till Azure CLI-instansen i PATH kan du använda den versionen med antingen az bicep eller bicep.

Nästa steg

Mer information om hur du använder Visual Studio Code och Bicep-tillägget finns i Snabbstart: Skapa Bicep-filer med Visual Studio Code.