Deploy the vsg-hw helm chart on Oracle Kubernetes Engine (OKE)

Question

Pulumi · Accepted Answer

To deploy a Helm chart on Oracle Kubernetes Engine (OKE) using Pulumi, you will need to use the kubernetes provider to interact with your Kubernetes cluster and the helm namespace within it to deploy the Helm chart. Here, we'll define a Pulumi program that will:

Assume that you have an existing Kubernetes cluster on Oracle Kubernetes Engine.
Deploy a Helm chart named vsg-hw to this cluster.

In this TypeScript program, we will use the kubernetes.helm.v3.Chart class from the Pulumi Kubernetes provider which allows us to install Helm charts into a Kubernetes cluster.

Below is a detailed guide followed by a Pulumi TypeScript program:

Setting Up Your Pulumi Kubernetes Configuration: In your TypeScript program, you'll set up the Kubernetes provider so Pulumi knows how to communicate with your OKE cluster.
Creating a Helm Chart Resource: Using the Chart class, define the deployment of the vsg-hw Helm chart. We'll pass in the required configuration like chart name, version, and any values to override the default settings.
Exporting Deployment Details (Optional): By exporting the deployment details, such as the Kubernetes services' public endpoints, you'll be able to easily access and manage the application deployed by the Helm chart.

Let's start by defining our Pulumi program in TypeScript:

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

// Provide the required configuration for your Oracle Kubernetes Engine cluster.
const clusterProvider = new kubernetes.Provider("oke-provider", {
    kubeconfig: "<Your OKE cluster kubeconfig>", // Replace this with the actual kubeconfig data or a way to retrieve it.
});

// Define the vsg-hw Helm chart deployment.
const vsgHwChart = new kubernetes.helm.v3.Chart("vsg-hw-chart", {
    chart: "vsg-hw",
    // Specify where your Helm chart is located. For instance, you can use a chart from a Helm repo.
    // Here, we assume that 'vsg-hw' is publicly available in a repository.
    // You might need to add 'repo' and 'version' if your chart requires it.
    fetchOpts: {
        repo: "http://your-helm-chart-repository/", // Replace with your actual Helm chart repository URL.
        // version: "1.0.0", // Uncomment and replace with the chart version if necessary.
    },
    // Add any overrides to the Helm chart's default values here.
    // Example: values: { service: { type: "LoadBalancer" } }
}, { provider: clusterProvider });

// (Optional) Exporting the service endpoint, assuming your Helm chart contains a Kubernetes service.
export const serviceEndpoint = vsgHwChart.getResourceProperty("v1/Service", "vsg-hw-service", "status").loadBalancer.ingress[0].hostname;

// Please note:
// - You need to replace `"<Your OKE cluster kubeconfig>"` with your actual cluster kubeconfig content.
// - Update the Helm chart location by specifying the `repo` URL (and optional `version` if necessary).

In the program above, replace the placeholders <Your OKE cluster kubeconfig> with your actual kubeconfig file contents for the OKE cluster and "http://your-helm-chart-repository/" with the URL of the Helm chart repository containing your vsg-hw chart. You can also specify a chart version or other parameters as needed.

The serviceEndpoint export at the end is optional and assumes that your Helm chart includes a Kubernetes service with the name vsg-hw-service. This line retrieves the external endpoint of the service, which can be accessed after the deployment is successful.

After the Pulumi program is applied using pulumi up, it will perform the deployment actions on your Oracle Kubernetes Engine deployment as directed by the Helm chart specification.