Deploy the redis-cache helm chart on Rancher

Question

Pulumi · Accepted Answer

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

Set up Rancher with Kubernetes.
Install the Pulumi Rancher2 provider.
Use Pulumi to deploy the Helm chart.

Below is a detailed Pulumi TypeScript program that demonstrates how to deploy the redis-cache Helm chart onto a Rancher-managed Kubernetes cluster. I'll guide you through the resources being used in the program and provide explanations for the different steps involved.

First, ensure you have the Pulumi CLI installed and configured for your environment. The code assumes you've already set up a Kubernetes cluster managed by Rancher and have access to it.

You need to add the Pulumi Rancher2 provider to your project, which enables you to work with Rancher resources. You add the provider by running the following command in your terminal:

pulumi plugin install resource rancher2 <VERSION>

Replace <VERSION> with the version of the provider you wish to use. Please visit the Pulumi Rancher2 provider page to find the latest version and more detailed instructions if needed.

Now let's move on to the Pulumi program:

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

// Initialize a Rancher provider instance
const rancherProvider = new rancher2.Provider("rancherProvider", {
    apiUrl: "https://rancher.my-company.com/v3",
    accessKey: "my-access-key",
    secretKey: "my-secret-key",
    // Cluster ID where you want to deploy the Helm chart
    clusterId: "cluster-id",
});

// Creating a Catalog V2 resource that points to the Helm repo containing redis-cache chart
const catalog = new rancher2.CatalogV2("redis-catalog", {
    name: "redis",
    clusterId: "cluster-id",
    url: "https://charts.bitnami.com/bitnami",
}, { provider: rancherProvider });

// Define the Helm chart resource from the Rancher catalog
const redisHelmChart = new k8s.helm.v3.Chart("redis-cache", {
    repo: "redis",
    chart: "redis",
    version: "14.8.8", // specify the exact chart version you need
    namespace: "default",
}, { provider: rancherProvider });

// Export the Redis master service endpoint
export const redisMasterServiceEndpoint = redisHelmChart.getResourceProperty(
    "v1/Service",
    "redis-cache-redis-master",
    "status",
    "loadBalancer",
    "ingress",
);

Here's what each part is doing:

We first import the necessary Pulumi libraries for Rancher and Kubernetes.
We then set up a Rancher Provider; this will provide the necessary context to access your Rancher-managed Kubernetes cluster. Replace "https://rancher.my-company.com/v3", "my-access-key", "my-secret-key", and "cluster-id" with your actual Rancher API URL, access key, secret key, and the ID of the Kubernetes cluster within Rancher where you want to deploy the Helm chart.
Next, we create a new CatalogV2 resource. It points to the Helm chart repository containing the redis-cache chart. Replace the URL with the location of your specific Helm chart if it's different from the Bitnami repository.
After that, we define a Chart resource which represents the redis-cache Helm chart we want to install. You will need to specify the exact version of the chart you need. We use the namespace where the chart should be deployed within the cluster; this is often the default namespace but may differ depending on your setup.
Finally, we export an output redisMasterServiceEndpoint that will contain the Redis master service endpoint once the deployment is complete. This will allow you to connect to your Redis instance after deployment.

Make sure to configure your Pulumi program with the correct credentials and cluster details before executing it. After reviewing and updating the placeholders in the code, run pulumi up to preview and deploy your infrastructure.

Please do not forget to replace sensitive information such as access tokens and secret keys with your actual credentials. It's a best practice to manage sensitive information with Pulumi's secrets management features.