2020-04-01 11:35:10 +00: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
|
2023-07-04 14:13:57 +00:00
|
|
|
by the CentOS CI team when a [request for CI resources][ci_request] is handled.
|
2020-04-01 11:35:10 +00:00
|
|
|
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.
|
|
|
|
|
|
2023-07-04 14:13:57 +00:00
|
|
|
- The `Dockerfile` uses `pip` to install `jenkins-jobs`, the BuildConfig object
|
2020-04-01 11:35:10 +00:00
|
|
|
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
|
2023-07-04 14:13:57 +00:00
|
|
|
- Together with the `Makefile` (checked out with `checkout-repo.sh`), the
|
2020-04-01 11:35:10 +00:00
|
|
|
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.
|
|
|
|
|
|
|
|
|
|
[ci_request]: https://wiki.centos.org/QaWiki/CI/GettingStarted
|
