Partager via


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 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 :

Volet de sortie de Visual Studio Code

Si vous voyez la sortie suivante dans le volet, vérifiez si vous avez ajouté le paramètre dotnetAcquisitionExtension.existingDotnetPath à VS Code. Si ce paramètre est présent, supprimez-le et redémarrez VS Code. Consultez Paramètres de l’utilisateur et de l’espace de travail pour configurer les paramètres de Visual Studio 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.