Skip to content

Install

Install Rook Ceph

In this part, you create a Rook Ceph Cluster by installing Rook Ceph as a custom add-on through a cluster blueprint.

Step 1: Create Namespace

You will now create a managed namespace from the controller for Rook Ceph.

  • Navigate to Infrastructure -> Namespaces
  • Click on New Namespace
  • Enter the name rook-ceph and select type as Wizard
  • Click Save

Create Namespace

  • Click Save & Go To Placement
  • Select one of your clusters for placement
  • Click Save & Go To Publish
  • Click Publish
  • Click Exit

Step 2: Create the Rook Ceph Operator add-on

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

  • Navigate to Infrastructure -> Add-Ons
  • Click New Add-On -> Create New Add-On from Catalog
  • Search for rook

Create Add-On

  • Click rook-ceph
  • Click Create Add-On
  • Enter the name rook-operator and select the namespace rook-ceph created as part of the previous step
  • Click Create

Create Add-On

  • Enter v1 for the version name
  • Select the helm chart version to be used
  • If needed, provide an override values file for the helm chart
  • Click Save Changes

Step 3: Create the Rook Ceph Cluster add-on

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

  • Navigate to Infrastructure -> Add-Ons
  • Click New Add-On -> Create New Add-On from Catalog
  • Search for rook

Create Add-On

  • Click rook-ceph-cluster
  • Click Create Add-On
  • Enter the name rook-cluster and select the namespace rook-ceph created as part of a previous step
  • Click Create

Create Add-On

  • Enter v1 for the version name
  • Select the helm chart version to be used
  • Save the following to a file named cluster-values.yaml

toolbox:
  enabled: true
- Click Upload Files and select the previously saved YAML file - Click Save Changes

Step 4: Create Blueprint

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

  • Navigate to Infrastructure -> Blueprints
  • Click New Blueprint
  • Provide a name (e.g. rook-ceph), select type as Custom Blueprint
  • Click Save

Create Blueprint

  • Enter v1 for the version name
  • Select minimal for the base blueprint
  • Click Configure Add-Ons
  • Click the + symbol to add the rook-operator and the rook-cluster add-ons to the blueprint
  • Add the rook-operator as a dependency to the rook-cluster add-on
  • Click Save Changes

Create Blueprint

  • Click Save Changes again

Create Blueprint

Step 5: Apply Blueprint

In this step, you will apply the previously created blueprint to the cluster. Applying the blueprint will install the Rook Ceph components.

  • Navigate to Infrastructure -> Clusters
  • Click the gear icon on your cluster
  • Select Update Blueprint
  • Select the blueprint created as part of the previous step (e.g. rook-ceph) and v1 for the version
  • Click Save and Publish

Apply Blueprint

  • Click Exit

Recap

Congratulations! You have successfully created a custom cluster blueprint with Rook Ceph as a custom add-on. You can now use this blueprint on as many clusters as you require to provide distributed storage to your applications.