Deploy the flanksource-flux helm chart on Rancher

Question

Pulumi · Accepted Answer

To deploy a Helm chart on a Kubernetes cluster managed by Rancher, you must first ensure that you have a Rancher cluster configured and have access to it through Pulumi. In this example, I’ll guide you on how to deploy the flanksource-flux Helm chart on a Rancher Kubernetes cluster using Pulumi with TypeScript.

Here are the steps we’ll follow:

Set up a Rancher Cluster: Ensure you have a Kubernetes cluster imported or created in Rancher.
Install the Pulumi Rancher2 Provider: We'll use the Rancher2 provider to interact with Rancher.
Configure Pulumi to use the Rancher Cluster: This involves setting up the necessary credentials and pointing to the correct Rancher cluster.
Deploy the flanksource-flux Helm Chart: We'll define a Pulumi resource to deploy the helm chart to the cluster.

Here is a detailed Pulumi program written in TypeScript:

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

// Step 1: Ensure you have a Rancher cluster managed by Rancher.
// The example assumes you have already set up a Kubernetes cluster and have it added to Rancher. 

// Step 2: Install Pulumi Rancher2 Provider.
// Make sure you have configured your Pulumi installation with Rancher's access credentials.
// This can typically be done using the Pulumi config commands or by setting the environment variables.

// Step 3: Configure Pulumi to use the Rancher Cluster.
// Here we need to instantiate the provider and set up the points of access.
// Replace the 'rancherApiUrl', 'accessKey', and 'secretKey' with your own Rancher access details.

const rancherProvider = new rancher2.Provider("my-rancher-provider", {
  apiUrl: "https://<rancherApiUrl>",
  accessKey: "<accessKey>",
  secretKey: "<secretKey>",
});

// Step 4: Deploy the flanksource-flux Helm Chart
// Use the Pulumi Kubernetes provider to deploy the helm chart to the cluster.

// Assuming you have a project configured in Rancher, specify the project ID 
// where the helm chart should be deployed.
const project = "<project-id>";

// Initialize the Kubernetes provider using the rancherProvider we created above
const k8sProvider = new k8s.Provider("k8s-provider", {
  kubeconfig: pulumi.output(rancherProvider.kubeConfigs.apply(kc => kc[project].config)),
});

// Deploy the Helm chart onto the cluster
const helmChart = new k8s.helm.v3.Chart("flanksource-flux", {
  chart: "flux",
  version: "1.0.0", // Replace with the desired version of flanksource-flux Helm chart
  fetchOpts:{
    repo: "https://charts.flanksource.com", // The repository URL for the helm chart
  },
}, {provider: k8sProvider});

// Export the base URL for the deployed helm chart
export const helmChartUrl = helmChart.getResourceProperty(
  "v1/Service", "flux", "status", "loadBalancer", "ingress", "0", "hostname"
);

Explanation:

Import Dependencies: We import the required Pulumi packages. The @pulumi/rancher2 package allows us to interact with Rancher, and the @pulumi/kubernetes package lets us work with Kubernetes resources.
Rancher Provider Configuration: We create a Rancher provider definition with the necessary API URL and credentials. You need to replace placeholder values (like <rancherApiUrl>, <accessKey>, <secretKey>, and <project-id>) with actual values from your Rancher setup.
Kubernetes Provider Configuration: We leverage the kubeconfig from the Rancher provider to configure our Kubernetes provider, which allows Pulumi to deploy resources to the Rancher-managed cluster.
Helm Chart Deployment: We define a Helm chart resource for flanksource-flux. This resource points to the Flux chart version you wish to deploy and specifies the repository URL where the Helm chart is located.
Exporting the Helm Chart URL: As an optional step, we export the URL of the deployed Helm chart if it's exposed through a load balancer. This way, you can access the URL outside Pulumi.

Please replace all the placeholder values with the actual values from your Rancher and Kubernetes setup before running the program. Once you’ve made the necessary changes, you can deploy the program with Pulumi CLI using the pulumi up command. This will start the deployment process based on the configuration and resources defined in the code.