diff --git a/fedora-ci/jobs.md b/fedora-ci/jobs.md index e1be067de0..a5dcebcf34 100644 --- a/fedora-ci/jobs.md +++ b/fedora-ci/jobs.md @@ -9,27 +9,39 @@ Scratch builds in [Koji](https://koji.fedoraproject.org/koji/) built from SCM. ## Tests -### Installability +Each of the following tests is run in [Testing Farm](https://testing-farm.io) +automatically with a successful scratch build. -[Installability test](https://github.com/fedora-ci/installability-pipeline) -in [Testing Farm](https://testing-farm.io) run with a successful scratch build. +### installability + +[installability test](https://github.com/fedora-ci/installability-pipeline), +which checks that the built RPMs/SRPMs install cleanly, together with their dependencies. ### rpmlint -[rpmlint](https://github.com/rpm-software-management/rpmlint) -[test](https://github.com/packit/tmt-plans/tree/main/plans/rpmlint) -in [Testing Farm](https://testing-farm.io) run with a successful scratch build. +[rpmlint test](https://github.com/packit/tmt-plans/tree/main/plans/rpmlint), which is +based on [rpmlint](https://github.com/rpm-software-management/rpmlint). +Lints the built RPM/SRPM packages against Fedora packaging guidelines. ### rpminspect -[rpminspect](https://github.com/rpminspect/rpminspect) -[test](https://github.com/fedora-ci/rpminspect-pipeline) -in [Testing Farm](https://testing-farm.io) run with a successful scratch build. +[rpminspect test](https://github.com/fedora-ci/rpminspect-pipeline), which runs +[rpminspect](https://github.com/rpminspect/rpminspect) on the built RPM/SRPM packages. + +### rmdepcheck + +[rmdepcheck test](https://forge.fedoraproject.org/ci/shared-tests/src/branch/main/rmdepcheck), +which performs an RPM dependency check. + +### license-validate + +[license-validate test](https://forge.fedoraproject.org/ci/shared-tests/src/branch/main/license-validate), +which validates that the package's license defined in the .spec file +is [approved](https://docs.fedoraproject.org/en-US/legal/license-approval/#Software_License_List). -### Custom test plans +### custom test plans -Custom [TMT](https://tmt.readthedocs.io/) test plans in [Testing Farm](https://testing-farm.io) -run with a successful scratch build. This requires TMT metadata (`.fmf/version` presence used as an indicator) +Custom [TMT](https://tmt.readthedocs.io/) test plans, which require TMT metadata (`.fmf/version` presence used as an indicator) in the dist-git repository and at least one [test plan](https://tmt.readthedocs.io/en/stable/spec/plans.html) in `plans`. diff --git a/fedora-ci/retriggering.md b/fedora-ci/retriggering.md index 5431320daa..dcef165cfe 100644 --- a/fedora-ci/retriggering.md +++ b/fedora-ci/retriggering.md @@ -10,7 +10,7 @@ You can retrigger CI jobs in dist-git pull requests by posting comments that inc Fedora CI runs in two stages: 1. **Scratch build** — a Koji scratch build is created from the pull request. -2. **Tests** — once the scratch build succeeds, all configured tests (installability, rpmlint, rpminspect, custom TMT plans) are automatically triggered. +2. **Tests** — once the scratch build succeeds, all configured tests (installability, rpmlint, rpminspect, rmdepcheck, license-validate, custom TMT plans) are automatically triggered. Because tests depend on a successful scratch build, **retriggering a scratch build will also cause tests to re-run** once the new build succeeds. If you only need to re-run the tests (for example, because a test failed due to a transient infrastructure issue but the scratch build was fine), you can retrigger just the tests without rebuilding. @@ -52,10 +52,12 @@ To retrigger a specific test, you can add the test identifier to the command: Currently supported identifiers are: -- `installability` - represents the [Installability](/fedora-ci/jobs#installability) test +- `installability` - represents the [installability](/fedora-ci/jobs#installability) test - `rpmlint` - represents the [rpmlint](/fedora-ci/jobs#rpmlint) test - `rpminspect` - represents the [rpminspect](/fedora-ci/jobs#rpminspect) test -- `custom` - represents [Custom TMT test plans](/fedora-ci/jobs#custom-test-plans) +- `rmdepcheck` - represents the [rmdepcheck](/fedora-ci/jobs#rmdepcheck) test +- `license-validate` - represents the [license-validate](/fedora-ci/jobs#license-validate) test +- `custom` - represents [custom TMT test plans](/fedora-ci/jobs#custom-test-plans) Only packagers can retrigger tests.