Rozwiązywanie problemów z instalacją języka Bicep

W tym artykule opisano sposób rozwiązywania potencjalnych błędów w instalacji aplikacji Bicep.

Błąd środowiska uruchomieniowego platformy .NET

Podczas instalowania rozszerzenia Bicep dla programu Visual Studio Code mogą wystąpić następujące komunikaty o błędach:

Failed to install .NET runtime v5.0

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

Ostrzeżenie

Jest to rozwiązanie z ostatecznością, które może powodować problemy podczas aktualizowania wersji.

Aby rozwiązać ten problem, możesz ręcznie zainstalować platformę .NET z poziomu witryny internetowej platformy .NET, a następnie skonfigurować program Visual Studio Code w celu ponownego użycia istniejącej instalacji platformy .NET przy użyciu następujących ustawień:

Windows

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

macOS

Jeśli potrzebujesz instalacji x64 , użyj:

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

W przypadku innych instalacji systemu macOS użyj:

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

Zobacz Ustawienia użytkownika i obszaru roboczego, aby skonfigurować ustawienia programu Visual Studio Code.

Błąd programu Visual Studio Code

Jeśli w programie Visual Studio Code zostanie wyświetlony następujący komunikat o błędzie:

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

W programie VS Code otwórz widok Dane wyjściowe w okienku w dolnej części ekranu, a następnie wybierz pozycję Bicep:

Jeśli w okienku zobaczysz następujące dane wyjściowe i używasz interfejsu wiersza polecenia Bicep w wersji 0.4.1124 lub nowszej, sprawdź, czy dodano dotnetAcquisitionExtension.existingDotnetPath opcję konfiguracji do programu VS Code. Zobacz Błąd środowiska uruchomieniowego platformy .NET. Jeśli ta opcja konfiguracji jest obecna, usuń ją i uruchom ponownie program VS Code.

It was not possible to find any compatible framework version.

W przeciwnym razie zgłoś problem w repozytorium Bicep i dołącz komunikaty wyjściowe.

Zainstalowano wiele wersji interfejsu wiersza polecenia Bicep

Jeśli ręcznie zainstalujesz interfejs wiersza polecenia Bicep w więcej niż jednej lokalizacji, możesz zauważyć nieoczekiwane zachowanie, takie jak interfejs wiersza polecenia Bicep, który nie jest aktualizowany po uruchomieniu polecenia uaktualnienia. Możesz też zauważyć, że uruchomienie az bicep version polecenia zwraca jedną wersję, ale bicep --version zwraca inną wersję.

Aby rozwiązać ten problem, możesz zaktualizować wszystkie lokalizacje lub wybrać jedną lokalizację, aby zachować i usunąć inne lokalizacje.

Najpierw otwórz wiersz polecenia (a nie program PowerShell) i uruchom polecenie where bicep. To polecenie zwraca lokalizacje instalacji Bicep. Jeśli używasz wystąpienia interfejsu wiersza polecenia Bicep zarządzanego przez interfejs wiersza polecenia platformy Azure, ta instalacja nie zostanie wyświetlona, ponieważ nie zostanie dodana do ścieżki . Jeśli where bicep zwraca tylko jedną lokalizację, może to oznaczać, że widoczne wersje powodują konflikt między instalacją ręczną a instalacją interfejsu wiersza polecenia platformy Azure.

Aby zachować wszystkie lokalizacje instalacji, użyj tej samej metody, która była używana wcześniej, aby ręcznie zainstalować interfejs wiersza polecenia Bicep dla wszystkich lokalizacji, które chcesz obsługiwać. Jeśli używasz interfejsu wiersza polecenia platformy Azure, uruchom polecenie az bicep upgrade , aby zaktualizować wersję.

Aby zachować tylko jedną lokalizację instalacji, wykonaj następujące kroki:

1. Usuń pliki instalacji, których nie chcesz przechowywać.
2. Usuń te lokalizacje ze zmiennej środowiskowej PATH .

Jeśli masz zarówno instalację ręczną , jak i wystąpienie zarządzane przez interfejs wiersza polecenia platformy Azure, możesz połączyć użycie z jednym wystąpieniem.

1. Usuń lokalizację instalacji ręcznej.
2. Dodaj lokalizację interfejsu wiersza polecenia Bicep zainstalowanego przez interfejs wiersza polecenia platformy Azure do zmiennej PATH . W przypadku systemu Windows lokalizacja przechowywana przez interfejs wiersza polecenia platformy Azure to %USERPROFILE%\.Azure\bin.

Po dodaniu wystąpienia interfejsu wiersza polecenia platformy Azure do ścieżki możesz użyć tej wersji za pomocą az bicep polecenia lub bicep.

Następne kroki

Aby uzyskać więcej informacji na temat korzystania z programu Visual Studio Code i rozszerzenia Bicep, zobacz Szybki start: tworzenie plików Bicep za pomocą programu Visual Studio Code.