Deploy the openshift-gitops-instance helm chart on Rancher

Question

Pulumi · Accepted Answer

Deploying a Helm chart on a Kubernetes cluster managed by Rancher can be done using Pulumi. In this case, you wish to deploy the `openshift-gitops-instance` Helm chart, which is related to setting up a GitOps workflow in an OpenShift cluster. The necessary steps include setting up the Rancher Kubernetes cluster (if it does not already exist), adding a catalog if necessary for the Helm chart, and then deploying the chart itself.

Below is a Pulumi program written in TypeScript that outlines how to deploy a Helm chart to a Rancher-managed Kubernetes cluster. This example assumes you have a Rancher Kubernetes cluster already running.

1. **Create a new project**: Initialize a new Pulumi project in TypeScript if you haven't already.
2. **Install the necessary provider**: Since we'll be interacting with Rancher, you'll need to have the `@pulumi/rancher2` provider installed.

Run `npm install @pulumi/rancher2` to install the Pulumi Rancher provider.

3. **Write the Pulumi Code**: Here's how you can define the Rancher cluster and deploy the `openshift-gitops-instance` Helm chart.

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

// This code assumes that you have already configured the Pulumi Rancher2 provider,
// which should be pointing to a Rancher instance that has a Kubernetes cluster.

// Fetch the Rancher2 cluster object using the cluster id or name.
const cluster = rancher2.getCluster({
    name: "my-rancher-cluster", // Replace with your Rancher Cluster name or ID
});

// Use the fetched cluster's kubeconfig to setup the Kubernetes provider.
const k8sProvider = new k8s.Provider("k8s-provider", {
    kubeconfig: cluster.kubeConfig, // This will use the kubeconfig from the Rancher cluster
});

// Now we define our Helm chart using the Kubernetes provider based on our cluster.
const helmChart = new k8s.helm.v3.Chart("openshift-gitops-instance", {
    chart: "openshift-gitops-instance",
    version: "1.2.3", // Replace with the actual chart version you want to deploy
    fetchOpts:{
        repo: "http://helm-repository/url/here", // Replace with the Helm repo URL where the chart is located
    },
    // Define values for the chart as needed. This is based on the Helm chart's `values.yaml` file.
    values: { 
        // Insert any required values here
    },
}, { provider: k8sProvider });

// Export the URL or any other output you might want to see after deployment.
export const deployedChart = helmChart.resourceNames;
```

This Pulumi program is a blueprint that outlines:

- Fetching information about an existing Rancher-managed Kubernetes cluster.
- Using the Kubernetes provider to interact with that cluster.
- Deploying a Helm chart on the cluster.

Make sure to replace placeholders, such as the chart version, repository URL, and Rancher cluster details, with actual values that pertain to your specific setup.

You should apply this Pulumi code using the Pulumi CLI. Run `pulumi up` and confirm the deployment to provision the resources defined in the code. If successful, the Helm chart `openshift-gitops-instance` would be deployed on your Rancher Kubernetes cluster.