Deploy the prom2teams helm chart on Rancher

Question

Pulumi · Accepted Answer

Deploying a Helm chart on Rancher typically involves first setting up a Kubernetes cluster managed by Rancher, then utilizing Helm to deploy your desired application—in this case, the "prom2teams" Helm chart.

Below is a TypeScript program using Pulumi to deploy the `prom2teams` Helm chart on a Kubernetes cluster managed by Rancher. The following steps are taken in the program:

1. Set up a new Kubernetes cluster within Rancher using the `rancher2.Cluster` resource.
2. Add a catalog containing the Helm chart repository to Rancher using the `rancher2.CatalogV2` resource.
3. Deploy the `prom2teams` Helm chart within the cluster using the `helm.v3.Chart` resource.

To run this program:

- Ensure that you have Rancher 2.x installed and its management API is accessible.
- Confirm that you have Pulumi configured to access your Rancher instance.

Here is the detailed Pulumi TypeScript program to achieve this deployment:

```typescript
import * as rancher2 from "@pulumi/rancher2";
import * as helm from "@pulumi/kubernetes/helm";
import * as pulumi from "@pulumi/pulumi";
import * as k8s from "@pulumi/kubernetes";
import * as random from "@pulumi/random";

// A prefix for resources to avoid name collisions.
const namePrefix = new random.RandomPet("namePrefix").id;

// Create a new Rancher v2 Cluster
const cluster = new rancher2.Cluster("prom2teams-cluster", {
    rkeConfig: {
        // Cluster configuration details like network plugin, Kubernetes version, etc.
        // This is a minimal example configuration. 
        // Ensure you use the configuration that suits your deployment requirements.
        network: {
            plugin: "canal",
        },
        services: {
            etcd: {
                // Specify configuration details for etcd.
            },
            kubeApi: {
                // API server configuration
                serviceNodePortRange: "30000-32767",
            },
        },
    },
});

// Create a new Rancher Catalog V2
const catalog = new rancher2.CatalogV2("prom2teams-catalog", {
    clusterId: cluster.id,
    url: "https://helm.artifacthub.io/charts/prom2teams", // The Helm repository URL where prom2teams chart is located.
    gitRepo: "", // In case the chart is in a Git repo, provide the repository URL here.
    // Other relevant settings like branch, insecure skip TLS verify, etc.
});

// Use an existing K8s provider connected to the new cluster's endpoint
const k8sProvider = new k8s.Provider("k8sProvider", {
    kubeconfig: cluster.kubeConfig, // Using the kubeconfig from the created cluster `cluster`.
});

// Deploy prom2teams Helm chart
const prom2teamsChart = new helm.v3.Chart("prom2teams", {
    chart: "prom2teams",
    version: "v3.0.0", // Specify the version of the chart to use.
    fetchOpts: {
        repo: "https://helm.artifacthub.io/charts/prom2teams", // The Helm repository where prom2teams chart is hosted.
    },
}, { provider: k8sProvider }); // Ensure to use the k8s provider pointing to our new cluster.
```

In this program:

- We begin by defining a `RandomPet` resource to generate a unique name prefix for our resources to avoid naming collisions.
- Next, we create a `Cluster` using the `@pulumi/rancher2` package which is a representation of a Rancher-managed Kubernetes cluster. Remember to replace the `rkeConfig` value with the actual configuration appropriate for your setup.
- We set up a `CatalogV2` within Rancher that points to the Helm chart repository hosting `prom2teams`.
- We then create a `Provider` from the `@pulumi/kubernetes` package that knows how to communicate with our newly created Kubernetes cluster (It uses the `kubeConfig` from the Rancher cluster).
- Finally, we deploy the `prom2teams` Helm chart on our cluster by creating a `Chart` from the `@pulumi/kubernetes/helm` package and specify the version and repository we want to use.

Please ensure that any sensitive information (like the Rancher access credentials) is treated securely, for instance by using Pulumi Config to retrieve secrets. Make sure that the configurations, such as cluster and Helm chart versions, match what is available and supported in your environment.

Be aware that the code above will create a new Kubernetes cluster in Rancher, which can incur costs. Adjust the cluster configuration to suit your requirements and environment. If you already have a cluster and want the Helm chart to be deployed on an existing cluster, you should modify the `k8s.Provider` to point to your current cluster's kubeconfig.

Remember, before executing this Pulumi program, you must ensure that your Pulumi environment has the correct permissions set up to access Rancher.