README.md

# CloudBees CI setup

## Approved with Conditions
Must run behind CNAP or VPN (no internet facing).

CloudBees CI (formerly known as _CloudBees Core_) consists of three Docker images installed via Helm chart:

* `core-oc`: the Operations Center
* `core-mm`: a managed Jenkins controller
* `agent`: a Jenkins build agent

For each image, all files other than UBI and native packages
are included in a `files.tar` marked with a SHA-256 checksum.

A version of CloudBees CI is given in the format `2.303.1.6-ra`
where the first three components are aligned with a Jenkins LTS.
The Helm chart is coversioned with `core-oc`.
The `core-mm` image typically shares the same version,
though a given controller may be deliberately kept at a somewhat older release.
The `agent` image is preferably coversioned with the controller.

After creating images, create a values file that specifies locally uploaded images
plus whatever other customizations are desired:

```yaml
OperationsCenter:
  Image:
    dockerImage: your-registry/core-oc:2.303.1.6-ra
Master:
  Image:
    dockerImage: your-registry/core-mm:2.303.1.6-ra
Agents:
  Image:
    dockerImage: your-registry/agent:2.303.1.6-ra
```

and [install via Helm 3](https://docs.cloudbees.com/docs/cloudbees-core/latest/kubernetes-install-guide/installing-kubernetes-using-helm) using the local copy of the chart:

```bash
helm install cloudbees-core core-oc/helm -f dcar-values.yaml
```