Deploy the linkerd2 helm chart on Rancher
TypeScriptTo deploy the
linkerd2
Helm chart on a Rancher-managed Kubernetes cluster, we will use Pulumi's Rancher2 provider. This provider offers resources to manage various aspects of Rancher, including deploying Helm charts to Kubernetes clusters.Here's the process in detail:
-
Set Up Rancher2 Provider: We'll start by configuring the Rancher2 provider with the necessary credentials and endpoint information to communicate with your Rancher server.
-
Create a Catalog for Helm Repositories: Rancher organizes Helm charts in catalogs. We'll create a catalog that points to the Helm repo containing the
linkerd2
chart. -
Deploy the Helm Chart: Once we have a catalog, we can deploy the
linkerd2
Helm chart to a Rancher-managed cluster. -
Specify the Namespace: If you want to install the
linkerd2
chart within a specific Kubernetes namespace, we'll make sure to specify it.
Now, let's put this into a Pulumi program written in TypeScript:
import * as rancher2 from '@pulumi/rancher2'; import * as pulumi from '@pulumi/pulumi'; // Assumption: Rancher and Kubernetes configurations are already set in the environment // or the Pulumi configuration system. // Create a new Rancher2 Catalog - this catalog points to the Helm repo // where the linkerd2 chart is located. const linkerdCatalog = new rancher2.CatalogV2("linkerdCatalog", { clusterId: "<RANCHER_CLUSTER_ID>", // Replace with your Rancher Cluster ID url: "https://helm.linkerd.io/stable", // The Linkerd2 Helm repo URL gitBranch: "main", // Default branch in the Helm repo }); // Deploy the linkerd2 Helm Chart using Rancher2 App resource const linkerdApp = new rancher2.AppV2("linkerdApp", { namespace: "linkerd", // Namespace where Linkerd2 will be installed clusterId: "<RANCHER_CLUSTER_ID>", // Replace with your Rancher Cluster ID repoName: linkerdCatalog.name, chartName: "linkerd2", // The name of the Helm chart chartVersion: "<LINKERD_CHART_VERSION>", // Set the version of linkerd2 chart you want to deploy targetNamespace: "linkerd", // Target namespace for the Helm release }); // Export the name of the App export const linkerdAppName = linkerdApp.name;
Make sure to replace the
<RANCHER_CLUSTER_ID>
and<LINKERD_CHART_VERSION>
placeholders with your Rancher Cluster ID and the version of thelinkerd2
Helm chart you want to use.What does this program do?
- It starts by importing the necessary Rancher2 and Pulumi libraries.
- A
CatalogV2
resource is created to include the Linkerd Helm chart repository in Rancher's catalog system. You need to provide the URL of the Linkerd Helm chart repository and specify which branch to track on this repository. - An
AppV2
resource from the Rancher2 provider is used to deploy thelinkerd2
Helm chart using the catalog created in the previous step. Here you specify the cluster ID of the Rancher-managed Kubernetes cluster, the name of the Helm chart, the target namespace for the installation, and the chart version.
To run this Pulumi program, save it to a file such as
index.ts
, and ensure you have Pulumi and Node.js installed on your machine. Then, runpulumi up
in the directory containing the file to launch the deployment process. Pulumi will communicate with Rancher to set up the linkerd2 Helm chart on your Kubernetes cluster.-