Deploy the business-service helm chart on Rancher

Question

Pulumi · Accepted Answer

Deploying a Helm chart on Rancher using Pulumi involves a few distinct steps. We will set up the Rancher provider, configure the Kubernetes cluster where the Helm chart will be deployed, and finally deploy the Helm chart itself. In this guide, we will write a Pulumi program in TypeScript that accomplishes this.

To begin, we'll need to install the necessary Pulumi packages. The @pulumi/rancher2 package is used to interact with Rancher, and @pulumi/kubernetes to handle the Kubernetes resources, specifically to deploy the Helm chart.

Here's a breakdown of what we'll do in the Pulumi program:

First, we'll configure the Rancher provider, which requires access to a Rancher server.
Then, we'll specify the Kubernetes cluster managed by Rancher where we want our Helm chart to be deployed.
Finally, we'll use the Pulumi Kubernetes provider to deploy the 'business-service' Helm chart to this cluster.

Here is a TypeScript program that achieves these tasks:

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

// Set up Rancher provider using the Rancher API endpoint and a token.
const rancherProvider = new rancher2.Provider("rancher", {
    apiURL: "https://<RANCHER_API_ENDPOINT>", // Replace with your Rancher API endpoint
    tokenKey: "<RANCHER_TOKEN_KEY>", // Replace with your Rancher token key
});

// Specify the cluster in Rancher where the Helm chart will be deployed.
// Assume here that a cluster named "my-cluster" is already provisioned in Rancher.
const cluster = new rancher2.Cluster("my-cluster", {/*...any additional configuration...*/}, { provider: rancherProvider });

// Once the cluster is ready, we'll obtain the kubeconfig for that cluster.
const kubeconfig = cluster.kubeConfig;

// Create a new Kubernetes provider using the kubeconfig from the Rancher-managed cluster.
const k8sProvider = new k8s.Provider("k8s-provider", {
    kubeconfig: kubeconfig,
});

// Deploy the 'business-service' Helm chart using the Kubernetes provider.
const businessServiceChart = new k8s.helm.v3.Chart("business-service-chart", {
    chart: "<chart-name>",  // Replace `<chart-name>` with the name of the chart
    version: "<chart-version>",  // Specify the chart version if needed
    fetchOpts: {
        repo: "<helm-chart-repository-url>", // Provide the URL of the Helm chart repository
    },
    // Include any values you wish to override in the Helm chart under `values`.
    values: {
        // ...your overridden values go here...
    },
}, { provider: k8sProvider });

// (Optional) Export the URL to access the deployed service, assuming it creates a LoadBalancer service.
export const serviceUrl = businessServiceChart.getResourceProperty("v1/Service", "business-service", "status")
    .apply(status => `http://${status.loadBalancer.ingress[0].ip}`);

Remember to replace placeholders with actual values:

<RANCHER_API_ENDPOINT>: The endpoint for your Rancher API.
<RANCHER_TOKEN_KEY>: Your Rancher access token or API key.
<chart-name>: The name of the Helm chart you want to deploy.
<chart-version>: The version of the Helm chart.
<helm-chart-repository-url>: The URL of the Helm chart repository.

Before running this Pulumi program, ensure:

You have access to the Rancher environment with a valid API endpoint and token key.
The Helm chart you wish to deploy is available in a public or private Helm chart repository.
You've installed the Pulumi CLI and set up the Rancher and Kubernetes providers.

The last step in the program is optional; it's for exporting the URL to access the service defined in the Helm chart, assuming it is of type LoadBalancer. You might need to adjust the exporting part based on how your service is configured.

With this Pulumi setup, you would run the usual commands pulumi up to preview and perform the deployment. After confirming the plan, the resources will be provisioned accordingly.