Deploy the stash helm chart on Kubernetes

Question

Pulumi · Accepted Answer

To deploy the Stash Helm chart on a Kubernetes cluster using Pulumi, you'll need to use the Chart class from the @pulumi/kubernetes package. This class enables you to deploy Helm charts in a Pulumi program. Stash is a cloud-native data backup and recovery solution for Kubernetes workloads.

Below, I’ll explain the step-by-step Pulumi TypeScript program that deploys the Stash Helm chart:

Import the necessary packages: You will need to import the @pulumi/kubernetes package to interact with Kubernetes resources.
Create a Kubernetes provider instance: If you're using a cluster with kubeconfig file or the cluster is already set up with your environment, Pulumi can use your current context. If you need to specify a different context, you can create a provider instance and pass the kubeconfig explicitly.
Use the Chart resource: With Pulumi's Kubernetes provider, the Chart resource allows you to install a Helm chart from a repo. You will need to specify the chart name, version (optional), and any values that you want to override in the chart's values.yaml.
Set namespace (optional): If you want to deploy the chart into a specific namespace, you should set the namespace property; otherwise, the default namespace will be used.
Deploy the chart: When you instantiate the Chart class with the required parameters, Pulumi will deploy the Helm chart when you run pulumi up.

Here's what the corresponding Pulumi program might look like:

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

// Initialize a Kubernetes provider if not using the default context
const provider = new kubernetes.Provider("provider", {
    kubeconfig: "<YOUR_KUBECONFIG_CONTENTS>",
});

// Deploy the Stash Helm chart using a Chart resource. Make sure to replace `<CHART_VERSION>`
// with the version of the Helm chart you want to deploy, if you want to pin to a specific version.
const stashChart = new kubernetes.helm.v3.Chart("stash", {
    chart: "stash",
    version: "<CHART_VERSION>", // specify the chart version, e.g., "0.9.0-rc.6"
    repositoryOpts: {
        repo: "https://charts.stashed.io/",
    },
    // Specify namespace if needed, otherwise it will be deployed in the default namespace
    namespace: "default",
    // Set any custom values for the Helm chart. This is similar to the `values.yaml` file in a Helm chart
    // and allows you to set custom configuration for the chart
    values: {
        // example of setting values
        // you should consult the Stash chart's values.yaml to find settings appropriate for your requirements
        backupBuckets: {
            s3: {
                endpoint: "s3.amazonaws.com",
                bucket: "my-backup-bucket",
                region: "us-east-1"
            }
        },
    },
}, { provider }); // specify the provider if a custom provider is being used

// Optional: export the chart's name
export const chartName = stashChart.metadata.name;

// To run this Pulumi program, save it in an index.ts file and run `pulumi up`.

In the values object, you replace the content with the configuration you need for your Stash deployment. Consult the specific Helm chart's documentation for the correct values to be customized.

Note: Replace "<YOUR_KUBECONFIG_CONTENTS>" and "<CHART_VERSION>" placeholders with your actual kubeconfig file contents and the version of the Stash Helm chart that you wish to deploy. If your kubeconfig file is already configured for Pulumi by default, you don't need to specify the provider, and you can remove the related code lines. If not specifying a version, Pulumi will install the latest version by default.

This program can be saved in a file (e.g., index.ts), and then you can deploy it using the Pulumi CLI by running the pulumi up command in the terminal. Make sure you are in the same directory as the file when you run the command.