Deploy the prometheus-puppetdb-sd helm chart on Rancher

Question

Pulumi · Accepted Answer

To deploy a Helm chart on a Rancher-managed Kubernetes cluster, you can use Pulumi with the rancher2 provider. The Rancher provider allows you to interact with resources in a Rancher server, and you can utilize the Helm Release resource as part of the Kubernetes provider to deploy Helm charts.

Here's a step-by-step guide and the corresponding Pulumi TypeScript program to achieve your goal:

Set up the Rancher2 provider: Configure the provider with the necessary credentials to interact with your Rancher server.
Identify or create a Kubernetes cluster in Rancher: Ensure you have a cluster where you intend to deploy the Prometheus-PuppetDB-SD Helm chart. You can reference an existing cluster or create a new one using the Rancher2 provider.
Deploy the Helm chart: Use the Helm Release resource from the Kubernetes provider to deploy the Helm chart to the targeted cluster.

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

// Initialize a Rancher provider instance.
const rancherProvider = new rancher2.Provider('rancher', {
    apiUrl: "https://<RANCHER_API_URL>", // Replace with your Rancher server URL.
    accessKey: "<RANCHER_ACCESS_KEY>", // Replace with your Rancher access key.
    secretKey: "<RANCHER_SECRET_KEY>", // Replace with your Rancher secret key.
});

// Reference an existing Rancher cluster where you want to deploy the Helm chart.
// Ensure you have the right cluster ID.
const cluster = new rancher2.Cluster("example-cluster", {
    id: "<RANCHER_CLUSTER_ID>", // Replace with the ID of your Rancher-managed cluster.
}, {provider: rancherProvider});

// Configure Kubernetes provider to deploy resources to the targeted Rancher-managed cluster.
const k8sProvider = new k8s.Provider("k8s-provider", {
    kubeconfig: cluster.kubeConfig,
});

// Deploy the prometheus-puppetdb-sd Helm chart using the Kubernetes provider.
const prometheusPuppetdbSdChart = new k8s.helm.v3.Release("prometheus-puppetdb-sd", {
    chart: "prometheus-puppetdb-sd",
    repositoryOpts: {
        repo: "https://<HELM_CHART_REPO_URL>", // Replace with the URL of the Helm chart repository.
    },
    version: "<HELM_CHART_VERSION>", // Optionally specify a chart version, replace or omit if you want to use the latest version.
    // Define values to configure the chart as needed.
    values: {
        // Add your custom values here e.g. 
        // serviceAccount: {
        //     create: true,
        //     name: "prometheus-puppetdb-sd",
        // },
    },
}, {provider: k8sProvider});

// Export the name of the Helm release
export const releaseName = prometheusPuppetdbSdChart.status.name;

Please replace <RANCHER_API_URL>, <RANCHER_ACCESS_KEY>, <RANCHER_SECRET_KEY>, and <RANCHER_CLUSTER_ID> with your specific Rancher API URL, access key, secret key, and the ID of the Rancher-managed cluster you want to deploy to. For the Helm chart repository URL ( <HELM_CHART_REPO_URL>), you would replace it with the actual repository URL hosting the prometheus-puppetdb-sd chart, and for the chart version ( <HELM_CHART_VERSION>), you can specify the chart version you wish to deploy or omit the version key to use the latest version.

The values object within the Release should be populated with configuration specific to the Prometheus-PuppetDB-SD Helm chart. This often includes parameters like service account settings, persistence options, and so on. Check the Helm chart's documentation for available configuration options.

After creating the program file (e.g. index.ts), run pulumi up to execute the Pulumi program which will deploy the Prometheus-PuppetDB-SD Helm chart to the specified Rancher-managed Kubernetes cluster. Don't forget to ensure you have the Pulumi CLI installed and have authenticated with Rancher before running the program.