ceph-csi/deploy
Niels de Vos b5216592e2 ci: deploy a private container image registry
With a private container image registry, the images that CI jobs use can
be cached and re-used. This speeds up the CI jobs, as building the
container images takes up the majority of the runtime for some jobs.

Signed-off-by: Niels de Vos <ndevos@redhat.com>
2020-10-30 13:07:58 +00:00
..
checkout-repo.sh ci: checkout FETCH_HEAD instead of GIT_REF 2020-09-22 11:59:31 +02:00
container-registry.yaml ci: deploy a private container image registry 2020-10-30 13:07:58 +00:00
Dockerfile add scripts and configuration to deploy with Jenkins Job Builder 2020-04-01 14:15:04 +02:00
jjb-buildconfig.yaml ci: fix yamllint issues in jjb-buildconfig.yaml 2020-05-27 12:52:21 +02:00
jjb-config.yaml add scripts and configuration to deploy with Jenkins Job Builder 2020-04-01 14:15:04 +02:00
jjb-deploy.yaml ci: run jjb-validate batch job against a PR 2020-09-22 11:59:31 +02:00
jjb-validate.yaml ci: run jjb-validate batch job against a PR 2020-09-22 11:59:31 +02:00
jjb.sh ci: restructure 'parameters' section for upgrade-tests 2020-09-22 10:30:38 +00:00
Makefile ci: remove old jobs when deploying 2020-09-25 08:03:00 +00:00
README.md add scripts and configuration to deploy with Jenkins Job Builder 2020-04-01 14:15:04 +02:00

Deploying Jenkins Jobs through OpenShift

This deploy/ directory contains the configuration to prepare running Jenkins Job Builder on OpenShift and update/add Jenkins Jobs in an environment hosted in the same OpenShift project.

The used Jenkins environment is expected to be deployed already. This is done by the CentOS CI team when a request for CI resources is handled. The deploying and configuration of Jenkins is therefor not part of this document.

Building the Jenkins Job Builder container image

OpenShift has a feature called ImageStreams. This can be used to build the container image that contains the jenkins-jobs executable to test and update/add jobs in a Jenkins environment.

All .yaml files in this directory need to be pushed into OpenShift, use oc create -f <file> for that.

  • the Dockerfile uses pip to install jenkins-jobs, the BuildConfig object in OpenShift can then be used to build the image
  • checkout-repo.sh will be included in the container image, and checks out the ci/centos branch of the repository
  • together with the Makefile (checked out with checkout-repo.sh), the Jenkins Jobs can be validated or deployed
  • jjb-buildconfig.yaml creates the ImageStream and the BuildConfig objects. Once created with oc create, the OpenShift Console shows a Build button for the jjb image under the Builds/Builds menu
  • jjb-config.yaml is the /etc/jenkins_jobs/jenkins_jobs.ini configuration files that contains username, password/token and URL to the Jenkins instance (edit this file before pushing to OpenShift)
  • jjb-validate.yaml is the OpenShift Job that creates a Pod, runs the validation test and exits. The job needs to be deleted from OpenShift before it can be run again.
  • jjb-deploy.yaml is the OpenShift Job that creates a Pod, runs jenkins-jobs to push the new jobs to the Jenkins environment. This pod uses the jjb-config ConfigMap to connect and login to the Jenkins instance. The job needs to be deleted from OpenShift before it can be run again.
  • jjb.sh is a helper script that can be used to validate/deploy the Jenkins Jobs in the parent directory. It creates the validate or deploy job, waits until the job finishes, shows the log and exits with 0 on success. This script can be used in Jenkins Jobs to automate the validation and deployment of jobs.