Home

HOWTO contribute to Ceph CI Jenkins Jobs

The full documentation can be found in ceph-build.

Ensure you have credentials for the Ceph Jenkins Server.

Installation

• Ceph CI jobs are defined using Jenkins Job Builder, so install it:

# Fedora
sudo dnf install -y python3-jenkins-job-builder

# or use PIP
pip install --user jenkins-job-builder

• Download the RHCS Dashboard ceph-build fork and set the upstream:

git clone [email protected]:rhcs-dashboard/ceph-build.git
cd ceph-build
git remote add upstream [email protected]:ceph/ceph-build.git

Testing changes

• Create $HOME/.jenkins_jobs.ini on your local computer as explained in the docs.

• Create a branch:

git fetch upstream
git checkout upstream/master -b <my-branch>

• Test the jenkins job definition:

jenkins-jobs --conf ~/.jenkins_jobs.ini test \
ceph-dashboard-cephadm-e2e/config/definitions/ceph-dashboard-cephadm-e2e.yml

# Successful output (example):
[...]
INFO:jenkins_jobs.builder:Number of views generated:  0

• Push your job definition changes to the jenkins server:

  NOTE: the changes are NOT persistent, your PR must be merged for them to become permanent.

jenkins-jobs --ignore-cache --conf ~/.jenkins_jobs.ini update \
ceph-dashboard-cephadm-e2e/config/definitions/ceph-dashboard-cephadm-e2e.yml

# Successful output (example):
[...]
INFO:jenkins_jobs.builder:Number of jobs generated:  1
INFO:jenkins_jobs.builder:Reconfiguring jenkins job ceph-dashboard-cephadm-e2e
INFO:jenkins_jobs.cli.subcommand.update:Number of jobs updated: 1
INFO:jenkins_jobs.builder:Number of views generated:  0
INFO:jenkins_jobs.cli.subcommand.update:Number of views updated: 0