Skip to content

Part 4: Cluster Blueprints

What Will You Do

In this section you will

  • Create an add-on
  • Create a custom cluster blueprint with the addon
  • Apply the blueprint to your cluster

Step 1: Create Add-on

In this step, you will create a custom cluster add-on from the Catalog. The add-on will then be used in a custom cluster blueprint.

  • In your project, navigate to Catalog in the left side tree
  • Search for "cert-manager"
  • Click on cert-manager from "default-helm"

Create Add-On

  • Click Create Add-On
  • Enter cert-manager for the name of the add-on
  • Select the previously created namespace
  • Click Create

Create Add-On

  • Enter v1 for the version name
  • Save the following to a file named values.yaml
installCRDs: true
  • Click Upload Files
  • Select the values.yaml file
  • Click Save Changes

Create Add-On

Step 2: Create Blueprint

In this step, you will create a custom cluster blueprint which contains the previously created addon.

  • In your project, navigate to Infrastructure -> Blueprints
  • Click New Blueprint
  • Enter openshift-custom-bp for the name of the blueprint
  • Click Save

Create Blueprint

  • Enter v1 for the version name
  • Select default-openshift for the base blueprint

Create Blueprint

  • Click Configure Add-Ons in the Add-ons section
  • Click the + symbol to add the cert-manager add-on to the blueprint
  • Click Save Changes

Create Blueprint

  • Click Save Changes

Create Blueprint

Step 3: Apply Blueprint

In this step, you will apply the previously created blueprint to the cluster. Applying the blueprint will install the cert-manager add-on.

  • In your project, navigate to Infrastructure -> Clusters in the left side tree
  • Click the gear icon on your cluster
  • Select Update Blueprint
  • Select openshift-custom-bp for the blueprint and v1 for the version
  • Click Save and Publish

Apply Blueprint

This will force the reconciliation of the custom cluster spec with your cluster. This can take a few minutes to complete especially if images have to be downloaded for the new add-ons.

Apply Blueprint

Afer a short period of time, the blueprint will be applied to the cluster.

Apply Blueprint

  • Click Exit

Step 4: Verify

Optionally, you can verify that the pods for cert-manager are active and operational on your cluster using kubectl.

  • Enter the following command
kubectl get pods -n cert-manager

You should see something like the following

NAME                                       READY   STATUS    RESTARTS   AGE
cert-manager-96649f687-56xkg               1/1     Running   0          49m
cert-manager-cainjector-7d68995cff-njqrx   1/1     Running   0          49m
cert-manager-webhook-84bbbbf7d9-6kh2v      1/1     Running   0          49m

Recap

Congratulations! At this point, you have successfully created a custom cluster blueprint and published it to your cluster.