github/kata-containers
1
0
Fork 1
mirror of https://github.com/kata-containers/kata-containers.git synced 2025-07-16 16:32:03 +00:00
Code Issues Projects Releases Wiki Activity

doc: Update required job process

Browse Source 
Add information about using required-tests.yaml
as a way to track jobs that are required.

Signed-off-by: stevenhorsman <steven@uk.ibm.com>
This commit is contained in:
stevenhorsman 2025-03-31 16:29:48 +01:00
parent 0dbf4ec39f
commit 75dc4ce3bf
1 changed files with 21 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
ci/README.md
View File

@ -172,12 +172,28 @@ For new jobs, or jobs that haven't been marked as required recently,
the criteria to be initially marked as required is ten days the criteria to be initially marked as required is ten days
of passing tests, with no relevant PR failures reported in that time. of passing tests, with no relevant PR failures reported in that time.
Required jobs also need one or more nominated maintainers that are Required jobs also need one or more nominated maintainers that are
responsible for the stability of their jobs. responsible for the stability of their jobs. Maintainers can be registered
in [`maintainers.yml`](https://github.com/kata-containers/kata-containers.github.io/blob/main/maintainers.yml)
and will then show on the CI Dashboard.
> [!NOTE] To add transparency to making jobs required/non-required and to keep the
> We don't currently have a good place to record the job maintainers, but GitHub UI in sync with the [Gatekeeper job](../tools/testing/gatekeeper),
> once we have this, the intention is to show it on the CI Dashboard so the process to update a job's required state is as follows:
> people can find the contact easily. 1. Create a PR to update `maintainers.yml`, if new maintainers are being
declared on a CI job.
1. Create a PR which updates
[`required-tests.yaml`](../tools/testing/gatekeeper/required-tests.yaml)
adding the new job and listing the evidence that the job meets the
requirements above. Ensure that all maintainers and
@kata-containers/architecture-committee are notified to give them the
opportunity to review the PR. See
[#11015](https://github.com/kata-containers/kata-containers/pull/11015)
as an example.
1. The maintainers and Architecture Committee get a chance to review the PR.
It can be discussed in an AC meeting to get broader input.
1. Once the PR has been merged, a Kata Containers admin should be notified
to ensure that the GitHub UI is updated to reflect the change in
`required-tests.yaml`.
#### Expectation of required job maintainers #### Expectation of required job maintainers