Устранение неполадок с установкой Bicep

Статья
03/20/2024

В этой статье описано, как устранять ошибки, которые могут возникнуть при установке Bicep.

Ошибка среды выполнения .NET

При установке расширения Bicep для Visual Studio Code могут появиться следующие сообщения об ошибках:

Failed to install .NET runtime v5.0

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

Предупреждение

Это решение последнего курорта, которое может вызвать проблемы при обновлении версий.

Чтобы решить эту проблему, вы можете вручную установить .NET с веб-сайта .NET, а затем настроить Visual Studio Code для повторного использования существующей установки .NET с помощью следующих параметров:

Windows

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

macOS

Если нужно выполнить установку для 64-разрядных систем, используйте следующее:

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

Если нужны файлы установки для macOS, используйте следующее:

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

Сведения о настройке параметров Visual Studio Code см. в статье Параметры пользователя и рабочей области.

Ошибка Visual Studio Code

Если появится следующее всплывающее сообщение об ошибке в Visual Studio Code:

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

В VS Code откройте представление выходных данных в области в нижней части экрана, а затем выберите Bicep:

Область вывода Visual Studio Code

Если в области отображаются следующие выходные данные, и вы используете Bicep CLI версии 0.4.1124 или более поздней версии, проверка, добавили dotnetAcquisitionExtension.existingDotnetPath ли вы параметр конфигурации в VS Code. См. раздел Ошибка среды выполнения .NET. Если этот параметр конфигурации присутствует, удалите его и перезапустите VS Code.

It was not possible to find any compatible framework version.

В противном случае создайте проблему в репозитории Bicep и включите в нее выходные сообщения.

Установлено несколько версий Bicep CLI

Если вы установили Bicep CLI вручную в несколько расположений, вы можете заметить непредвиденное поведение, например при запуске команды upgrade command не выполняется обновление Bicep CLI. Либо вы можете заметить, что при выполнении команды az bicep version возвращается одна версия, а при выполнении команды bicep --version — другая.

Чтобы устранить эту проблему, вы можете выполнить обновление во всех расположениях или выбрать одно из них для обслуживания и удалить установки в других расположениях.

Сначала откройте командную команду (не PowerShell) и выполните where bicep. Эта команда возвращает расположения установок Bicep. Если вы используете экземпляр Bicep CLI, управляемый Azure CLI, вы не увидите эту установку, так как она не добавлена в PATH. Если where bicep возвращает только одно расположение, возможно, между установленной вручную и установленной Azure CLI версиями возникает конфликт.

Чтобы сохранить все расположения установки, используйте тот же метод, который вы использовали ранее для установки Bicep CLI вручную, для всех расположений, которые вы хотите обслуживать. Если вы используете Azure CLI, выполните команду az bicep upgrade для обновления этой версии.

Чтобы сохранить только одно расположение для установки, выполните следующие действия:

Удалите файлы для установки, которые не хотите сохранить.
Удалите эти расположения из переменной среды PATH.

Если у вас есть установленная вручную версия и экземпляр, управляемый Azure CLI, вы можете объединить их в один экземпляр.

Удалите расположение установки, выполненной вручную.
Добавьте расположение Bicep CLI, установленного Azure CLI, в переменную PATH. Для Windows расположение, поддерживаемое Azure CLI, будет выглядеть так: %USERPROFILE%\.Azure\bin.

После добавления экземпляра Azure CLI в PATH вы можете использовать эту версию как с az bicep, так и с bicep.

Следующие шаги

Дополнительные сведения об использовании Visual Studio Code и расширения Bicep см. в кратком руководстве по созданию файлов Bicep с помощью Visual Studio Code.

Поделиться через