Deploy the redis-setup helm chart on Rancher

Question

Pulumi · Accepted Answer

To deploy a Helm chart on a Rancher-managed Kubernetes cluster using Pulumi, you would need to have the Rancher2 Pulumi provider set up. The Rancher2 provider allows you to interact with resources within a Rancher environment, such as managing Kubernetes clusters, deploying workloads, and installing applications via Helm charts.

Below is a TypeScript program that demonstrates how to deploy a Redis Helm chart on a Rancher-managed Kubernetes cluster using Pulumi. The program uses the `CatalogV2`, `Namespace`, and `AppV2` resources to install a Helm chart into a Rancher cluster.

Let me walk you through the process:

1. **Setup Pulumi**: You'll need to have Pulumi installed and configured to work with your chosen cloud provider. This program assumes that you have already configured Pulumi to work with the Rancher2 provider.

2. **Installation of Catalog**: Before you can deploy a Helm chart, you typically need to add a Helm chart repository to the cluster's catalog. In this case, we use the `CatalogV2` resource to install a catalog that contains the Redis chart. You'll need to provide the URL to the Helm chart repository that you intend to use.

3. **Creation of Namespace**: Workloads in Kubernetes are typically deployed within a namespace, which is a way of isolating them within the cluster. We use the `Namespace` resource to ensure that the namespace we want to deploy Redis into exists.

4. **Deployment of Chart**: Lastly, we deploy the Redis chart using the `AppV2` resource, which allows us to specify the chart name, version, and values corresponding to the Helm chart we wish to install.

Here's what the Pulumi TypeScript program looks like:

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

// Initialize a Pulumi program with the Rancher2 provider.
const config = new pulumi.Config();
const rancherClusterId = config.require("rancherClusterId"); // The Rancher Cluster ID where you want to deploy Redis.

// Create a Catalog to include the repository that has your Redis Helm chart.
const catalog = new rancher2.CatalogV2("redisCatalog", {
    clusterId: rancherClusterId,
    url: "https://charts.bitnami.com/bitnami", // The Helm chart repository URL. Replace if necessary.
    gitBranch: "master", // The default branch to clone the chart from, ensure this matches the chart repo's branch.
    annotations: {
        "field.cattle.io/description": "A catalog for Redis Helm charts", // A description field for the catalog.
    },
});

// Create a Namespace for Redis if it does not already exist.
const redisNamespace = new rancher2.Namespace("redisNamespace", {
    clusterId: rancherClusterId,
    name: "redis-setup", // Adjust the namespace name as per your needs.
    annotations: {
        "field.cattle.io/description": "A namespace for running Redis", // A description for the namespace.
    },
});

// Deploy the Redis Helm chart within the created namespace.
const redisApp = new rancher2.AppV2("redisApp", {
    clusterId: rancherClusterId,
    namespace: redisNamespace.name,
    repoName: catalog.name,
    chartName: "redis", // The name of the chart within the catalog.
    chartVersion: "14.6.1", // Specify the version of the chart you wish to deploy.
    values: pulumi.output({}), // Use a config map or a string containing the values.yaml content.
    // If needed, populate `values` with configurations that are specific to your Redis deployment.
});

// Export the Redis App ID for reference
export const redisAppId = redisApp.id;
```

In this program, the required resources are set up to deploy the Redis Helm chart to the desired namespace in the Rancher-managed Kubernetes cluster. You need to customize the `rancherClusterId` and the `chartVersion` based on the available chart versions in the repository you're using. Also, if you have specific configurations for the Redis Helm chart, you may provide them via the `values` field in the `redisApp` resource.

Make sure to replace the placeholders and configuration values with the appropriate information for your setup. After tailoring the code to your requirements, you can run it by executing `pulumi up` using the Pulumi CLI. This will initiate the deployment process, and you can follow the progress in the console output.