Deploy the similar-users 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 interact with the Rancher2 provider. The process generally involves the following steps:

Set up the provider to interact with your Rancher server.
Create or select the Kubernetes cluster managed by Rancher.
Deploy the Helm chart on that Kubernetes cluster.

The Rancher2 CatalogV2 resource allows you to manage catalogs, and you can deploy Helm charts from these catalogs. However, if the Helm chart similar-users is from an external source or a custom catalog, you must ensure that the Helm chart is available in a catalog that Rancher is configured to use or directly specify the details in your deployment.

Below is a Pulumi program written in TypeScript that demonstrates how to deploy a Helm chart on Rancher. Note that you would need to replace placeholders with actual values for the rancherApiUrl, rancherApiToken, clusterId, namespace, and other specific details of the chart you are deploying:

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

// Configuration for the Rancher provider
const rancherProvider = new rancher2.Provider("rancher", {
    apiUrl: "https://<RANCHER_API_URL>",
    apiToken: "<RANCHER_API_TOKEN>",
});

// Reference to the Rancher cluster where the Helm chart will be deployed
// Replace `<CLUSTER_ID>` with your actual Rancher Cluster ID
const cluster = rancher2.getCluster({
    id: "<CLUSTER_ID>",
}, { provider: rancherProvider });

// Deploying a Helm chart requires the Kubernetes provider to be configured
// with the kubeconfig from the Rancher cluster
const kubeconfig = cluster.kubeConfig;
const k8sProvider = new k8s.Provider("k8s", {
    kubeconfig: kubeconfig,
});

// Deploy the 'similar-users' Helm chart
const helmChart = new k8s.helm.v3.Chart("similar-users-chart", {
    chart: "similar-users",
    // Specify the repository if it's from a custom source, or omit if it's a standard chart
    // repo: "http://<HELM_CHART_REPOSITORY>",
    version: "1.0.0", // Replace with the version of the chart you want to deploy
    namespace: "default", // Replace with the namespace where the chart should be deployed
    // Values to provide to the Helm chart, specific to the 'similar-users' chart
    values: {
        // ... specify your values here
    },
}, { provider: k8sProvider });

// Export the endpoint of the 'similar-users' service if it creates one
export const endpoint = helmChart.getResourceProperty("v1/Service", "<SERVICE_NAME>", "status").apply(status => {
    return status.loadBalancer.ingress[0].hostname || status.loadBalancer.ingress[0].ip;
});

Before running this Pulumi program, ensure the following:

You have access to a Rancher instance and have the API URL and a token with appropriate permissions.
You know the ID of the cluster managed by Rancher where you want to deploy the chart.
The similar-users Helm chart is available either in a configured Rancher catalog or in a Helm repository, and you have the repository URL if needed.
You have specified the chart's version and any required values according to the chart's configuration options.
You have Pulumi CLI and Node.js installed on your machine.

This program defines the necessary resources to deploy your Helm chart:

A rancher2.Provider to communicate with your Rancher instance.
A Kubernetes provider configured with the cluster's kubeconfig for deploying the chart.
A Helm chart resource representing the similar-users chart deployment on the Kubernetes cluster.

Make sure you replace the placeholder values with real ones. After you complete the configuration with your specific details, you can run this program using the Pulumi CLI to deploy your Helm chart.

Remember, this is a base setup, and you may need to adjust parameters and configurations based on the details of the similar-users chart and your Rancher environment.