Résoudre les problèmes d’installation de Bicep

Cet article explique comment résoudre les erreurs potentielles lors de votre installation de Bicep.

Erreur de runtime .NET

Lors de l’installation de l’extension Bicep pour Visual Studio Code, vous pouvez rencontrer les messages d’erreur suivants :

Failed to install .NET runtime v5.0

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

Avertissement

Il s’agit d’une solution de dernier recours pouvant entraîner des problèmes lors de la mise à jour des versions.

Pour résoudre le problème, vous pouvez installer manuellement .NET à partir du site web de .NET, puis configurer Visual Studio Code pour réutiliser une installation existante de .NET avec les paramètres suivants :

Windows

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

macOS

Si vous avez besoin d’une installation x64,, utilisez :

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

Pour les autres installations macOS,, utilisez :

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

Consultez Paramètres de l’utilisateur et de l’espace de travail pour configurer les paramètres de Visual Studio Code.

Erreur Visual Studio Code

Si la fenêtre contextuelle du message d’erreur suivant s’affiche dans Visual Studio Code :

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

À partir de VS Code, ouvrez l’affichage Sortie dans le volet en bas de l’écran, puis sélectionnez Bicep :

Si vous voyez la sortie suivante dans le volet et que vous utilisez l’interface CLI Bicep version 0.4.1124 ou ultérieure, vérifiez que vous avez ajouté l’option de configuration dotnetAcquisitionExtension.existingDotnetPath à VS Code. Consultez l’erreur de runtime .NET. Si cette option de configuration est présente, supprimez-la et redémarrez VS Code.

It was not possible to find any compatible framework version.

Dans le cas contraire, élevez un problème dans le référentiel Bicep et incluez les messages de sortie.

Plusieurs versions de Bicep CLI installées

Si vous installez manuellement Bicep CLI à plusieurs emplacements, vous remarquerez peut-être un comportement inattendu tel que Bicep CLI qui ne se met pas à jour lorsque vous exécutez la commande de mise à niveau. Vous remarquerez également que l’exécution de az bicep version renvoie une version, mais que celle de bicep --version renvoie une version différente.

Pour résoudre ce problème, vous pouvez soit mettre à jour tous les emplacements, soit sélectionner un emplacement à conserver et supprimer les autres emplacements.

Tout d’abord, ouvrez votre invite de commandes (pas PowerShell), puis exécutez where bicep. Cette commande renvoie les emplacements de vos installations de Bicep. Si vous utilisez l’instance de Bicep CLI gérée par Azure CLI, vous ne verrez pas cette installation, car elle n’est pas ajoutée à la variable PATH. Si where bicep ne renvoie qu’un seul emplacement, il est possible que les versions en conflit que vous voyez soient entre l’installation manuelle et l’installation d’Azure CLI.

Pour conserver tous les emplacements d’installation, utilisez la même méthode que celle utilisée précédemment pour installer manuellement Bicep CLI pour tous les emplacements que vous souhaitez conserver. Si vous utilisez Azure CLI, exécutez az bicep upgrade pour mettre à jour cette version.

Pour conserver un seul emplacement d’installation, utilisez la procédure suivante :

1. Supprimez les fichiers des installations que vous ne souhaitez pas conserver.
2. Supprimez ces emplacements de la variable d’environnement PATH.

Si vous disposez à la fois d’une installation manuelle et d’une instance gérée par Azure CLI, vous pouvez combiner vos utilisations en une seule instance.

1. Supprimez l’emplacement de l’installation manuelle.
2. Ajoutez l’emplacement de Bicep CLI installé par Azure CLI à la variable PATH. Par Windows, l’emplacement conservé par Azure CLI est %USERPROFILE%\.Azure\bin.

Après avoir ajouté l’instance Azure CLI à la variable PATH, vous pouvez utiliser cette version avec az bicep ou bicep.

Étapes suivantes

Pour plus d’informations sur l’utilisation de Visual Studio Code et l’extension Bicep, consultez Démarrage rapide : Créer des fichiers Bicep avec Visual Studio Code.