GitLab CI

Esegui controlli di accessibilità in ogni merge request

Usa lo stesso contratto di controllo di wcagc in GitLab CI: testa gli URL di anteprima, confronta i problemi con una baseline e rendi esplicito l’esito della pipeline.

Crea una chiave API

Aggiungi il template di pipeline

Salva la chiave API e gli URL di destinazione come variabili CI/CD, poi aggiungi i job riutilizzabili. Le merge request si limitano a confrontare; il ramo predefinito gestisce gli aggiornamenti della baseline.

.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 le variabili CI/CD

Mantieni la configurazione esplicita e le credenziali fuori dal repository.

WCAGC_API_KEY
Segreto mascherato obbligatorio, solo con l’ambito ci:check. Non esporlo alle pipeline di fork non attendibili.
WCAGC_URLS
URL registrati obbligatori, separati da nuove righe o virgole, fino a un massimo di 20 per controllo.
WCAGC_FAIL_ON
Usa new-critical per impostazione predefinita, oppure scegli any-critical, serious-or-worse o none.
WCAGC_SET_BASELINE
Imposta true solo nel job protetto del ramo predefinito, così le pipeline di revisione non possono riscrivere il punto di confronto.

Tratta le pipeline delle merge request come un confine di fiducia

Le variabili protette di GitLab sono disponibili solo per i ref protetti idonei, a meno che tu non allenti esplicitamente questa policy. Controlla le impostazioni di fork e variabili protette prima di eseguire contributi esterni.

Output semplice e codici di uscita prevedibili

La CLI stampa i conteggi per gravità, i nuovi problemi, il link al report e il limite di copertura dell’automazione. PASS termina con codice 0, un controllo fallito o un errore di runtime termina con 1, una configurazione non valida termina con 2.