Deploy the ambassador-operator helm chart on Opensshift

Question

Pulumi · Accepted Answer

To deploy the Ambassador Operator Helm chart on OpenShift using Pulumi, you will need to interact with Kubernetes resources. Specifically, you can utilize the kubernetes.helm.v3.Chart resource provided by Pulumi's Kubernetes provider to deploy Helm charts.

Below is a Pulumi program in TypeScript that demonstrates how to deploy the Ambassador Operator Helm chart on an OpenShift cluster. Before you run this code, ensure you have configured Pulumi to use Kubernetes as the cloud provider and contextualized it with access to your OpenShift cluster.

The Kubernetes provider kubernetes.helm.v3.Chart is a high-level resource that simplifies deploying a Helm chart to a Kubernetes cluster. It's a wrapper around Helm's capabilities, allowing you to define the deployment of a Helm chart declaratively within Pulumi's infrastructure as code paradigm.

Here's a step-by-step explanation of what each part of the program does:

import * as k8s from "@pulumi/kubernetes";: This line imports the Pulumi Kubernetes provider, which allows you to interact with your Kubernetes cluster.
const ambassadorOperatorChart = new k8s.helm.v3.Chart("ambassador-operator", {...});: This line creates a new Helm chart resource that represents the Ambassador Operator chart. It is named ambassador-operator in the Pulumi program.
The chart argument specifies the name of the Helm chart you wish to deploy, which in this case is ambassador.
The version argument specifies which chart version to deploy. If not set, the latest version is used.
The namespace argument specifies in which Kubernetes namespace the chart should be deployed. If not set, the chart will be deployed in the default namespace.
The values argument provides configuration options for the Helm chart. These correspond to the custom values you would typically define in a values.yaml file when using Helm directly.

Please note the following prerequisites before running this Pulumi program:

You have OpenShift CLI (oc) installed and configured with the appropriate context to connect to your OpenShift cluster.
You have Pulumi CLI installed and set up with the necessary credentials for your chosen cloud provider.
The Helm chart for Ambassador Operator is accessible from your Kubernetes cluster, so it can be fetched by Helm when deploying the chart.

Now, here is your Pulumi TypeScript program:

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

// Deploy the Ambassador Operator Helm Chart
const ambassadorOperatorChart = new k8s.helm.v3.Chart("ambassador-operator", {
    // This should match the chart you would like to deploy chart from the Helm repository
    chart: "ambassador",
    // Specify the version of the chart, if desired
    version: "6.7.13",
    // Set the target namespace for the Helm chart or it will be installed in the default namespace
    namespace: "ambassador",
    // Optional: Pass a custom `values.yaml` configuration
    values: {
        // Refer to the Ambassador Operator chart's documentation for available configuration options
        // and set them here if needed. For example, you might want to set the replicas and service type:
        // replicaCount: 3,
        // service: { type: "LoadBalancer" }
    },
    // Optional: Set additional options such as custom fetch parameters
    fetchOpts: {
        // If the Helm repository requires authentication, provide it here
        // username: "<username>",
        // password: "<password>",
    },
    // Optional: Include any special transformations or resource options if necessary
    transformations: [
        // Example: Add a label to all resources in this Helm chart
        (resource) => {
            if (resource.metadata.labels) {
                resource.metadata.labels["deployed-by"] = "pulumi";
            } else {
                resource.metadata.labels = { "deployed-by": "pulumi" };
            }
        },
    ],
});

// Export the Chart's status
export const chartStatus = ambassadorOperatorChart.status;

// Documentation for the Kubernetes Helm Chart resource can be found here:
// https://www.pulumi.com/docs/reference/pkg/kubernetes/helm/v3/chart/

To run this program, follow these steps:

Save the above code in a file named index.ts.
Install the Pulumi CLI and the necessary Node.js packages.
Use the terminal to navigate to the directory containing your index.ts file.
Run pulumi up to preview and apply the changes.

When applied, the pulumi up command will deploy the Ambassador Operator Helm chart to the specified namespace in your OpenShift cluster. The status of the Helm Chart deployment is exported as chartStatus, which you can use to retrieve and monitor the deployment state.