Bootstrap

Installation

Install cibyl from GitHub (Recommended):

pip install 'git+https://github.com/rhos-infra/cibyl.git'

Configuration

In order to use Cibyl’s CLI, you should set up configuration first in ~/.config/cibyl.yaml.

Configuration is structured as follows

# Minimal configuration

environments:                 # List of CI/CD environments
  production:                 # An environment called "production"
    production_jenkins:       # A single system called "production_jenkins"
      system_type: jenkins    # The type of the system (jenkins or zuul)
      sources:                # List of sources belong to "production_jenkins" system
        jenkins_api:          # The name of the source which belongs to "production_jenkins" system
          driver: jenkins     # The driver the source will be using
          url: https://...    # The URL of the system
          username: user      # The username to use for the authentication
          token: xyz          # The token to use for the authentication
          cert: False         # Disable/Enable certificates to use for the authentication

plugins:                      # (Optional) Specify the plugins to enable when running Cibyl
  - openstack                 # OpenStack adds its own product related models and arguments

Note

Red Hat OpenStack user? use the following command to set up the configuration:

wget https://url.corp.redhat.com/cibyl-config -O ~/.config/cibyl.yaml

For more information on how to set up the configuration, read the configuration section.

Usage - CLI

Once you’ve installed Cibyl and set up the configuration, you can start running cibyl commands

cibyl query --jobs will print all the jobs from each specified system in the configuration

To get an idea of what type of commands you can use with Cibyl, run cibyl -h

To get an idea of what type of information you query for with Cibyl, run cibyl query -h

For a more in depth guide on how to use Cibyl, read the CLI usage section.