Deploy the wikibase-ingress helm chart on Linode Kubernetes Engine

Question

Pulumi · Accepted Answer

In order to deploy the Wikibase application using a Helm chart on a Kubernetes cluster provided by Linode Kubernetes Engine (LKE), you'll need to follow several steps. Pulumi allows you to define your infrastructure as code using familiar programming languages such as TypeScript.

The process includes these general steps:

Set up a new Pulumi project and install necessary dependencies.
Configure access to your Linode Kubernetes cluster.
Write a Pulumi program to deploy the Helm chart for Wikibase.
Execute the Pulumi program to apply the changes to your cluster.

Below, you'll find a detailed explanation and a TypeScript program that defines the necessary steps to deploy the Wikibase using its Helm chart onto an LKE cluster.

Firstly, you would initialize a new Pulumi project and install the necessary Pulumi Kubernetes package if not already installed:

# Create a new Pulumi project directory
mkdir wikibase-helm-lke && cd wikibase-helm-lke

# Create a new Pulumi TypeScript project
pulumi new typescript

# Install the Pulumi Kubernetes package
npm install @pulumi/kubernetes

Ensure you have access to your Linode Kubernetes cluster by retrieving kubeconfig from Linode and setting the KUBECONFIG environment variable accordingly.

Now, let's define the Pulumi program that you will use to deploy the Helm chart:

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

// You should already be authenticated with Linode and have the KUBECONFIG variable set.

// Create a new Kubernetes provider instance that uses the Linode Kubernetes cluster.
const provider = new k8s.Provider("lke-provider", {
    kubeconfig: process.env.KUBECONFIG, // This grabs the kubeconfig environment variable.
});

// Deploy the wikibase-ingress Helm chart using the kubernetes.helm.v3.Chart class.
const wikibaseChart = new k8s.helm.v3.Chart("wikibase-ingress", {
    // Replace '<repository>' with the actual repository URL that hosts the wikibase-ingress Helm chart.
    // For example, 'https://charts.bitnami.com/bitnami' if you are using a Bitnami chart repository.
    repo: "<repository>",
    chart: "wikibase-ingress",
    // Set the values based on the specific requirements of the wikibase-ingress Helm chart.
    // Refer to the chart's values.yaml or official documentation for the complete list of configurable parameters.
    values: {
        // Example values. These values can vary based on the actual chart and your specific needs.
        persistence: {
            enabled: true,
            storageClass: "linode-block-storage", // Make sure this storage class is available on your LKE cluster.
            size: "10Gi",
        },
        service: {
            type: "LoadBalancer",
        },
        // ...include other values as needed
    },
}, { provider }); // This ensures that the Helm chart is deployed using the Linode cluster provider.

// Optionally, if you want to expose the Wikibase instance using an Ingress, you could define it here.

// Export the URL of the deployed application.
export const url = wikibaseChart.getResourceProperty(
    "v1/Service", "wikibase-ingress-service", "status"
).apply(status => {
    const ingress = status.loadBalancer.ingress[0];
    return ingress.ip || ingress.hostname; // This will export the public IP or the hostname.
});

Run the program using Pulumi as follows:

# Login to Pulumi to store your state files either in Pulumi service or other backend like local filesystem, S3, etc.
pulumi login

# Run the Pulumi program to deploy the Helm chart
pulumi up

This program creates an instance of the Helm chart for the Wikibase, specifying configuration values that are appropriate for your setup. After running the program, Pulumi will communicate with Linode's Kubernetes API and create the necessary resources as defined by the Helm chart.

The export const url statement at the end will provide the URL on which the Wikibase instance will be accessible. This could be an IP address or a domain name, depending on how the service is exposed and the DNS setup.

Be sure to replace placeholders like <repository> with actual values that apply to your specific Helm chart for Wikibase.

Lastly, the output of pulumi up will show the changes to be made and prompt you for confirmation before proceeding. If everything looks correct, you can confirm the deployment, and Pulumi will handle the rest, ensuring that the Helm chart gets deployed onto your LKE cluster.