Solución de problemas de la instalación de Bicep

En este artículo se describe cómo resolver posibles errores en la instalación de Bicep.

Error en tiempo de ejecución de .NET

Al instalar la extensión Bicep para Visual Studio Code, puede encontrarse con los siguientes mensajes de error:

Failed to install .NET runtime v5.0

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

Advertencia

Se trata de una solución de último recurso que puede causar problemas al actualizar versiones.

Para solucionar el problema, puede instalar manualmente .NET desde el sitio web de .NET y luego configurar Visual Studio Code para reutilizar una instalación existente de .NET. con la continuación siguiente:

Windows

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

macOS

Si necesita una instalación para x64, use lo siguiente:

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

En el caso de otras instalaciones de macOS, use lo siguiente:

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

Vea Configuración de área de trabajo y usuario para establecer la configuración de Visual Studio Code.

Error de Visual Studio Code

Si aparece el siguiente mensaje de error emergente en Visual Studio Code:

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

En VS Code, abra la vista Salida en el panel de la parte inferior de la pantalla y, después, seleccione Bicep:

Si aparece el siguiente resultado en el panel y usa la versión 0.4.1124 o posterior de la CLI de Bicep, compruebe si ha agregado la opción de configuración dotnetAcquisitionExtension.existingDotnetPath a VS Code. Consulte Error en tiempo de ejecución de .NET. Si esta opción de configuración está presente, quítela y reinicie VS Code.

It was not possible to find any compatible framework version.

En caso contrario, cree una incidencia en el repositorio de Bicep e incluya los mensajes de salida.

Varias versiones de la CLI de Bicep instaladas

Si instala manualmente la CLI de Bicep en más de una ubicación, es posible que observe un comportamiento inesperado como, por ejemplo, que la CLI de Bicep no se actualiza al ejecutar el comando de actualización. También puede observar que si ejecuta az bicep version devuelve una versión, pero si ejecuta bicep --version devuelve otra versión.

Para resolver este problema, puede actualizar todas las ubicaciones o seleccionar una ubicación para mantener y eliminar las otras ubicaciones.

En primer lugar, abra el símbolo del sistema (no PowerShell) y ejecute where bicep. Este comando devuelve las ubicaciones de las instalaciones de Bicep. Si usa la instancia de la CLI de Bicep que administra la CLI de Azure, no verá esta instalación porque no se agrega a PATH. Si where bicep solo devuelve una ubicación, es posible que las versiones en conflicto que está viendo sean la instalación manual y la instalación de la CLI de Azure.

Para conservar todas las ubicaciones de instalación, use el mismo método que usó anteriormente a fin de instalar manualmente la CLI de Bicep para todas las ubicaciones que quiera conservar. Si usa la CLI de Azure, ejecute az bicep upgrade para actualizar esa versión.

Para conservar solo una ubicación de instalación, siga estos pasos:

1. Elimine los archivos de las instalaciones que no quiere conservar.
2. Quite esas ubicaciones de la variable de entorno PATH.

Si tiene una instalación manual y la instancia que administra la CLI de Azure, puede combinar el uso con una instancia.

1. Elimine la ubicación de instalación manual.
2. Agregue la ubicación de la CLI de Bicep que ha instalado la CLI de Azure en la variable PATH. En el caso de Windows, la ubicación que mantiene la CLI de Azure es %USERPROFILE%\.Azure\bin.

Después de agregar la instancia de la CLI de Azure en PATH, puede usar esa versión con az bicep o bicep.

Pasos siguientes

Para obtener más información sobre el uso de Visual Studio Code y la extensión Bicep, consulte Inicio rápido: Creación de plantillas de archivos de Bicep con Visual Studio Code.