/rpmdeplint-pipeline

rpmdeplint pipeline

rpmdeplint-pipeline

This repository contains the definition of the rpmdeplint CI pipeline.

This pipeline runs the rpmdeplint tool on RPM packages and publishes results via CI Messages.

** Important: ** Structure of the branches in this repository resembles branches in dist-git, i.e. master branch contains the pipeline definition for Fedora Rawhide, f32 branch is for Fedora 32, etc.

Test definition

The generic rpmdeplint test is described in a Flexible Metadata Format.

The actual definition lives in the rpmdeplint.fmf file.

Test execution

The pipeline delegates the test execution to the Testing Farm (TODO: link once available). The pipeline only collects, archive and report results.

However, it is possible to run the rpmdeplint test locally. To do that, clone this repository and run following command:

tmt run -a execute --script "/rpmdeplint/run_rpmdeplint.py -r f32 -t 43617203"

The command above will run rpmdeplint on a Koji build with the task Id "43617203" (f32-backgrounds-32.1.3-1.fc32) and it tests it in the context of Fedora 32.

Promoting new rpmdeplint image to production

The rpmdeplint.fmf file references a specific version of the container image which contains the rpmdeplint utility.

The version of the image (image tag) is a specific commit hash. By pinning down a specific version, we ensure that:

  • we always know what exactly is running in production
  • we can easily reproduce reported issues as we can pull the exact image from the container registry
  • we can easily rollback, if needed, simply by reverting a commit in this repository

The recommended workflow for promoting a new image to production is as follows:

  • build the image the official way
    • open a pull request with your changes in the rpmdeplint-image repository
    • let CI build the test image for you
    • let people review your changes
    • merge once satisfied
    • let CI build the official image for you
      • it will be tagged with the short commit hash of the master branch tip
  • open a pull request in this repository and update the image tag in the rpmdeplint.fmf
    • let CI create a test pipeline for you
    • try running some tests with the test pipeline
    • merge once satisfied
  • profit; or quickly revert the commit if the new image doesn't work as expected :)