Lintador y formateador de YAML de GitHub Actions

Lintador y formateador de YAML de GitHub Actions

Pega un archivo de flujo de trabajo de GitHub Actions en la caja de entrada o haz clic en uno de los enlaces de ejemplo para cargar un ejemplo de CI, liberación o sintaxis obsoleta. El analizador valida tu flujo de trabajo contra un esquema integrado para desencadenadores, trabajos, pasos, ejecutores, permisos y llamadas reutilizables, y luego reformata el YAML con un orden de claves consciente del flujo de trabajo para que todos los archivos en tu repositorio tengan el mismo aspecto.

Cómo Usar

1. Pega tu .github/workflows/*.yml Coloca el archivo en la caja de entrada, o haz clic en uno de los enlaces de ejemplo para cargar un ejemplo de CI, liberación o sintaxis obsoleta.
2. Palanca Ordenar Claves para reordenar campos usando el orden convencional de GitHub Actions (nombre, on, permisos, trabajos, luego runs-on, needs, pasos).
3. Mantener Validar contra esquema de GitHub Actions activado para detectar campos obligatorios faltantes, tipos de eventos desconocidos, etiquetas de ejecutor inválidas y estructuras rotas needs referencias.
4. Mantener Mostrar sugerencias de mejores prácticas activado para sugerencias de cadena de suministro y fiabilidad (fijar acciones de terceros a una SHA, añadir timeout-minutes, reemplazar comandos obsoletos del flujo de trabajo).
5. Copiar el YAML formateado o descargarlo como un .yml archivo listo para commit.

Características

• Validación de esquema – Campos obligatorios de nivel superior (on, jobs), nombres permitidos de eventos de desencadenamiento, claves válidas para trabajos y pasos, y alcances correctos de permisos.
• Reglas para trabajos reutilizables – Detecta cuando un trabajo mezcla uses con runs-on o steps, lo que rechaza GitHub en tiempo de ejecución.
• Verificación del grafo de necesidades – Detecta referencias a sí mismo y dependencias de trabajos que no existen en el archivo.
• Analizador de referencias de acciones – Detecta valores que faltan uses: o que no están en @ref forma. owner/repo Detección de sintaxis obsoleta
• – Advertencia sobre entornos con la sustitución moderna. ::set-env, ::set-output, ::save-statey node12/node16 Sugerencias de mejores prácticas
• – Sugerencia de fijar acciones de terceros a una SHA de commit y añadir para evitar trabajos que se expandan indefinidamente. timeout-minutes Verificación de cron
• – Valida que las entradas de cron tengan exactamente cinco campos. Formateador consciente del flujo de trabajo on.schedule – Reordena las claves de nivel superior, nivel de trabajo y nivel de paso en el orden convencional de GitHub Actions para diferencias consistentes.
• – Ningún contenido del flujo de trabajo se envía a un servidor. ¿Por qué los flujos de trabajo de GitHub Actions son tan propensos a errores estructurales?
• Funciona completamente en tu navegador El YAML del flujo de trabajo sigue un esquema estricto con claves obligatorias de nivel superior, nombres fijos de eventos de desencadenamiento y reglas de claves por trabajo que cambian según si el trabajo es un trabajo normal o una llamada a un flujo de trabajo reutilizable. El archivo solo se analiza cuando se desencadena un evento en GitHub, por lo que un error de escritura en el nombre de una clave o un evento desconocido permanece silenciosamente en el repositorio hasta que el siguiente push o PR falle. La validación basada en esquema detecta estos tipos de errores antes de que lleguen al ejecutor.