GitLab CI

Ejecuta comprobaciones de accesibilidad en cada merge request

Usa el mismo contrato de comprobación de wcagc en GitLab CI: prueba las URL de vista previa, compara los hallazgos con una línea base y haz explícito el veredicto del pipeline.

Crear una clave de API

Añade la plantilla del pipeline

Guarda la clave de API y las URL de destino como variables de CI/CD y añade los jobs reutilizables. Las merge requests solo comparan; la rama predeterminada se encarga de actualizar la línea base.

.wcagc-check:
  image: node:24-alpine
  script:
    - npx --yes github:WCAG-Compliance/wcagc-ci#v1

wcagc-merge-request:
  extends: .wcagc-check
  rules:
    - if: '$CI_PIPELINE_SOURCE == "merge_request_event"'

wcagc-default-branch-baseline:
  extends: .wcagc-check
  variables:
    WCAGC_FAIL_ON: none
    WCAGC_SET_BASELINE: "true"
  rules:
    - if: '$CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH'

Configura las variables de CI/CD

Mantén la configuración explícita y las credenciales fuera del repositorio.

WCAGC_API_KEY
Secreto enmascarado obligatorio, solo con el ámbito ci:check. No lo expongas a pipelines de forks no fiables.
WCAGC_URLS
Obligatorio: URL registradas separadas por saltos de línea o comas, con un máximo de 20 por comprobación.
WCAGC_FAIL_ON
Usa new-critical por defecto, o elige any-critical, serious-or-worse o none.
WCAGC_SET_BASELINE
Ponlo en true solo en el job protegido de la rama predeterminada, para que los pipelines de revisión no puedan reescribir el punto de comparación.

Trata los pipelines de merge requests como un límite de confianza

Las variables protegidas de GitLab solo están disponibles para refs protegidas que cumplan los requisitos, salvo que relajes esa política de forma explícita. Revisa la configuración de forks y variables protegidas antes de ejecutar contribuciones externas.

Salida sencilla y códigos de salida predecibles

La CLI muestra los recuentos por gravedad, los hallazgos nuevos, el enlace al informe y la limitación de la cobertura automática. PASS sale con 0, una comprobación fallida o un error de ejecución sale con 1 y una configuración no válida sale con 2.