test/README.md: Add section explaining GitHub integration

This commit is contained in:
Lars Karlitski 2019-06-28 18:37:45 +02:00
parent dc98837667
commit fce196ad4a
1 changed files with 17 additions and 0 deletions

View File

@ -58,3 +58,20 @@ To get the latest images you need to update it manually (in order not to poll
GitHub every time):
$ make -B bots
## GitHub integration
Tests are automatically triggered for every pull request. To disable tests for
a pull request, add the `no-test` label when opening it.
To interact with GitHub from scripts in `bots/`, generate [a
token](https://github.com/settings/tokens) with at least *repo:status*,
*public_repo*, and *read:org* permissions, and put it into
`~/.config/github-token`.
You can retry a failed test with:
$ bots/tests-trigger --repo weldr/lorax <PR> <test>
If no test is given, all failed tests will be retried. Pass `--allow` to
trigger tests on a pull request by an outside contributor.