Deploy the generic-route helm chart on Opensshift

Question

Pulumi · Accepted Answer

In order to deploy a Helm chart on OpenShift using Pulumi, we can utilize the kubernetes package which offers a variety of resources for managing Kubernetes resources, including Helm charts. The specific resource we'll use is helm.sh/v3.Chart, which is designed for deploying Helm charts.

Below is a detailed program that demonstrates how to deploy the generic-route Helm chart on an OpenShift cluster using Pulumi with TypeScript. I'll explain each part of the process.

Firstly, ensure you have an existing OpenShift cluster and access to it. You should be logged in to your cluster using the oc command-line tool and have the necessary permissions to deploy applications.

Here's the Pulumi program:

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

// Assume you have access to the OpenShift cluster via the `kubeconfig` file.
// Pulumi uses the active context in the kubeconfig file just like kubectl does.

// Create an instance of the `Chart` resource, which represents a Helm chart deployment.
const genericRouteChart = new k8s.helm.v3.Chart("genericRoute", {
    // Replace '<repo_uri>' with the Helm repository URI where the 'generic-route' chart is located.
    // The 'repo' option allows you to specify the repository if your chart is not in the default Pulumi repository.
    repo: "<repo_uri>",
    chart: "generic-route", // The name of the chart you wish to deploy.

    // You can specify the chart version you wish to deploy using the `version` property if needed.
    // version: "<chart_version>",

    // Configure the values for the Helm chart in this object.
    // These values would correspond to the custom configurations you wish to apply to the chart.
    values: {
       // Insert your values structure here. For example, you might set a service type or resource limits.
       // service: { type: "LoadBalancer" },
       // resources: { limits: { cpu: "100m", memory: "200Mi" }, requests: { cpu: "100m", memory: "200Mi" } },
    },

    // You should specify the OpenShift project (namespace) where you want to deploy the Helm chart.
    // If the namespace doesn't exist, it needs to be created beforehand.
    namespace: "your-openshift-project", // Change this to your actual project name.
    
    // If you have any custom transformations, you can specify them here.
    // transformations: [ /* ... */ ],
});

// Export the status URL of the application deployed using Helm chart.
export const appUrl = genericRouteChart.getResourceProperty("v1/Service", "generic-route", "status").apply(status => {
    return status.loadBalancer.ingress[0].hostname;
});

In the above program, replace <repo_uri> and <chart_version> with the Helm repository URI and the version of the generic-route chart you want to deploy. You must also specify the OpenShift project (namespace) by replacing your-openshift-project with the actual project name you're using in OpenShift.

The values property is used to set configuration parameters for the Helm chart. These should match the configuration options available in the generic-route Helm chart. You can set configurations such as service type, resource limits, etc., that suit your application's needs.

Finally, we export appUrl, which assumes that the deployed service is of type LoadBalancer and provides an external endpoint. If your service type or setup is different, you would need to adjust the retrieval and export of the correct application URL accordingly.

For full documentation on the helm.v3.Chart resource, refer to the Pulumi documentation for Helm charts.