Deploy the provider-openstack helm chart on Rancher

Question

Pulumi · Accepted Answer

To deploy a Helm chart on Rancher using Pulumi, you can use the rancher2 provider. This provider allows you to manage resources on a Rancher server such as clusters, catalogs, workloads, and Helm charts.

In this explanation, I will walk you through the process of deploying the provider-openstack Helm chart onto a Rancher-managed Kubernetes cluster. We will start by defining the necessary configuration needed for the rancher2 provider, including the location of the Helm chart. Then, we'll create a namespace in which we'll deploy our chart, followed by the deployment itself using the rancher2.AppV2 resource.

Here is a program written in TypeScript that does just that:

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

// You need to install the Rancher2 provider and configure it properly with credentials.
// Check the documentation for the Rancher2 provider setup: https://www.pulumi.com/registry/packages/rancher2/

// First, create a namespace for the Helm chart deployment.
const namespace = new rancher2.Namespace("openstack-namespace", {
    name: "openstack-system",  // The name of the namespace
});

// Deploy the provider-openstack Helm chart.
const helmChart = new rancher2.AppV2("openstack-helm", {
    namespaceId: namespace.id,           // Use the created namespace ID
    repoName: "helm",                    // The Helm repository name where the chart is hosted
    chartName: "provider-openstack",     // The name of the chart you want to deploy
    chartVersion: "1.0.0",               // Replace this with the actual chart version you want to deploy
    clusterId: "<RANCHER-CLUSTER-ID>",   // The ID of the target Rancher cluster
    // Values for the Helm chart in YAML format or a "values.yaml" file path.
    values: `            
        # Set your Helm chart values here, for instance:
        image:
          repository: openstackhelm/heat
          tag: latest
        service:
          type: ClusterIP
          ports:
            heatApi:
              port: 8004
        # ... additional configurations
    `,
});

// Export the name of the namespace and the chart name as an output
export const namespaceName = namespace.metadata.apply(meta => meta.name);
export const helmChartName = helmChart.metadata.apply(meta => meta.name);

This Pulumi program performs the following actions:

It imports the needed modules from Pulumi, including the rancher2 package which contains the resources necessary to deploy on a Rancher-managed cluster.
It creates a Kubernetes namespace where the Helm chart will be deployed.
It deploys the provider-openstack Helm chart inside the created namespace in the specified Rancher cluster. Note that you must replace <RANCHER-CLUSTER-ID> with the actual ID of your Rancher cluster.
It sets the configuration values for the Helm chart. These values must be customized according to the particular requirements of your deployment.

Make sure to replace placeholder values with the actual values for your environment, like chartVersion, clusterId, and set the necessary Helm configuration under values.

To deploy this Pulumi program:

Ensure that you have Pulumi installed and configured.
Install the @pulumi/rancher2 package using npm – run npm install @pulumi/rancher2 in the directory where your Pulumi program lives.
Replace the placeholder values in the code with your specific configuration.
Run pulumi up to execute the Pulumi program and create the resources on your Rancher server.

Ensure that you have proper access to the Rancher API and permissions to deploy on the Kubernetes cluster managed by Rancher.