Deploy the ibm-platform-navigator-instance helm chart on Azure Kubernetes Service (AKS)

Question

Pulumi · Accepted Answer

To deploy an IBM Platform Navigator instance using a Helm chart on Azure Kubernetes Service (AKS), you'll need to follow these steps:

Provision an AKS cluster.
Install and configure Helm, a package manager for Kubernetes.
Add the Helm chart repository containing the IBM Platform Navigator chart.
Deploy the chart to your AKS cluster.

In this Pulumi program, I'll guide you through setting up an AKS cluster with Pulumi and deploying the ibm-platform-navigator-instance Helm chart to it. We'll use azure-native for provisioning the AKS cluster, and the Helm chart will be managed with standard Kubernetes resources provided by Pulumi.

The program will be written in TypeScript, which is a popular choice for Pulumi projects due to its strong typing features and compatibility with JavaScript ecosystems.

Here is a step-by-step Pulumi TypeScript program that sets up an AKS cluster and deploys the IBM Platform Navigator using a Helm chart:

import * as pulumi from "@pulumi/pulumi";
import * as azure_native from "@pulumi/azure-native";
import * as k8s from "@pulumi/kubernetes";

// Set up a resource group for the AKS cluster
const resourceGroup = new azure_native.resources.ResourceGroup("myResourceGroup", {
    // Provide a location for your resource group
    location: "EastUS",
});

// Create the AKS cluster
const cluster = new azure_native.containerservice.ManagedCluster("myAKSCluster", {
    // Link the cluster to the earlier created resource group
    resourceGroupName: resourceGroup.name,
    location: resourceGroup.location,
    // Define the properties for the AKS cluster, e.g., node count, size, and version
    agentPoolProfiles: [{
        count: 2,
        vmSize: azure_native.containerservice.VMSizeTypes.Standard_DS2_v2,
        name: "agentpool",
        mode: "System",
    }],
    // More AKS configurations could be added here
    dnsPrefix: "myakscluster", // Ensure this is a unique DNS prefix
});

// Export the kubeconfig for the AKS cluster
export const kubeconfig = pulumi.
    all([cluster.name, resourceGroup.name]).
    apply(([clusterName, rgName]) => {
        return azure_native.containerservice.listManagedClusterUserCredentials({
            resourceName: clusterName,
            resourceGroupName: rgName,
        });
    }).
    apply(creds => Buffer.from(creds.kubeconfigs[0].value, 'base64').toString());

// Now that we've created an AKS cluster, we need to configure Pulumi to use
// the kubeconfig from the newly created cluster so that we can deploy Kubernetes resources
const k8sProvider = new k8s.Provider("k8sProvider", {
    kubeconfig: kubeconfig,
});

// Add the Helm chart repository that contains IBM Platform Navigator
const ibmChartRepo = new k8s.yaml.ConfigGroup("ibmChartRepo", {
    yaml: `
apiVersion: v1
kind: Namespace
metadata:
  name: ibm-system
---
apiVersion: helm.cattle.io/v1
kind: HelmChart
metadata:
  name: ibm-operator-catalog
  namespace: ibm-system
spec:
  chart: ibm-operator-catalog
  repo: https://<REPO_URL> // Replace <REPO_URL> with the URL to the IBM chart repository
  targetNamespace: ibm-system
  valuesContent: |-
    global:
      catalog:
        sourceNamespace: openshift-marketplace
`,
}, { provider: k8sProvider });

// Deploy the ibm-platform-navigator-instance helm chart
const ibmPlatformNavigatorChart = new k8s.helm.v3.Chart("ibm-platform-navigator-instance", {
    namespace: "ibm-system",
    chart: "ibm-platform-navigator",
    version: "1.0.0", // Specify the version of the Helm chart you want to deploy
    fetchOpts: {
        repo: "https://<REPO_URL>", // Replace <REPO_URL> with the URL to the IBM chart repository
    },
    // If there are any Helm values you would like to override, specify them here
    values: {
        // values to customize the IBM Platform Navigator
    },
}, { provider: k8sProvider });

// Export the status of the Helm release
export const ibmPlatformNavigatorStatus = ibmPlatformNavigatorChart.status;

This program performs the following actions:

Imports the necessary Pulumi packages for managing Azure resources and Kubernetes.
Creates a new Azure resource group to contain our AKS cluster.
Provisions an AKS cluster within the specified resource group.
Obtains the kubeconfig from the created AKS cluster to interact with the Kubernetes API.
Sets up the Kubernetes provider with the kubeconfig from the AKS cluster (enabling us to deploy Kubernetes resources).
Adds a Kubernetes ConfigGroup resource to create the necessary namespace and Helm chart repository for IBM Platform Navigator.
Deploys the IBM Platform Navigator Helm chart to the AKS cluster using a Chart resource from Pulumi's Helm provider. The version and values for the chart are customizable according to your requirements.

Please replace the placeholder <REPO_URL> with the URL of the actual IBM Helm chart repository.

Remember to run pulumi up to apply these changes to deploy your AKS cluster and then the IBM Platform Navigator instance. The output ibmPlatformNavigatorStatus will provide you with the deployment status of your Helm release.