Rollup merge of #138307 - Kobzol:citool-alias, r=marcoieni

Allow specifying glob patterns for try jobs

This PR modifies the `try-job` lookup logic to allow glob patterns. So you can e.g. request all MSVC-related jobs with `try-job: *msvc*`.

Best reviewed commit by commit.

r? ``````@marcoieni``````

try-job: `*msvc*`
This commit is contained in:
Jakub Beránek 2025-03-11 13:30:54 +01:00 committed by GitHub
commit 2ce0b8f03e
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 18 additions and 10 deletions

View File

@ -133,29 +133,37 @@ There are several use-cases for try builds:
Again, a working compiler build is needed for this, which can be produced by Again, a working compiler build is needed for this, which can be produced by
the [dist-x86_64-linux] CI job. the [dist-x86_64-linux] CI job.
- Run a specific CI job (e.g. Windows tests) on a PR, to quickly test if it - Run a specific CI job (e.g. Windows tests) on a PR, to quickly test if it
passes the test suite executed by that job. You can select which CI jobs will passes the test suite executed by that job.
be executed in the try build by adding up to 10 lines containing `try-job:
<name of job>` to the PR description. All such specified jobs will be executed You can select which CI jobs will
in the try build once the `@bors try` command is used on the PR. If no try be executed in the try build by adding lines containing `try-job:
jobs are specified in this way, the jobs defined in the `try` section of <job pattern>` to the PR description. All such specified jobs will be executed
[`jobs.yml`] will be executed by default. in the try build once the `@bors try` command is used on the PR. If no try
jobs are specified in this way, the jobs defined in the `try` section of
[`jobs.yml`] will be executed by default.
Each pattern can either be an exact name of a job or a glob pattern that matches multiple jobs,
for example `*msvc*` or `*-alt`. You can start at most 20 jobs in a single try build. When using
glob patterns, you might want to wrap them in backticks (`` ` ``) to avoid GitHub rendering
the pattern as Markdown.
> **Using `try-job` PR description directives** > **Using `try-job` PR description directives**
> >
> 1. Identify which set of try-jobs (max 10) you would like to exercise. You can > 1. Identify which set of try-jobs you would like to exercise. You can
> find the name of the CI jobs in [`jobs.yml`]. > find the name of the CI jobs in [`jobs.yml`].
> >
> 2. Amend PR description to include (usually at the end of the PR description) > 2. Amend PR description to include a set of patterns (usually at the end
> e.g. > of the PR description), for example:
> >
> ```text > ```text
> This PR fixes #123456. > This PR fixes #123456.
> >
> try-job: x86_64-msvc > try-job: x86_64-msvc
> try-job: test-various > try-job: test-various
> try-job: `*-alt`
> ``` > ```
> >
> Each `try-job` directive must be on its own line. > Each `try-job` pattern must be on its own line.
> >
> 3. Run the prescribed try jobs with `@bors try`. As aforementioned, this > 3. Run the prescribed try jobs with `@bors try`. As aforementioned, this
> requires the user to either (1) have `try` permissions or (2) be delegated > requires the user to either (1) have `try` permissions or (2) be delegated