Files
grafana/pkg/build/e2e-playwright
Ashley Harrison 2d1fb94f2d Playwright: Gate server start up with GRAFANA_URL env var (#108302)
* refactor so server is created unless GRAFANA_URL is provided

* update documentation

* don't swallow errors from the server process
2025-07-18 17:08:47 +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