Utiliser le linter Bicep

Le linter Bicep vérifie les fichiers Bicep pour rechercher les erreurs de syntaxe et les infractions aux meilleures pratiques. Ce linter facilite l’application des normes de code en proposant des conseils pendant le développement. Vous pouvez personnaliser les meilleures pratiques à utiliser pour vérifier le fichier.

Exigences relatives aux linters

Le linter est intégré à l’interface CLI Bicep et à l’extension Bicep pour Visual Studio Code. Pour l’utiliser, vous devez disposer de l’interface CLI Bicep version 0.4 ou ultérieure.

Règles par défaut

L’ensemble par défaut des règles du linter est minimal et extrait des cas de test arm-ttk. L’extension et l’interface CLI de Bicep vérifient les règles suivantes, qui sont définies sur le niveau avertissement.

Vous pouvez activer ou désactiver toutes les règles du linter et contrôler la manière dont elles sont appliquées à l’aide d’un fichier de configuration. Pour remplacer le comportement par défaut, créez un fichier bicepconfig.json avec vos paramètres personnalisés. Pour plus d’informations sur l’application de ces paramètres, consultez Ajouter des paramètres personnalisés dans le fichier de configuration Bicep.

Utiliser dans Visual Studio Code

La capture d’écran suivante montre le linter dans Visual Studio Code :

Dans le volet PROBLÈMES , la capture d’écran affiche quatre erreurs, un avertissement et un message d’informations. Le message d’information affiche le fichier de configuration Bicep utilisé. Ce type d’information n’est affichée que lorsque vous définissez verbose sur true dans le fichier de configuration.

Placez le curseur de la souris sur l’une des zones de problème. Le linter fournit les détails sur l’erreur ou l’avertissement. Sélectionnez la zone pour afficher également une ampoule bleue :

Sélectionnez soit l’ampoule, soit le lien Correctif rapide pour voir la solution :

Sélectionnez la solution pour résoudre le problème automatiquement.

Utiliser dans l’interface CLI Bicep

La capture d’écran suivante montre le linter dans la ligne de commande. La sortie de la commande lint et de la commande build affiche toutes les violations aux règles.

Vous pouvez intégrer ces vérifications dans le cadre de vos pipelines CI/CD. Vous pouvez utiliser une action GitHub pour tenter une génération de Bicep. Les erreurs font échouer les pipelines.

Ignorer les faux-positifs

Parfois, une règle a des faux positifs. Par exemple, vous pourriez devoir inclure un lien vers un stockage d’objets blob directement sans utiliser la fonction environment().

Vous pouvez désactiver les règles du linter Bicep en utilisant disable-next-line et disable-diagnostics. Consultez les directives. Si vous souhaitez supprimer une règle linter, modifiez le niveau de la règle Off dans bicepconfig.json. Dans l’exemple suivant, la no-deployments-resources règle est supprimée :

{
  "analyzers": {
    "core": {
      "rules": {
        "no-deployments-resources": {
          "level": "off"
        }
      }
    }
  }
}

Étapes suivantes

• Pour plus d’informations sur la personnalisation des règles du linter, consultez Ajouter des paramètres personnalisés dans le fichier de configuration Bicep.
• 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.