Deploy the aws-spot-termination-handler helm chart on Azure Kubernetes Service (AKS)

Question

Pulumi · Accepted Answer

To deploy the AWS Spot Termination Handler Helm chart on Azure Kubernetes Service (AKS), you’ll need to perform several steps. First, you must create an AKS cluster. Once the cluster is running, you will install the Helm package managing tool in your cluster and then use it to deploy the Helm chart.

Let's go through these steps:

Provision an Azure Kubernetes Service (AKS) Cluster: You can do this using the azure-native.containerregistry.ScopeMap API from the Pulumi Azure Native provider. This will create and configure an AKS cluster in your Azure account.
Setup Helm and Tiller on AKS: Helm 3, which is the latest version at the time of writing, does not require Tiller. If you are using Helm 2, you would need to install Tiller on your AKS cluster. This is typically done using a Kubernetes ServiceAccount and ClusterRoleBinding, and then initializing Helm with helm init.
Deploy AWS Spot Termination Handler: With Helm set up, you can now deploy the AWS Spot Termination Handler Helm chart. You will pass the necessary configuration values to the Helm chart, which will deploy the AWS Spot Termination Handler resources on your AKS cluster.

Below is a Pulumi TypeScript program that demonstrates how to perform these actions:

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

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

const cluster = new azure_native.containerservice.ManagedCluster("myAKSCluster", {
    resourceGroupName: resourceGroup.name,
    agentPoolProfiles: [{
        count: 3,
        name: "agentpool",
        vmSize: "Standard_DS2_v2",
        osType: "Linux",
    }],
    dnsPrefix: "myakscluster",
    linuxProfile: {
        adminUsername: "aksuser",
        ssh: {
            publicKeys: [{
                keyData: "ssh-rsa ...", // use your SSH public key
            }],
        },
    },
    servicePrincipalProfile: {
        clientId: "<client-id>",
        secret: "<client-secret>",
    },
});

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

const k8sProvider = new k8s.Provider("k8sProvider", {
    kubeconfig: kubeconfig,
});

// Step 2: Set up Helm (Helm 3 does not require Tiller)

// Step 3: Deploy AWS Spot Termination Handler Helm chart
const awsSpotTermHandler = new k8s.helm.v3.Chart("aws-spot-termination-handler", {
    repo: "stable",
    chart: "aws-spot-termination-handler",
    // version: "x.y.z", // specify the chart version here
}, { provider: k8sProvider });

// Export the name of the cluster
export const aksClusterName = cluster.name;

Explanation of resources:

azure_native.resources.ResourceGroup creates a new resource group where all resources are stored.
azure_native.containerservice.ManagedCluster creates the actual AKS Cluster with Linux as the OS type for the nodes, and sets up the SSH access.
The k8s.Provider is then used to interact with the AKS cluster using the exported kubeconfig.
k8s.helm.v3.Chart is used to deploy the AWS Spot Termination Handler using the chart from the Helm repository.

In this program, make sure to replace placeholders like <client-id>, <client-secret>, and ssh-rsa ... with appropriate values.

You will need to have Pulumi installed and configured with your Azure account credentials to run this program. Run pulumi up to provision the resources, which will create the AKS cluster and deploy the Helm chart as per the configuration specified in the program.

Note that, as of this writing, AWS Spot Termination Handler is designed to work within the AWS environment and might not be directly applicable to AKS clusters on Azure. You may need to adapt the termination handler to work with Azure's spot instance termination notices, or look for an equivalent tool that is tailored for Azure.