README.md

check-compose

check-compose is a simple script for running various informational checks on a Fedora release or 'compose'. It will check for expected images that are missing, compare the images in the compose to those in the 'previous' compose (if it can), and check for openQA test jobs for the compose and print some information on their status, if the system where the check is running is correctly configured to talk to an openQA server. A fedmsg consumer that listens for 'compose complete' messages and runs check-compose on the new composes is also included.

Requirements

Python libraries:

If openqa_client is not available, openQA job checking will not be done. If fedmsg is not available, you will not be able to use the fedmsg consumer.

Installation

Install the required external Python libraries, then run python setup.py install. The fedmsg consumer config key is checkcomp_consumer.prod.enabled.

Configuration

check-compose will read configuration from /etc/check-compose.conf or ~/.config/check-compose.conf (with the latter taking priority if both exist). See check-compose.conf.sample for information on what you can set there. These and other options can also be set with command line arguments: arguments override config file settings, if passed.

License

check-compose is released under the GPL, version 3 or later. See COPYING and the header of check-compose itself.