README.md

Fedora nightly image finder

This tool generates JSON and HTML data on Fedora nightly compose images. For each image, it tracks successful composes and - if openQA tests the image - whether it passed all tests. The HTML file is intended to be served for users to be able to conveniently locate the most recent successful and/or tested compose of a given image for Rawhide and Branched.

/var/lib/fedora_nightlies and /var/www/fedora_nightlies must exist and allow the user running the tool to read and create files. The JSON file is /var/lib/fedora_nightlies/nightlies.json, and the HTML file is /var/www/fedora_nightlies/nightlies.html; these also must be readable and writeable by the user running the tool. You are expected to configure some kind of web server to serve out nightlies.html, so it must be allowed to read that file.

To initialize the data, run the script directly (or as fedora_nightlies after doing python setup.py install). To use the fedmsg consumer which updates the data automatically whenever a compose appears or testing for one completes, ensure fedmsg-hub is installed and enabled, run python setup.py install, enable the nightlyconsumer.prod.enabled fedmsg config key and restart the fedmsg-hub service.