Deploy the ceph helm chart on Rancher

Question

Pulumi · Accepted Answer

To deploy the Ceph Helm chart on a Kubernetes cluster managed by Rancher, you'll be following a set of steps which I'll outline before providing the Pulumi TypeScript program to perform the deployment.

Firstly, you need to ensure that you have a Kubernetes cluster registered within Rancher, along with access to the Rancher Kubernetes Engine (RKE). We'll then add a Helm chart repository that includes Ceph to Rancher, and finally, we will deploy the Ceph Helm chart to the Kubernetes cluster.

In this Pulumi program, we are going to use the rancher2 provider to interact with the Rancher API. This provider allows us to create and manage resources within a Rancher environment.

Here's a step-by-step Pulumi program written in TypeScript for deploying the Ceph Helm chart:

1. Setting up Pulumi project and stack.
You might already have done this by running pulumi new and selecting the appropriate template.

2. Configuring Rancher provider.
Ensure that you have configured credentials (RANCHER_ACCESS_KEY, RANCHER_SECRET_KEY, and RANCHER_SERVER_URL) for the Rancher provider so that Pulumi can authenticate with your Rancher server.

3. Adding the Helm Chart repository to Rancher.
We will add a Catalog to Rancher which points to the chart repository where the Ceph chart is hosted.

4. Deploying Ceph Helm Chart into the Rancher-managed Kubernetes cluster.
We will create a Helm chart resource that references the Ceph chart within the added repository.

Note: The following program assumes you have a Kubernetes cluster already set up and managed by Rancher and that the rancher2 provider is correctly configured in your Pulumi environment. Replace placeholders (<PLACEHOLDER>) with the appropriate values.

Here's the TypeScript program:

import * as rancher2 from "@pulumi/rancher2";

// Step 1: Add the chart repository to Rancher
const cephChartRepo = new rancher2.CatalogV2("cephChartRepo", {
    clusterId: "<CLUSTER_ID>",                  // Replace with your cluster ID
    name: "ceph",                               // Name for the catalog resource
    url: "https://ceph.github.io/charts/",      // URL for the Ceph Helm chart repository
    gitBranch: "main",                          // Branch of the repository
    // Set additional properties if necessary
});

// Step 2: Deploy the Ceph Helm Chart into the Kubernetes cluster
// Please note that you need to specify the clusterId where you want to install the chart
const cephHelmChart = new rancher2.HelmChartV2("cephHelmChart", {
    clusterId: "<CLUSTER_ID>",                  // Replace with your cluster ID
    name: "ceph",
    chartName: "ceph",                          // The name of the chart in the repository
    repository: cephChartRepo.name,
    version: "<CHART_VERSION>",                 // Specify the chart version
    namespace: "ceph",                          // Specify the namespace to install the chart
    // Add any values for configurable options in the Ceph Helm chart
    values: {
        // Configure your Ceph deployment according to your requirements
        // For example:
        // mon: {
        //     count: 3,
        // },
        // ...
    },
    // Set additional properties if necessary
});

// Export the endpoint to access Ceph if desired
export const cephEndpoint = "<CEPH_ENDPOINT>";  // Replace with the actual endpoint if needed

Replace <CLUSTER_ID>, <CHART_VERSION>, and <CEPH_ENDPOINT> with the appropriate values for your setup. The values object should be filled with the necessary configurations for the Ceph Helm chart based on your environment and requirements.

The clusterId should be the ID of your Rancher-managed Kubernetes cluster where you want to deploy Ceph, and <CHART_VERSION> should be replaced with the version of the Ceph chart you wish to deploy.

After setting up this program:

Run pulumi up to execute the deployment.
Pulumi will communicate with Rancher to add the Ceph Helm chart repository and then deploy Ceph onto your Kubernetes cluster.

Remember to review the Helm chart documentation of Ceph for all available configuration options. The values parameter in rancher2.HelmChartV2 resource can be used to set these configurations which will be passed on to the Helm chart at the time of deployment.