Installing CloudBees CI on OpenShift

This guide shows you how to install CloudBees CI on modern cloud platforms on OpenShift. To perform the installation, you should be knowledgeable in OpenShift, Helm, and NGINX Ingress.

CloudBees CI is a fully-featured, cloud native CD solution that can be hosted on-premise or in the public cloud. It provides a shared, centrally managed, self-service experience for all your development teams.

Before you install CloudBees CI on modern cloud platforms on OpenShift, be sure to review the Learn and Plan stages from Onboarding for CloudBees CI on modern cloud platforms.

About using Helm to install CloudBees CI

Using Helm to install CloudBees CI provides the following advantages:

  • It lets you customize the CloudBees CI installation without resorting to error-prone modification of the CloudBees CI YAML files.

  • It provides a history of changes applied to the CloudBees CI release.

  • It provides a simpler and more robust rollback option.

  • It provides a straightforward method of creating custom environment deployments of CloudBees CI.

For example: development, staging, and production CloudBees CI environments.

Things you should know before using Helm

Using the Internet to download the Helm chart and the chart dependencies is the preferred method, but you can install a chart from a local archive that has been downloaded beforehand.

About Helm charts

A Helm chart is a package that defines a Kubernetes application and its dependencies.

The chart is a combination of YAML templates for Kubernetes resources, such as pods, replica sets, deployments or ingresses. It also provides a values file that populates default configuration values for the templates.

Instead of manually editing files, Helm manages the process by merging the templates files and the values into a custom YAML file. It then applies and tracks the deployment of the YAML file on the Kubernetes cluster.

Working with Helm in an airgapped environment

When working in an airgapped environment, the following method can be applied:

  1. Use helm fetch to download a Helm chart from the chart repository.

  2. Copy the Helm chart archive over to the airgapped environment.

  3. Use helm install [NAME] [CHART] [flags] where [CHART] refers to the Helm chart archive to install the Helm chart in the airgapped Kubernetes cluster.