gecko-dev/testing/web-platform/tests/docs/running-tests/from-ci.md
Philip Jägenstedt 91982c86a4 Bug 1578995 [wpt PR 18870] - Add triggers/* branches to support triggering full runs, a=testonly
Automatic update from web-platform-tests
Add triggers/* branches to support triggering full runs (#18870)

Handle empty list of commits in `get_extra_jobs`, since that's possible when force pushing.

Fixes https://github.com/web-platform-tests/wpt/issues/13263.
--

wpt-commits: d86745dade74feb7897b47eb9eca3c8b3c3d924d
wpt-pr: 18870
2019-09-12 10:09:58 +00:00

1.5 KiB

Running Tests on CI

Contributors with write access to the repository can trigger full runs in the same CI systems used to produce results for wpt.fyi. The runs are triggered by pushing to branch names on the form triggers/$browser_$channel and the results will be automatically submitted to wpt.fyi.

This is useful when making infrastructure changes that could affect very many tests, in order to avoid regressions.

Note: Full runs use a lot of CI resources, so please take care to not trigger them more than necessary.

Instructions:

  • Base your changes on a commit for which there are already results in wpt.fyi.

  • Determine which branch name to push to by looking for refs/heads/triggers/ in .azure-pipelines.yml and .taskcluster.yml. For example, to trigger a full run of Safari Technology Preview, the branch name is triggers/safari_preview.

  • Force push to the branch, for example: git push --force-with-lease origin HEAD:triggers/safari_preview. The --force-with-lease argument is to detect if someone else has just pushed. When this happens wait for the checkout step of their triggered run to finish before you force push again.

You can see if the run started from the commit status on GitHub's commits listing (example) and if successful the results will show up on wpt.fyi within 10 minutes (example).