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 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 panelu na dole ekranu, a następnie wybierz Bicep:

Jeśli w okienku zobaczysz następujące dane wyjściowe, sprawdź, czy dodano konfigurację dotnetAcquisitionExtension.existingDotnetPath do programu Visual Studio Code. Jeśli to ustawienie jest obecne, usuń je i uruchom ponownie program VS Code. Zobacz Ustawienia użytkownika i obszaru roboczego, aby skonfigurować ustawienia programu Visual Studio Code.

It was not possible to find any compatible framework version.

W przeciwnym razie zgłoś problem w repo Bicep i dołącz komunikaty wynikowe.

Zainstalowano wiele wersji Bicep CLI

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 Twoich instalacji Bicep. Jeśli używasz wersji interfejsu wiersza polecenia (CLI) Bicep zarządzanego przez CLI platformy Azure, ta instalacja nie zostanie wyświetlona, ponieważ nie zostanie dodana do zmiennej środowiskowej PATH. Jeśli where bicep zwraca tylko jedną lokalizację, może to oznaczać, że konfliktujące wersje, które widzisz, pochodzą z instalacji ręcznej i instalacji interfejsu wiersza polecenia 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 ręczną instalację, jak i instancję zarządzaną przez Azure CLI, możesz połączyć ich użycie w jedną instancję.

1. Usuń lokalizację instalacji ręcznej.
2. Dodaj lokalizację Bicep CLI zainstalowanego przez Azure CLI 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 lub bicep polecenia.

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.