Deploy the juicefs helm chart on Rancher

Question

Pulumi · Accepted Answer

To deploy the JuiceFS Helm chart on a Rancher-managed Kubernetes cluster using Pulumi, you'll need to perform several steps:

Set up the Rancher2 Pulumi provider.
Authenticate to the Rancher instance where your Kubernetes cluster is managed.
Use the appropriate resource to manage Helm charts within Rancher.
Deploy the JuiceFS Helm chart to your Kubernetes cluster.

Below is a detailed Pulumi program written in TypeScript that demonstrates these steps. Let's go through the program and understand each part.

First, we'll import the necessary Pulumi and Rancher2 packages. Then, we will use rancher2.Cluster to select the Kubernetes cluster managed by Rancher where we want to deploy JuiceFS. Afterward, we'll deploy the JuiceFS Helm chart using the rancher2.AppV2 resource. This resource allows us to specify the chart repository and other configurations needed for JuiceFS.

Before you begin, ensure you have Pulumi installed and configured with the required cloud provider credentials. Additionally, ensure you are logged in to the command line for the Rancher Kubernetes cluster you intend to use.

Here is the complete program:

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

// Pre-requisites:
// - Pulumi CLI installed and configured
// - Access to a Rancher managed Kubernetes cluster
// - Appropriate cloud provider credentials configured

// Initialize a Rancher2 provider instance
const rancherProvider = new rancher2.Provider("rancher-provider", {
    apiURL: "https://<RANCHER_API_URL>", // replace with your Rancher API URL
    accessToken: "<RANCHER_ACCESS_TOKEN>", // replace with your Rancher access token
    secretKey: "<RANCHER_SECRET_KEY>", // replace with your Rancher secret key
});

// Select the existing Rancher-managed Kubernetes Cluster
const cluster = rancher2.getCluster({
    name: "<CLUSTER_NAME>", // replace with your cluster name
}, { provider: rancherProvider });

// Deploy JuiceFS Helm chart
const juicefsChart = new k8s.helm.v3.Chart("juicefs", {
    chart: "juicefs-csi-driver",
    version: "0.10.6", // specify the chart version you want to deploy
    namespace: "default", // specify the namespace where you want the chart to be deployed
    fetchOpts: {
        repo: "https://juicedata.github.io/juicefs-csi-driver/",
    },
    // Specify any values that are needed for your JuiceFS Helm chart
    // You can find this information in the documentation of the Helm chart you are using.
    values: {
        // Provide JuiceFS specific configurations here
        // Example:
        // juicefs: {
        //     fsName: "<FS_NAME>", // replace with your JuiceFS filesystem name
        //     secretName: "<SECRET_NAME>", // replace with the name of your JuiceFS secret
        //     token: "<TOKEN>", // replace with your JuiceFS token
        // },
    },
}, { provider: cluster }); // Ensure that the helm chart uses the selected cluster

// Export the JuiceFS application URL
export const juicefsUrl = pulumi.interpolate`https://juicefs.${cluster.fqdn}`;

Replace placeholders like <RANCHER_API_URL>, <RANCHER_ACCESS_TOKEN>, <RANCHER_SECRET_KEY>, and <CLUSTER_NAME> with your actual Rancher API URL, access token, secret key, and cluster name respectively.

This program sets up a Helm chart deployment for JuiceFS on a Kubernetes cluster managed by Rancher. After deploying the program with Pulumi, the JuiceFS file system will be available within your Kubernetes cluster.

To run this Pulumi program:

Save the code into a file named index.ts.
Run pulumi up in the same directory as your index.ts file, which will initiate the deployment.
Review the proposed changes and approve them to start the deployment.

After the deployment finishes, you can check the exported juicefsUrl to interact with your JuiceFS deployment.