Deploy the variant-handler helm chart on Rancher

Question

Pulumi · Accepted Answer

Deploying a Helm chart on Rancher using Pulumi involves several steps. First, you'll need to set up the Rancher provider and then use it to deploy the Helm chart using the appropriate resources. Below, I'll guide you through creating a Pulumi program in TypeScript to deploy the variant-handler Helm chart on Rancher.

Set Up Your Pulumi Project

Before writing the Pulumi code, make sure you have a Pulumi project set up. If you haven't yet created one, you can initiate a new project by running pulumi new typescript in your terminal and following the prompts.

Install Rancher2 Provider

Ensure that you have the Rancher2 provider configured in your Pulumi project. You can add it to your package.json dependencies or install it via npm:

npm install @pulumi/rancher2

Pulumi Code Explanation

The program consists of the following main steps:

Import the necessary Pulumi libraries and the Rancher2 provider.
Set up the Rancher provider using the credentials for your Rancher server instance.
Deploy the variant-handler Helm chart using the rancher2.HelmChart resource.

Here's the TypeScript code that accomplishes these steps:

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

// Initialize the Rancher provider with the credentials.
// Replace placeholder values with actual values from your Rancher server deployment.
const rancherProvider = new rancher2.Provider("rancher", {
    apiUrl: "https://your-rancher-server.com/v3",
    accessKey: "your-access-key",
    secretKey: "your-secret-key",
});

// Deploy the 'variant-handler' Helm chart on a specific Rancher project and cluster.
// Make sure to replace `projectId` with your actual project ID from Rancher.
const helmChart = new rancher2.HelmChart("variant-handler-chart", {
    projectId: "c-xxxxx:p-yyyyy",  // Project format usually is `c-<ClusterID>:p-<ProjectID>`
    repoUrl: "http://charts.your-repository.com", // URL to your Helm chart repository
    chart: "variant-handler", // The name of the Helm chart to deploy
    version: "1.0.0", // Replace with the version of 'variant-handler' chart you intend to deploy
    values: { // Pass configuration values for your chart here. Shown below are example values.
        key1: "value1",
        key2: "value2",
    },
}, { provider: rancherProvider });

// Export the app URL in case you need it as an output
export const appUrl = pulumi.interpolate`http://app-url-from-helm-chart`;

In the code above:

We create a new instance of the Rancher provider, which requires the URL of your Rancher server and your access and secret keys. Replace the placeholder values with your actual credentials.
We then create a new Helm chart resource, specifying the project and cluster where to deploy, the chart repository URL, the name of the chart variant-handler, its version, and any necessary configuration values in the values object. Replace these with actual values relevant to your setup.
Finally, we have an exported value appUrl which would typically be the URL to access the newly deployed application. This would depend on the details of the Helm chart being deployed.

Note: The values for repoUrl, chart, version, and values need to be specific to the Helm chart you're deploying. Adjust these according to the variant-handler chart you have.

Security Considerations

Be careful with sensitive data like API keys; they should not be hard-coded. In a production environment, consider using Pulumi's secret management to store sensitive information.

Conclusion

This Pulumi code provides the setup to deploy a Helm chart to your Rancher-managed Kubernetes cluster. Ensure that you replace the placeholders with actual data from your environment. Once the code is ready, you can deploy it by running pulumi up in your terminal.