oVirt-CI

Command line tool for working with oVirt CI.

Installation

On Fedora 29 or later:

sudo dnf install \
    NetworkManager \
    cairo-gobject-devel \
    gcc \
    gobject-introspection-devel \
    python2-devel \
    python3-devel

On Ubuntu Xenial:

sudo apt-get install \
    gcc \
    gir1.2-networkmanager-1.0 \
    libgirepository1.0-dev \
    network-manager \
    python2-dev \
    python3-dev

Install requirements:

pip install -r requirements.txt --user

Setup

Visit https://jenkins.ovirt.org/user/username/configure and create an API Token.

Keep your Jenkins user id and API Token in the configuration file at:

~/.config/ovirt-ci.conf

Here is an example configuration file:

[jenkins]
user_id = johnd
api_token = 3e8cd699a2564d9ba2855831bf4cb5eb

Full example is available at: ovirt-ci.conf.example

Bash auto-completion

To setup bash auto-completion for ovirt-ci tool, install the bash-completion package, and copy bash-completion/ovirt-ci to /usr/share/bash-completion/completions/.

When starting new bash shell, you can use <tab> to auto-complete ovirt-ci commands.

Usage

Building artifacts for a change:

$ ./ovirt-ci build-artifacts 54321

This command will invoke the build-artifacts stage for the project. You can use the job URL printed by the command to run oVirt system tests manually.

Running oVirt system tests with a change:

$ ./ovirt-ci system-tests 54321

This commands builds artifacts with the patch above, and run oVirt system tests job with the built artifacts. When the test run is completed, add a comment about the run to the patch.

Contributing

PRs are welcome!

First instal tox.

On Fedora:

$ sudo dnf install python2-tox

If the distribution tox is too old, you can install using:

$ pip install tox --user.

To run the tests locally, use:

$ tox