Deploy the kube-arangodb helm chart on Azure Kubernetes Service (AKS)

Question

Pulumi · Accepted Answer

To deploy the kube-arangodb Helm chart on an Azure Kubernetes Service (AKS) cluster using Pulumi, you will first need to create an AKS cluster and then deploy the Helm chart to this cluster. This process involves two primary resources:

1. **Azure Kubernetes Service (AKS) Cluster**: This is the managed Kubernetes service provided by Azure that simplifies the deployment, management, and operations of Kubernetes.

2. **Helm Chart**: Helm is a package manager for Kubernetes that allows you to define, install, and upgrade even the most complex Kubernetes applications using charts. The kube-arangodb chart will consist of the configurations needed to deploy and manage ArangoDB on Kubernetes.

Here's a step-by-step TypeScript program for deploying the kube-arangodb Helm chart on AKS:

1. Create an AKS cluster using the `azure-native.containerservice.ManagedCluster` resource.
2. Deploy the Helm chart to the AKS cluster using the `kubernetes.helm.v3.Chart` resource from the Pulumi Kubernetes provider.

Firstly, ensure that you have installed the Pulumi CLI, have an Azure account, and have configured your Pulumi to authenticate with Azure.

Below is the Pulumi program written in TypeScript to accomplish this:

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

// Step 1: Create the AKS cluster.

const resourceGroup = new azure.resources.ResourceGroup("aksResourceGroup", {
    resourceGroupName: "my-aks-resourcegroup",
    location: "EastUS", // Change to the desired Azure region
});

const managedCluster = new azure.containerservice.ManagedCluster("aksCluster", {
    resourceGroupName: resourceGroup.name,
    location: resourceGroup.location,
    agentPoolProfiles: [{
        count: 3, // Number of nodes
        vmSize: "Standard_DS2_v2", // Size of the nodes
        name: "agentpool",
        mode: "System", // Setting up as the default node pool
    }],
    dnsPrefix: "myakscluster",
    kubernetesVersion: "1.20.9", // Specify the desired Kubernetes version
});

// Step 2: Export the kubeconfig to communicate with the AKS cluster.

export const kubeConfig = pulumi.all([resourceGroup.name, managedCluster.name]).apply(([resourceGroupName, clusterName]) => {
    return azure.containerservice.listManagedClusterUserCredentials({
        resourceGroupName,
        resourceName: clusterName,
    });
}).apply(creds => {
    const encoded = creds.kubeconfigs[0].value;
    return Buffer.from(encoded, 'base64').toString();
});

// Step 3: Use the kubeconfig to create a Kubernetes provider instance.

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

// Step 4: Deploy the kube-arangodb Helm chart to the AKS cluster.

const arangoHelmChart = new kubernetes.helm.v3.Chart("arango-chart", {
    chart: "kube-arangodb",
    version: "1.2.3", // Specify the chart version here.
    fetchOpts: {
        repo: "https://github.com/arangodb/kube-arangodb", // The Helm chart repository
    },
}, { provider: k8sProvider });

// Step 5: Export the Helm chart deployment status.

export const arangoHelmStatus = arangoHelmChart.status;

```

In the program above, you will see the following:

- A new resource group is created to organize resources related to AKS.
- An AKS cluster is initialized with the specified node count and size, as well as the Kubernetes version.
- Kubernetes credentials for the created AKS cluster are retrieved and used to configure the Pulumi Kubernetes provider, which is necessary to deploy Kubernetes resources on the cluster.
- The `kube-arangodb` Helm chart is then deployed using the `kubernetes.helm.v3.Chart` resource, which installs ArangoDB on the AKS cluster. You will need to specify the correct chart version.
- The status of the Helm chart deployment is exported so you can observe its state and ensure that the deployment was successful.

Make sure the Helm chart version (`1.2.3` in the sample above) and Helm repo URL (`https://github.com/arangodb/kube-arangodb` used in the sample) are correctly set to the actual values that correspond to the kube-arangodb Helm chart you wish to deploy.

After you have this program ready, you can execute it using the following Pulumi CLI commands:

```bash
pulumi up
```

This command will preview and deploy the changes described by the Pulumi program, which includes creating the AKS cluster and deploying the kube-arangodb Helm chart.