Deploy the datadog-apm helm chart on Rancher

Question

Pulumi · Accepted Answer

To deploy the Datadog APM helm chart on a Rancher Kubernetes cluster, we will follow these steps:

Set up the Rancher Kubernetes cluster: Ensure you have a Rancher Kubernetes cluster provisioned and you are able to communicate with it using kubectl.
Install the Rancher2 Provider: We will use the Pulumi Rancher2 provider to interact with Rancher.
Add Catalog for Helm repository: We need to add the Datadog helm chart repository to the Rancher catalog.
Install the Datadog APM Helm Chart: Once the catalog is updated with the Datadog helm chart repository, we can proceed to deploy the Datadog APM helm chart to the cluster.

Below is a Pulumi program written in TypeScript that demonstrates each of these steps. Please make sure you have Pulumi and Rancher2 provider setup according to your environment. You also need to have access to a Rancher Kubernetes cluster and the necessary cloud credentials set up on your machine or environment where you are running Pulumi.

Here's how you can create a Pulumi TypeScript program to deploy the Datadog APM helm chart on Rancher:

import * as rancher2 from "@pulumi/rancher2";
import * as k8s from "@pulumi/kubernetes";

// Step 1: Ensure access to the Rancher Kubernetes cluster
// This assumes you have set up access to the Rancher Kubernetes cluster in your environment
// Please replace "rancher-cluster-id" with your actual Rancher Cluster ID
const clusterId = "rancher-cluster-id"; 

// Step 2: Add the Datadog Helm Chart Repository to the Rancher catalog
const datadogCatalog = new rancher2.CatalogV2("datadogCatalog", {
    clusterId: clusterId,
    name: "datadog",
    // URL of the Datadog helm chart repository
    url: "https://helm.datadoghq.com/",
    // Branch to be used, usually 'master' could be used or the default branch of the helm chart.
    gitBranch: "master",
});

// Step 3: Create a namespace for the Datadog helm chart deployment
const datadogNamespace = new k8s.core.v1.Namespace("datadog-ns", {
    metadata: {
        name: "datadog",
    },
}, { provider: new k8s.Provider("k8s-provider", { kubeconfig: rancherCluster.kubeConfig }) });

// Step 4: Deploy the Datadog Helm Chart
const datadogHelmChart = new k8s.helm.v3.Chart("datadog-apm", {
    chart: "datadog",
    version: "2.4.5", // replace with the actual version you wish to deploy
    namespace: datadogNamespace.metadata.name,
    fetchOpts:{
        repo: "https://helm.datadoghq.com/",
    },
    values: {
        // Your Datadog API Key, replace `<DATADOG_API_KEY>` with your actual key
        datadog: {
            apiKey: "<DATADOG_API_KEY>",
            apm: {
                enabled: true,
            },
        },
    },
}, { dependsOn: datadogCatalog, provider: new k8s.Provider("k8s-provider", { kubeconfig: rancherCluster.kubeConfig }) });

// Export the name of the namespace in which Datadog was deployed
export const datadogNamespaceName = datadogNamespace.metadata.name;

Explanation of resources used:

CatalogV2: Represents a Helm chart repository in Rancher. Here we are adding the official Datadog Helm chart repository so Rancher can fetch and list the Datadog charts.
Namespace: Kubernetes namespace where we will deploy the Datadog APM. Namespaces allow you to partition resources into logically named groups.
Chart: Represents a Helm chart deployment resource in Kubernetes. In this case, it's used to deploy the Datadog APM Helm chart.

Make sure to replace placeholders like rancher-cluster-id and <DATADOG_API_KEY> with actual values from your setup. The kubeConfig in the provider should be set to your Rancher cluster's kubeconfig to enable Pulumi to interact with the cluster.

The program will create a catalog entry for the Datadog helm chart, create a namespace, and deploy the Datadog APM helm chart to the Rancher Kubernetes cluster.

Note: If this is the first time you are using Pulumi, you will need to create a new Pulumi project and replace the above code block within the index.ts file of your Pulumi project. You can follow the Pulumi project setup instructions found in the Pulumi documentation.