Deploy the datadog-apm helm chart on Azure Kubernetes Service (AKS)

Question

Pulumi · Accepted Answer

To deploy the Datadog APM helm chart on Azure Kubernetes Service (AKS), you will need to perform the following steps:

1. **Set Up AKS Cluster**: First, you need to set up an AKS cluster if you don’t have one already.
2. **Install Helm and Tiller**: Helm is a package manager for Kubernetes, which allows you to define, install, and upgrade even the most complex Kubernetes applications. Tiller is the Helm server side that runs inside your Kubernetes cluster.
3. **Add Datadog Helm Repository**: You will need to add the official Datadog helm repository to your helm client.
4. **Deploy the Datadog APM Chart**: With Helm configured, you can deploy the helm chart into your AKS cluster.

Below is a TypeScript program using Pulumi to create an Azure Kubernetes Service cluster, add the Datadog helm chart, and deploy it. The program uses the Pulumi Azure and Kubernetes packages.

Make sure you have Pulumi and Node.js installed, and you have authenticated with Azure and configured the Pulumi Azure provider.

### Detailed Program

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

// Step 1: Create an AKS cluster
const resourceGroup = new azure.core.ResourceGroup("resourceGroup", {
    location: "WestUS",
});

const aksCluster = new azure.containerservice.KubernetesCluster("aksCluster", {
    // It's advisable to specify the desired Kubernetes version
    kubernetesVersion: "1.21.9",
    dnsPrefix: "aksDatadog",
    resourceGroupName: resourceGroup.name,
    defaultNodePool: {
        name: "default",
        nodeCount: 2,
        vmSize: "Standard_DS2_v2",
    },
    identity: {
        type: "SystemAssigned",
    },
});

// Export the KubeConfig
export const kubeconfig = aksCluster.kubeConfigRaw;

// Step 2: Use the KubeConfig to configure the Kubernetes provider
const k8sProvider = new k8s.Provider("k8sProvider", {
    kubeconfig: aksCluster.kubeConfigRaw,
});

// Step 3: Add Datadog Helm repository
const datadogRepo = new k8s.helm.v3.Repository("datadogRepo", {
    name: "datadog",
    // Datadog's Helm Chart repository
    url: "https://helm.datadoghq.com",
}, { provider: k8sProvider });

// Step 4: Deploy the Datadog APM chart using the Helm Chart resource
const datadogChart = new k8s.helm.v3.Chart("datadog-apm", {
    chart: "datadog",
    version: "2.6.5", // Please specify the appropriate chart version
    fetchOpts: {
        repo: datadogRepo.url,
    },
    values: {
        datadog: {
            // You will need to enter your Datadog API Key here
            apiKey: "{DATADOG_API_KEY}",
            appKey: "{DATADOG_APP_KEY}",
            // Enable the APM
            apm: {
                enabled: true,
            },
        },
    },
}, { provider: k8sProvider });

// It's good practice to export any useful information
export const datadogApmChartName = datadogChart.name;
```

### Explaining the Resources:

- `azure.core.ResourceGroup`: We're creating a resource group in Azure to organize all our resources.
- `azure.containerservice.KubernetesCluster`: This will create a new managed Kubernetes cluster in Azure using AKS.
- `k8s.Provider`: Configures Pulumi to use the generated KubeConfig for our newly created AKS cluster.
- `k8s.helm.v3.Repository`: This creates a reference in Helm to the official Datadog repository where the chart is located.
- `k8s.helm.v3.Chart`: This resource uses Helm to deploy the Datadog chart into our AKS cluster.

Remember to replace `{DATADOG_API_KEY}` and `{DATADOG_APP_KEY}` with your Datadog API and App keys, respectively.

To run this program, execute the following commands in your terminal:
1. Create a new directory and navigate into it.
2. Run `pulumi new typescript` to create a new Pulumi project in TypeScript.
3. Replace the contents of `index.ts` with the above program.
4. Run `npm install @pulumi/azure @pulumi/kubernetes` to install the necessary packages.
5. Run `pulumi up` to create the resources and deploy the Datadog APM chart to your AKS cluster.

By running the `pulumi up` command, it will set up all resources and return outputs defined by the export statements.

Please make sure to replace the placeholders with actual values and ensure you have the appropriate permissions set up to run these operations in your Azure environment.