Uso de Bicep linter

La herramienta linter de Bicep comprueba los archivos de Bicep en busca de errores de sintaxis e infracciones de procedimientos recomendados. Linter ayuda a aplicar estándares de codificación mediante las instrucciones que proporciona durante el desarrollo. Puede personalizar los procedimientos recomendados que se van a usar para comprobar el archivo.

Requisitos de linter

La herramienta linter se integra en la CLI de Bicep y la extensión de Bicep para Visual Studio Code. Para usarlo, debe tener la CLI de Bicep versión 0.4 o posterior.

Reglas predeterminadas

El conjunto predeterminado de reglas de linter es mínimo y se obtiene de los casos de prueba de arm-ttk: La extensión y la CLI de Bicep comprueban las reglas siguientes, que se establecen en el nivel de advertencia.

Puede habilitar o deshabilitar todas las reglas de linter y controlar cómo se aplican mediante un archivo de configuración. Para invalidar el comportamiento predeterminado, cree un archivo bicepconfig.json con la configuración personalizada. Para obtener más información sobre cómo aplicar dicha configuración, consulte Agregar opciones personalizadas en el archivo de configuración de Bicep.

Uso en Visual Studio Code

En la captura de pantalla siguiente se muestra linter en Visual Studio Code:

En el panel PROBLEMAS , la captura de pantalla muestra cuatro errores, una advertencia y un mensaje de información. El mensaje informativo muestra el archivo de configuración de Bicep que se usa. Solo muestra este fragmento de información cuando se establece verbose en true en el archivo de configuración.

Mantenga el cursor del mouse sobre una de las áreas problemáticas. El linter proporciona los detalles sobre el error o la advertencia. Seleccione el área, también muestra una bombilla azul:

Seleccione la bombilla o el vínculo Corrección rápida para ver la solución:

Seleccione la solución para corregir el problema automáticamente.

Uso de la CLI de Bicep

En la captura de pantalla siguiente se muestra la herramienta linter en la línea de comandos. En la salida del comando de linting y del comando de compilación se muestra si se ha infringido alguna regla.

Puede integrar estas comprobaciones como parte de las canalizaciones de CI/CD. Puede usar una acción GitHub para intentar realizar una compilación de Bicep. Los errores producen un error en las canalizaciones.

Silenciamiento de los falsos positivos

A veces, una regla tiene falsos positivos. Por ejemplo, puede que necesite incluir un vínculo a un almacenamiento de blobs directamente sin usar la función environment().

Puede suprimir las reglas de linter de Bicep mediante disable-next-line y disable-diagnostics. Consulte Directivas. Si desea suprimir una regla de linter, cambie el nivel de la regla a Off en bicepconfig.json. En el ejemplo siguiente, se suprime la no-deployments-resources regla:

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

Pasos siguientes

• Para obtener más información sobre cómo personalizar las reglas de linter, consulte Agregar opciones personalizadas en el archivo de configuración de Bicep.
• 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.