Files
Josh Hunt 8502e1f2ce CI: Fix pa11y check by running in docker-puppeteer image (#107084)
* Change pa11y dagger to run in docker-puppeteer image

* export json results

* re-enable pa11y ci check

* update gha workflow to new flags

* add no-threshold-fail, use single pa11y config

* fix codeowners

* readme

* fix drone config
2025-06-24 14:40:37 +01:00
..

Pa11y accessability tests

We use pa11y to run some automated simple accessability tests. They're ran with dagger to help orchestrate starting server + tests in a reproducable manner.

To run the tests locally:

  1. Install dagger locally https://docs.dagger.io/install/
  2. Grab the grafana.tar.gz artifact by either
    1. Downloading it from the Github Action artifact from your PR
    2. Build it locally with:
      dagger run go run ./pkg/build/cmd artifacts -a targz:grafana:linux/amd64 --grafana-dir="$PWD" > dist/files.txt
      cat dist/files.txt # Will output the path to the grafana.tar.gz 
      
  3. Run the dagger pipeline with:
    dagger -v run go run ./pkg/build/a11y --package=(full path to .tar.gz) --results=./pa11y-ci-results.json
    
    The JSON results file will be saved to the file from the --results arg
  4. If they fail and you want to see the full output
    1. Run the dagger command with dagger -vE [...]
    2. At the end, arrow up to the exec pa11y-ci segment and hit Enter