The following items are required to install CloudBees CI on modern cloud platforms on OpenShift:
An OpenShift cluster with the following specifications is required:
A currently supported version of OpenShift. See Supported platforms for CloudBees CI on modern cloud platforms
Network access to container images (public Docker Hub or a private Docker Registry).
A project with permissions to create
Access to the DNS record that points to your installation and TLS certificates for the CloudBees CI on modern cloud platforms deployment.
Additionally, there are some security considerations when running Jenkins agents on OpenShift:
Containers must run as a non-root user and group.
Containers must not be privileged.
Before you begin the CloudBees CI on modern cloud platforms installation, you should complete the following steps.
Create an OpenShift project, then set it as the current OpenShift project:
$ oc new-project cjoc $ oc project cjoc
Set up an administrative workstation. The workstation may be either the CloudBees CI administrative workstation or a Kubernetes administrative workstation. It must be a workstation on which you have full command privileges for the following utilities:
The OpenShift CLI, installed and configured to work with your OpenShift cluster.
The Helm client.
If you intend to use the Helm
templateoption, after installing the Helm client, you can skip to Using Helm
templatecommand to install CloudBees CI.
Add the CloudBees Helm Chart Repository.
helm repo add cloudbees https://charts.cloudbees.com/public/cloudbees (1) helm repo update (2)
helm repo addadds a new Helm Chart Repository to your Helm installation.
helm repo updateupdates your local Helm Chart Repository cache. Your local Helm Chart Repository cache is used by Helm commands like
helm searchto improve performance.
helm repo updatebefore you execute a Helm search using
helm search. This ensures your cache is up to date.