Problemen met de installatie van Bicep oplossen

In dit artikel wordt beschreven hoe u potentiële fouten in uw Bicep-installatie kunt oplossen.

.NET-runtimefout

Wanneer u de Bicep-extensie voor Visual Studio Code installeert, kunt u de volgende foutberichten tegenkomen:

Failed to install .NET runtime v5.0

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

Waarschuwing

Dit is een laatste redmiddeloplossing die problemen kan veroorzaken bij het bijwerken van versies.

Als u het probleem wilt oplossen, kunt u .NET handmatig installeren vanaf de .NET-website en vervolgens Visual Studio Code configureren om een bestaande installatie van .NET opnieuw te gebruiken met de volgende instellingen:

Windows

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

MacOS

Als u een x64-installatie nodig hebt, gebruikt u:

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

Voor andere macOS-installaties gebruikt u:

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

Zie Instellingen gebruiker en werkruimte voor het configureren van Visual Studio Code-instellingen.

Visual Studio Code-fout

Als u het volgende foutbericht ziet in Visual Studio Code:

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

Open in VS Code de uitvoerweergave in het deelvenster onder aan het scherm en selecteer vervolgens Bicep:

Als u de volgende uitvoer in het deelvenster ziet en u Bicep CLI versie 0.4.1124 of hoger gebruikt, controleert u of u de dotnetAcquisitionExtension.existingDotnetPath configuratieoptie hebt toegevoegd aan VS Code. Zie de .NET-runtimefout. Als deze configuratieoptie aanwezig is, verwijdert u deze en start u VS Code opnieuw.

It was not possible to find any compatible framework version.

Als dat niet het probleem is, brengt u een probleem op in de Bicep-opslagplaats en neemt u de uitvoerberichten op.

Meerdere versies van Bicep CLI geïnstalleerd

Als u bicep CLI handmatig installeert op meer dan één locatie, ziet u mogelijk onverwacht gedrag, zoals de Bicep CLI die niet wordt bijgewerkt wanneer u de upgradeopdracht uitvoert. Of u ziet dat de uitvoering az bicep version één versie retourneert, maar bicep --version een andere versie retourneert.

U kunt dit probleem oplossen door alle locaties bij te werken of één locatie te selecteren om de andere locaties te onderhouden en te verwijderen.

Open eerst de opdrachtprompt (niet PowerShell) en voer deze uit where bicep. Met deze opdracht worden de locaties van uw Bicep-installaties geretourneerd. Als u het exemplaar van Bicep CLI gebruikt dat wordt beheerd door Azure CLI, ziet u deze installatie niet omdat deze niet wordt toegevoegd aan het PATH. Als where bicep er slechts één locatie wordt geretourneerd, kan het zijn dat de conflicterende versies die u ziet zich bevinden tussen de handmatige installatie en de Azure CLI-installatie.

Als u alle installatielocaties wilt behouden, gebruikt u dezelfde methode die u eerder hebt gebruikt om de Bicep CLI handmatig te installeren voor alle locaties die u wilt onderhouden. Als u Azure CLI gebruikt, voert u deze uit az bicep upgrade om die versie bij te werken.

Als u slechts één installatielocatie wilt behouden, gebruikt u de volgende stappen:

1. Verwijder de bestanden voor de installaties die u niet wilt behouden.
2. Verwijder deze locaties uit de omgevingsvariabele PATH .

Als u zowel een handmatige installatie als het exemplaar hebt dat wordt beheerd door Azure CLI, kunt u uw gebruik combineren tot één exemplaar.

1. Verwijder de handmatige installatielocatie.
2. Voeg de locatie van de Bicep CLI toe die door Azure CLI is geïnstalleerd aan de path-variabele . Voor Windows is %USERPROFILE%\.Azure\binde locatie die wordt onderhouden door Azure CLI.

Nadat u het Azure CLI-exemplaar aan het PAD hebt toegevoegd, kunt u die versie gebruiken met een van az bicep beide of bicep.

Volgende stappen

Zie quickstart: Bicep-bestanden maken met Visual Studio Code voor meer informatie over het gebruik van Visual Studio Code en de Bicep-extensie.