Řešení potíží s instalací Bicepu

Tento článek popisuje, jak vyřešit potenciální chyby v instalaci Bicep.

Chyba modulu runtime .NET

Při instalaci rozšíření Bicep pro Visual Studio Code můžete narazit na následující chybové zprávy:

Failed to install .NET runtime v5.0
Failed to download .NET 5.0.x ....... Error!

Upozorňující

Toto je řešení posledního řešení, které může způsobit problémy při aktualizaci verzí.

Pokud chcete tento problém vyřešit, můžete ručně nainstalovat .NET z webu .NET a pak nakonfigurovat Visual Studio Code tak, aby znovu používal existující instalaci .NET s následujícími nastaveními:

Windows

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

macOS

Pokud potřebujete instalaci x64 , použijte:

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

Pro ostatní instalace macOS použijte:

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

Informace o konfiguraci nastavení editoru Visual Studio Code najdete v tématu Nastavení uživatele a pracovního prostoru.

Chyba editoru Visual Studio Code

Pokud se v editoru Visual Studio Code zobrazí následující chybová zpráva:

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

V editoru VS Code otevřete zobrazení Výstup v podokně v dolní části obrazovky a pak vyberte Bicep:

Podokno výstupu editoru Visual Studio Code

Pokud se v podokně zobrazí následující výstup a používáte Rozhraní příkazového řádku Bicep verze 0.4.1124 nebo novější, zkontrolujte, jestli jste do VS Code přidali dotnetAcquisitionExtension.existingDotnetPath možnost konfigurace. Viz chyba modulu runtime .NET. Pokud je tato možnost konfigurace k dispozici, odeberte ji a restartujte VS Code.

It was not possible to find any compatible framework version.

Jinak v úložišti Bicep vyvoláte problém a zahrňte výstupní zprávy.

Nainstalované rozhraní příkazového řádku Bicep s více verzemi

Pokud ručně nainstalujete rozhraní příkazového řádku Bicep do více než jednoho umístění, můžete si všimnout neočekávaného chování, jako je například neaktualizační rozhraní příkazového řádku Bicep při spuštění příkazu pro upgrade. Nebo si můžete všimnout, že spuštění az bicep version vrací jednu verzi, ale bicep --version vrací jinou verzi.

Pokud chcete tento problém vyřešit, můžete buď aktualizovat všechna umístění, nebo vybrat jedno umístění pro údržbu a odstranění ostatních umístění.

Nejprve otevřete příkazový řádek (ne PowerShell) a spusťte where biceppříkaz . Tento příkaz vrátí umístění instalací Bicep. Pokud používáte instanci rozhraní příkazového řádku Bicep, kterou spravuje Azure CLI, tato instalace se nezobrazí, protože se nepřidá do cesty. Pokud where bicep vrátí jenom jedno umístění, může se stát, že konfliktní verze, které vidíte, jsou mezi ruční instalací a instalací Azure CLI.

Pokud chcete zachovat všechna umístění instalace, použijte stejnou metodu, kterou jste použili dříve k ruční instalaci rozhraní příkazového řádku Bicep pro všechna umístění, která chcete zachovat. Pokud používáte Azure CLI, spusťte az bicep upgrade aktualizaci této verze.

Pokud chcete zachovat pouze jedno umístění instalace, postupujte následovně:

  1. Odstraňte soubory pro instalace, které nechcete zachovat.
  2. Odeberte tato umístění z proměnné prostředí PATH .

Pokud máte ruční instalaci i instanci spravovanou pomocí Azure CLI, můžete zkombinovat využití do jedné instance.

  1. Odstraňte umístění ruční instalace.
  2. Přidejte umístění rozhraní příkazového řádku Bicep nainstalovaného v Azure CLI do proměnné PATH . V případě Windows je %USERPROFILE%\.Azure\binumístění udržované rozhraním příkazového řádku Azure CLI .

Po přidání instance Azure CLI do path můžete tuto verzi použít s nebo az bicepbicep.

Další kroky

Další informace o používání editoru Visual Studio Code a rozšíření Bicep najdete v tématu Rychlý start: Vytváření souborů Bicep pomocí editoru Visual Studio Code.