Deploy the stream helm chart on Rancher

Question

Pulumi · Accepted Answer

Deploying a Helm chart on Rancher using Pulumi involves several steps, including setting up the Rancher provider, configuring the Kubernetes cluster, and then deploying the Helm chart to that cluster. Below is a TypeScript program that demonstrates how to deploy a Helm chart named "stream" to a Kubernetes cluster managed by Rancher.

First, make sure you have installed Pulumi and set up your Pulumi project. If you haven't done so, please refer to the Pulumi [Getting Started](https://www.pulumi.com/docs/get-started/) guide for instructions.

Now, let's start by installing the necessary Pulumi packages for Rancher and Helm:

```shell
$ pulumi plugin install resource rancher2 v5.1.1
$ npm install @pulumi/rancher2 @pulumi/kubernetes
```

Next, we'll write a TypeScript program that performs the following actions:

1. **Establishes a Provider for Rancher**: This allows Pulumi to communicate with your Rancher instance.
2. **Fetches a Rancher Cluster**: We need to retrieve the cluster from Rancher where we want to deploy the Helm chart.
3. **Sets up a Kubernetes Provider**: This is used to deploy resources to the Kubernetes cluster managed by Rancher.
4. **Deploys a Helm chart using the Helm Release resource**: The Helm chart for "stream" will be deployed to the Kubernetes cluster.

Here's a Pulumi program that demonstrates this:

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

const rancherConfig = new rancher2.Provider("rancherConfig", {
    // The API URL of your Rancher instance
    apiUrl: "https://your-rancher-instance/v3",
    // Access key and secret for the Rancher API
    accessKey: "YOUR_RANCHER_ACCESS_KEY",
    secretKey: "YOUR_RANCHER_SECRET_KEY",
});

// Fetch the cluster from Rancher that you want to deploy to
const cluster = rancher2.getCluster({
    name: "your-cluster-name",
}, { provider: rancherConfig });

// Set up a Kubernetes provider configured for the cluster from Rancher
const k8sProvider = new k8s.Provider("kubernetes", {
    kubeconfig: cluster.kubeConfig,
});

// Define a Helm chart release for the "stream" Helm chart
const streamChart = new k8s.helm.v3.Chart("stream-chart", {
    chart: "stream", // The name of the chart. Modify if your chart name is different.
    // The repository where the Helm chart is located. You will have to specify the repo URL that hosts the 'stream' Helm chart.
    repo: "your-helm-chart-repo",
    // The version of the Helm chart. You can omit this if you always want to use the latest version.
    version: "1.0.0",
    namespace: "default", // The namespace to deploy the chart into. Change this to the desired namespace.
}, { provider: k8sProvider });

// Optional: Export the endpoint of the stream application if available
export const streamEndpoint = streamChart.getResourceProperty("v1/Service", "default/stream-service", "status").apply(status => status.loadBalancer.ingress[0].ip);
```

In the above code, make sure to replace `https://your-rancher-instance/v3`, `YOUR_RANCHER_ACCESS_KEY`, `YOUR_RANCHER_SECRET_KEY`, `your-cluster-name`, and `your-helm-chart-repo` with the appropriate values for your Rancher setup and the Helm chart you want to deploy.

The `stream-chart` variable refers to the Helm chart you want to deploy, with its configuration details such as the chart name, repository, version, and namespace.

Finally, we optionally export an endpoint which you can use to access your "stream" application if it exposes an external service via LoadBalancer. If your application does not create a service of type LoadBalancer or if you're deploying into a namespace other than `default`, you'll need to adjust the `getResourceProperty` parameters accordingly.

Remember to replace placeholders for the repository URL and other sensitive data with actual values before running the Pulumi program. To execute the program, run the following command:

```shell
$ pulumi up
```

This command will preview the deployment and prompt you for confirmation before making any changes to your infrastructure.

Keep in mind that deploying Helm charts via this method requires that the Kubernetes cluster is already up and running, and that you have the necessary access credentials. Additionally, you should ensure the Helm repository you specify is correct and accessible from your Kubernetes cluster.