CSI driver for Ceph
Go to file
Niels de Vos 6e3c1dadae ci: add --base=<branch> to checkout a base branch
When checking out a PR for a non-master branch, `git clone` should
download the last commit of the branch. Adding a `--base=..` option to
pass the cloning of a selected branch, instead of `master`.

We also want to fetch all commits in the PR, so they can get tested with
`commitlint`. Only fetch --depth=1 the initial clone, but fetch
everything in the PR itself.

Signed-off-by: Niels de Vos <ndevos@redhat.com>
2020-05-27 12:52:21 +02:00
deploy ci: address yamllint issues in deploy/jjb-validate.yaml 2020-05-27 12:52:21 +02:00
scripts ci: add 'make test' target to validate CI job scripts 2020-05-27 12:52:21 +02:00
.commitlintrc.yml ci: add 'make test' target to validate CI job scripts 2020-05-27 12:52:21 +02:00
.gitignore ci: add 'make test' target to validate CI job scripts 2020-05-27 12:52:21 +02:00
ci-job-validation.groovy ci: add --base=<branch> to checkout a base branch 2020-05-27 12:52:21 +02:00
ci-job-validation.yaml ci: add job for checking ci/centos contents 2020-05-27 12:52:21 +02:00
containerized-tests.groovy ci: use parameters set by github-pull-request-builder 2020-05-25 17:10:06 +02:00
containerized-tests.yaml ci: use parameters set by github-pull-request-builder 2020-05-25 17:10:06 +02:00
jjb-deploy.yaml ci: automatically deploy Jenkins jobs after merge 2020-05-27 12:52:21 +02:00
jjb-validate.yaml ci: add CentOS CI job for jjb-validation 2020-05-27 12:52:21 +02:00
Makefile ci: add 'make test' target to validate CI job scripts 2020-05-27 12:52:21 +02:00
prepare.sh ci: add --base=<branch> to checkout a base branch 2020-05-27 12:52:21 +02:00
README.md ci: address MarkDown linter issues in README.md 2020-05-27 12:52:21 +02:00

Continuous Integration Jobs for the CentOS CI

  • dedicated Jenkins instance for Ceph-CSI
  • Jenkins is hosted on OpenShift in the CentOS CI
  • scripts and Jenkins jobs are hosted in the Ceph-CSI repository (ci/centos branch)
  • a Jenkins Pipeline is used to reserve bare metal system(s), and run jobs on those systems

Repository/Branch Structure

This is the ci/centos branch, where all the scripts for the Jenkins jobs are maintained. The tests that are executed by the jobs are part of the normal projects branches.

As an example, the containerized-tests Jenkins job consists out of the following files:

  • containerized-tests.yaml is a Jenkins Job Builder configuration that describes the events when the job should get run and fetches the .groovy file from the git repository/branch

  • containerized-tests.groovy is the Jenkins Pipeline that contains the stages for the Jenkins Job itself. In order to work with the bare-metal machines from the CentOS CI, it executes the following stages:

    1. dynamically allocate a Jenkins Slave (node('cico-workspace')) with tools and configuration to request a bare-metal machine
    2. checkout the centos/ci branch of the repository, which contains scripts for provisioning and preparing the environment for running tests
    3. reserve a bare-metal machine with cico (configured on the Jenkins Slave)
    4. provision the reserved bare-metal machine with additional tools and dependencies to run the test (see prepare.sh below)
    5. run make containerized-tests and make containerized-build in parallel
    6. as final step, return the bare-metal machine to the CentOS CI for other users (it will be re-installed with a minimal CentOS environment again)
  • prepare.sh installs dependencies for the test, and checks out the git repository and branch (or Pull Request) that contains the commits to be tested (and the test itself)

Deploying the Jenkins Jobs

The Jenkins Jobs are described in Jenkins Job Builder configuration files and Jenkins Pipelines. These need to be imported in the Jenkins instance before they can be run. Importing is done with the jenkins-jobs command, which runs in a jjb container. To build the container, and provide the configuration for Jenkins Job Builder, see the documentation in the deploy/ directory.