Deploy the trainingjobs helm chart on Rancher

Question

Pulumi · Accepted Answer

Deploying a Helm chart on a Rancher-managed Kubernetes cluster using Pulumi involves several steps. You will need to ensure that you have a Rancher Kubernetes cluster up and running, and then you can manage the deployment of Helm charts through Pulumi.

The following program in TypeScript demonstrates how you can use Pulumi to deploy a Helm chart called `trainingjobs` on a Rancher cluster. Please note that before executing the code, you must have Pulumi installed, have access to a Rancher environment, and have the necessary credentials configured in your Pulumi stack.

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

// Assume that the Rancher cluster is already created and configured.
// We will deploy a Helm chart on that cluster.

// Create a Rancher2 provider instance using the credentials from the configured Rancher environment.
const rancherProvider = new rancher2.Provider("rancherProvider", {
    // Provide appropriate access credentials for Rancher
    apiToken: "REPLACE_WITH_YOUR_RANCHER_API_TOKEN",
    apiUrl: "REPLACE_WITH_YOUR_RANCHER_API_URL",
});

// Retrieve the existing Rancher cluster where you want to deploy the Helm chart.
const cluster = rancher2.getCluster({
    name: "my-rancher-cluster", // Replace with the name of your Rancher cluster
}, {provider: rancherProvider});

// Once you have the cluster information, set up a Kubernetes Provider pointing at the Rancher Kubernetes cluster.
const k8sProvider = new k8s.Provider("myRancherK8sProvider", {
    kubeconfig: cluster.kubeConfig,
});

// Now, let's define the Helm Release for the `trainingjobs` chart.
const trainingJobsRelease = new k8s.helm.v3.Release("trainingjobs", {
    chart: "trainingjobs",
    version: "1.0.0", // Replace with the correct chart version
    // If necessary, specify the repository opts
    // repositoryOpts: {
    //     repo: "http://myhelmrepo.com/",
    // },
    // Value overrides for the Helm chart
    // values: {
    //     key: value
    // },
}, {provider: k8sProvider});

// Export the public IP to access the `trainingjobs` service (if it creates an external IP)
export const trainingJobsServiceIp = trainingJobsRelease.status.apply(status => {
    return status.resources.filter(r =>
        r.kind === "Service" && r.apiVersion === "v1"
    )[0].status.loadBalancer.ingress[0].ip;
});
```

Replace the placeholder values for `apiToken`, `apiUrl`, and any other specific configurations you require for your Rancher environment and Helm chart.

Once you've replaced the necessary placeholders, here's what the code does:

1. **Provider Setup**: The `rancher2.Provider` is configured using the API token and API URL of your Rancher server. This provider is used to interact with the Rancher API.

2. **Get Cluster Information**: We retrieve the existing Rancher cluster configuration using `rancher2.getCluster`.

3. **Kubernetes Provider**: A Pulumi Kubernetes provider instance is created, using the kubeconfig from the Rancher cluster which allows Pulumi to interact with the Kubernetes cluster managed by Rancher.

4. **Helm Chart Deployment**: The `k8s.helm.v3.Release` resource defines the Helm chart to be deployed. Here, you specify the chart name, version, any custom values that you want to override, and the Kubernetes provider.

5. **Export Output**: This is an optional step, where we're exporting the IP address of the service created by the Helm chart, making it easier to access once deployed. If your Helm chart does not create a service with an external IP, you may omit this step.

Before you run this program, ensure that you've installed the Pulumi CLI, have access to your Rancher environment, and the Pulumi setup is configured with the current context of your desired Kubernetes cluster.

Run the Pulumi program with the following command:
```bash
pulumi up
```

This command will prompt you to confirm the deployment after showing you a preview of the resources that will be created. Once confirmed, Pulumi will proceed with deploying the Helm chart to your Rancher Kubernetes cluster.