Deploy the orchard-cms helm chart on Azure Kubernetes Service (AKS)

Question

Pulumi · Accepted Answer

In order to deploy the Orchard CMS Helm chart on Azure Kubernetes Service (AKS), we'll break this process into a few steps:

Create an AKS Cluster: First, we're going to create a new AKS cluster where the Orchard CMS will run. We'll use the azure-native package, specifically the ManagedCluster resource, because it offers direct mapping to Azure's native APIs for AKS.
Deploy the Helm Chart: Once the cluster is ready, we'll use the Chart resource from the kubernetes package to deploy the Orchard CMS Helm chart into our AKS cluster.

Here's a Pulumi program in TypeScript that accomplishes this:

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

// Step 1: Create an AKS cluster
const resourceGroup = new azure.resources.ResourceGroup("myResourceGroup");

const aksCluster = new azure.containerservice.ManagedCluster("myAksCluster", {
    resourceGroupName: resourceGroup.name,
    agentPoolProfiles: [{
        count: 1,
        maxPods: 110,
        mode: "System",
        name: "agentpool",
        osDiskSizeGB: 30,
        osType: "Linux",
        vmSize: "Standard_DS2_v2",
    }],
    dnsPrefix: "myakscluster",
    linuxProfile: {
        adminUsername: "adminuser",
        ssh: {
            publicKeys: [{
                keyData: "<YOUR_SSH_PUBLIC_KEY>",
            }],
        },
    },
    servicePrincipalProfile: {
        clientId: "<YOUR_AZURE_CLIENT_ID>",
        secret: "<YOUR_AZURE_CLIENT_SECRET>",
    },
});

// Export the cluster's kubeconfig.
export const kubeconfig = aksCluster.kubeConfigRaw;

// Step 2: Deploy the Orchard CMS Helm chart
const orchardCmsChart = new k8s.helm.v3.Chart("orchard-cms", {
    chart: "orchard-cms",
    version: "<DESIRED_CHART_VERSION>", // use the desired chart version
    fetchOpts: {
        repo: "https://<REPOSITORY_URL_OF_ORCHARD_CMS_HELM_CHART>", // specify the Helm chart repository URL
    },
}, { provider: new k8s.Provider("k8s-provider", { kubeconfig }) });

// Export the endpoint to access Orchard CMS
export const orchardCmsEndpoint = orchardCmsChart.getResourceProperty("v1/Service", "orchard-cms", "status").apply(status => status.loadBalancer.ingress[0].ip);

In this program, we have:

Defined an Azure resource group to contain our AKS cluster.
Created the AKS cluster with a single node pool containing one node. Replace <YOUR_SSH_PUBLIC_KEY> with your actual SSH public key string to establish secure SSH access, and replace <YOUR_AZURE_CLIENT_ID> and <YOUR_AZURE_CLIENT_SECRET> with your Azure service principal credentials.
Exported the kubeconfig which will be used to interact with the AKS cluster.
Defined a Helm chart resource to deploy Orchard CMS. You will need to provide the correct Helm chart version and repository URL where the Orchard CMS Helm chart is hosted. Replace <DESIRED_CHART_VERSION> with the version of the Helm chart you want to deploy and https://<REPOSITORY_URL_OF_ORCHARD_CMS_HELM_CHART> with the URL of the Orchard CMS Helm chart.
Exported an endpoint (orchardCmsEndpoint) that can be used to access the Orchard CMS once it's deployed and available. This IP will be the external IP assigned to the service by AKS, which can be used to access the Orchard CMS application running in the cluster.

Make sure you have Pulumi installed and configured for Azure. Additionally, ensure you have kubectl installed if you want to manually interact with the cluster via the command line.

This will deploy the Orchard CMS to your AKS cluster. Once the deployment is complete, Pulumi will output the IP address you can use to access your Orchard CMS instance.