README.md

autocloudreporter

autocloudreporter is a fedora-messaging consumer for reporting Autocloud results to ResultsDB. It listens out for Autocloud messages and submits results using the resultsdb_conventions module for conveniently reporting results in 'conventional' format.

Requirements

Python libraries:

Installation

Install the required external Python libraries, then use setuptools to install, e.g.:

    python3 setup.py install

Next, run dnf install fedora-messaging, copy autocloudreporter.toml to /etc/fedora-messaging and modify it as appropriate. You must at least change the queue name to a unique, private value (the official recommendation is to use a UUID generated by uuidgen). You will likely also need to change the URL settings in consumer_config. Then you can enable and start the consumer as a systemd service:

sudo systemctl enable fm-consumer@autocloudreporter
sudo systemctl start fm-consumer@autocloudreporter

PLEASE do not enable the consumer on a system authorized to submit results to Fedora's official ResultsDB instances without checking with Fedora QA.

License

autocloudreporter is released under the GPL, version 3 or later. See COPYING and the header of autocloudreporter.py itself.

Contributing

Issues and pull requests can be filed in Pagure. Pull requests must be signed off (use the -s git argument). By signing off your pull request you are agreeing to the Developer's Certificate of Origin:

Developer's Certificate of Origin 1.1

By making a contribution to this project, I certify that:

(a) The contribution was created in whole or in part by me and I
    have the right to submit it under the open source license
    indicated in the file; or

(b) The contribution is based upon previous work that, to the best
    of my knowledge, is covered under an appropriate open source
    license and I have the right under that license to submit that
    work with modifications, whether created in whole or in part
    by me, under the same open source license (unless I am
    permitted to submit under a different license), as indicated
    in the file; or

(c) The contribution was provided directly to me by some other
    person who certified (a), (b) or (c) and I have not modified
    it.

(d) I understand and agree that this project and the contribution
    are public and that a record of the contribution (including all
    personal information I submit with it, including my sign-off) is
    maintained indefinitely and may be redistributed consistent with
    this project or the open source license(s) involved.