Bicep 설치 문제 해결

  • 아티클

이 문서에서는 Bicep 설치의 잠재적인 오류를 해결하는 방법을 설명합니다.

.NET 런타임 오류

Visual Studio Code용 Bicep 확장을 설치할 때 다음 오류 메시지가 표시될 수 있습니다.

Failed to install .NET runtime v5.0

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

Warning

이는 버전을 업데이트할 때 문제를 일으킬 수 있는 최후의 수단 솔루션입니다.

문제를 해결하기 위해 .NET 웹 사이트에서 .NET을 수동으로 설치한 후 다음 설정을 사용하여 .NET의 기존 설치를 다시 사용하도록 Visual Studio Code를 구성할 수 있습니다.

Windows

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

macOS

x64 설치가 필요한 경우 다음을 사용합니다.

"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 이상을 사용하는 경우 VS Code에 구성 옵션을 추가 dotnetAcquisitionExtension.existingDotnetPath 했는지 여부를 검사. .NET 런타임 오류를 참조하세요. 이 구성 옵션이 있는 경우 해당 옵션을 제거하고 VS Code를 다시 시작합니다.

It was not possible to find any compatible framework version.

그렇지 않으면 출력 메시지를 포함하여 Bicep 리포지토리의 문제를 제기하세요.

여러 버전의 Bicep CLI 설치

Bicep CLI를 두 개 이상의 위치에 수동으로 설치하는 경우 upgrade 명령을 실행할 때 Bicep CLI가 업데이트되지 않는 등의 예기치 않은 동작이 발생할 수 있습니다. 또는 az bicep version을 실행하면 하나의 버전이 반환되지만 bicep --version이 다른 버전을 반환할 수 있습니다.

이 문제를 해결하려면 모든 위치를 업데이트하거나 유지할 한 위치를 선택하고 다른 위치를 삭제할 수 있습니다.

먼저 명령 프롬프트(PowerShell이 아님)를 열고 where bicep를 실행합니다. 이 명령은 Bicep 설치 위치를 반환합니다. Azure CLI에서 관리되는 Bicep CLI 인스턴스를 사용하는 경우 PATH에 추가되지 않으므로 이 설치가 표시되지 않습니다. where bicep이 한 위치만 반환하는 경우 수동 설치와 Azure CLI 설치 간에 충돌하는 버전이 표시될 수 있습니다.

모든 설치 위치를 유지하려면 이전에 사용한 동일한 방법을 사용하여 유지하려는 모든 위치에 대해 Bicep CLI를 수동으로 설치합니다. Azure CLI를 사용하는 경우 az bicep upgrade를 실행하여 해당 버전을 업데이트합니다.

설치 위치를 하나만 유지하려면 다음 단계를 사용합니다.

  1. 유지하지 않으려는 설치에 대한 파일을 삭제합니다.
  2. PATH 환경 변수에서 해당 위치를 제거합니다.

수동 설치와 Azure CLI에서 관리형 인스턴스가 모두 있는 경우 용도를 하나의 인스턴스에 결합할 수 있습니다.

  1. 수동 설치 위치를 삭제합니다.
  2. Azure CLI에서 설치된 Bicep CLI의 위치를 PATH 변수에 추가합니다. Windows의 경우 Azure CLI에서 유지되는 위치는 %USERPROFILE%\.Azure\bin입니다.

PATH에 Azure CLI 인스턴스를 추가한 후 az bicep 또는 bicep에서 해당 버전을 사용할 수 있습니다.

다음 단계

Visual Studio Code 및 Bicep 확장 사용에 대한 자세한 내용은 빠른 시작: Visual Studio Code를 사용하여 Bicep 파일 만들기를 참조하세요.