Deploy the resource-srv helm chart on Rancher

Question

Pulumi · Accepted Answer

Deploying a Helm chart on Rancher using Pulumi involves several steps. We will need to:

1. Create a Kubernetes cluster managed by Rancher, if one doesn't already exist.
2. Configure Pulumi to communicate with Rancher.
3. Deploy the `resource-srv` Helm chart onto the Rancher Kubernetes cluster.

For this tutorial, I am going to assume that you already have a Rancher-managed Kubernetes cluster up and running. If not, you'd need to create one using the `rancher2.Cluster` resource.

Here is a basic step-by-step guide to deploy a Helm chart onto a Rancher cluster using Pulumi:

1. **Configure Pulumi to Use the Rancher2 Provider**: The Pulumi Rancher2 provider will enable us to interact with your Rancher server and its resources.

2. **Install the `resource-srv` Helm Chart**: Helm charts are packages of pre-configured Kubernetes resources. Here we’ll demonstrate how to install a Helm chart named `resource-srv` into your cluster.

We will write a TypeScript program to accomplish this. Before you begin, ensure that you have Pulumi installed and configured to work with TypeScript, and you have access to your Rancher server.

Here is the Pulumi TypeScript program to accomplish this:

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

// Replace the following variables with your Rancher cluster details
const rancherServerUrl = 'https://your-rancher-server-url';
const rancherBearerToken = '<Your Rancher Bearer Token>';

// Configure the Rancher2 provider
const rancherProvider = new rancher2.Provider('rancherProvider', {
    apiUrl: rancherServerUrl,
    bearerToken: rancherBearerToken,
});

// Obtain a reference to your Rancher managed cluster, replace `cluster-name` with your actual cluster name
const cluster = rancher2.getCluster({
    name: 'cluster-name',
}, { provider: rancherProvider });

// Now we setup the Kubernetes provider to point to the Kubernetes cluster managed by Rancher
const k8sProvider = new k8s.Provider('k8sProvider', {
    kubeconfig: cluster.kubeConfig,
});

// Deploy the `resource-srv` Helm chart
const theHelmChart = new k8s.helm.v3.Chart('resource-srv-chart', {
    chart: 'resource-srv',
    // Use the version and repo that the `resource-srv` Helm chart is in. 
    // You also will include values here if you have any.
    // For example: version: '1.2.3', repositoryOpts: { repo: 'http://charts.example.com/' }
}, { provider: k8sProvider });

export const helmChartName = theHelmChart.metadata.apply(meta => meta.name);
```

In this program:

- We configure the Pulumi Rancher2 provider using the Rancher server URL and a bearer token. Please replace the placeholder text with your actual Rancher server URL and your bearer token.
- We then obtain a reference to the managed Kubernetes cluster.
- With the cluster's kubeconfig, we configure a Kubernetes provider.
- Using the Kubernetes provider, we deploy the Helm chart named `resource-srv`.

You need to adjust the chart, version, and repository options accordingly to match the `resource-srv` Helm chart you wish to deploy.

This will deploy the `resource-srv` Helm chart to your cluster. You can then access the deployed resources using Kubernetes tooling, such as `kubectl` or the Rancher UI.

Please ensure you replace placeholders (like URLs and tokens) with actual values applicable to your environment. Additionally, if your Helm chart requires values, you must provide them in the `values` section within the `.Chart` constructor.