Deploy the resource-srv helm chart on Rancher
TypeScriptDeploying a Helm chart on Rancher using Pulumi involves several steps. We will need to:
- Create a Kubernetes cluster managed by Rancher, if one doesn't already exist.
- Configure Pulumi to communicate with Rancher.
- 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:
-
Configure Pulumi to Use the Rancher2 Provider: The Pulumi Rancher2 provider will enable us to interact with your Rancher server and its resources.
-
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 namedresource-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:
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 askubectl
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.