Deploy the stackdriver-metrics-adapter helm chart on Linode Kubernetes Engine

Question

Pulumi · Accepted Answer

To deploy the `stackdriver-metrics-adapter` Helm chart on a Linode Kubernetes Engine (LKE) cluster using Pulumi, you'll need to follow these steps:

1. **Set up a Linode Kubernetes Cluster**: Before deploying any applications using Helm, you need a Kubernetes cluster. You can provision one on Linode using Pulumi's Linode provider.

2. **Install the `stackdriver-metrics-adapter` Helm Chart**: Helm charts are packages that contain all of the necessary resources to run an application, tool, or service inside a Kubernetes cluster. To manage Helm charts with Pulumi you can utilize the `@pulumi/kubernetes` library, more specifically the `helm.v3.Chart` resource.

Here's a detailed program written in TypeScript that demonstrates these steps:

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

// Step 1: Create a new Linode Kubernetes Engine (LKE) cluster
const cluster = new linode.LkeCluster("my-lke-cluster", {
    region: "us-central",
    k8sVersion: "1.20",
    label: "my-lke-cluster",
    tags: ["pulumi-demo"],
    pool: {
        count: 3,
        type: "g6-standard-2",
    },
});

// Step 2: Configure the Kubernetes provider to connect to the LKE cluster
const kubeconfig = cluster.kubeconfig.apply(JSON.stringify);
const k8sProvider = new kubernetes.Provider("k8s-provider", {
    kubeconfig: kubeconfig,
});

// Step 3: Deploy the stackdriver-metrics-adapter Helm chart
const stackdriverMetricsAdapterChart = new kubernetes.helm.v3.Chart(
    "stackdriver-metrics-adapter",
    {
        chart: "stackdriver-metrics-adapter",
        version: "TODO:SpecifyChartVersion", // Replace with the desired chart version
        fetchOpts: {
            repo: "TODO:SpecifyRepositoryUrl", // Replace with the repository URL where the chart is located
        },
        // Include any custom values for the Helm chart here
        values: {
            // For example, you might want to specify Stackdriver project ID:
            // stackdriverProjectID: "{YOUR_PROJECT_ID}",
        },
    },
    { provider: k8sProvider }
);

// Export the cluster's kubeconfig and the service endpoint of the stackdriver-metrics-adapter
export const kubeconfigOutput = kubeconfig;
export const stackdriverMetricsAdapterEndpoint = stackdriverMetricsAdapterChart.getResourceProperty(
    "v1/Service",
    "stackdriver-metrics-adapter",
    "status"
).apply(status => status.loadBalancer.ingress[0].ip);
```

Here's what each part of the program does:
- **Linode Kubernetes Cluster**: We create a new LKE cluster with the `linode.LkeCluster` resource. We specify the region, Kubernetes version, label, and configuration for the node pool (in this case, consisting of 3 nodes of the "g6-standard-2" type).

- **Kubernetes Provider Configuration**: Pulumi needs to know how to connect to the new Kubernetes cluster. The `.kubeconfig` generated by Linode is used to set up a `kubernetes.Provider`. This kubeconfig provides the necessary credentials to connect and manage the cluster.

- **Stackdriver Metrics Adapter Helm Chart**: We deploy the `stackdriver-metrics-adapter` Helm chart using Pulumi's `helm.v3.Chart` resource. You must replace the `version` and `repo` with the actual version and repository of the Stackdriver Metrics Adapter chart. You can also include custom values to configure the chart to your needs.

Lastly, we export the kubeconfig so you can interact with the Kubernetes cluster using tools like `kubectl`. We also export the IP address for the `stackdriver-metrics-adapter` service, assuming it's exposed via a LoadBalancer on your LKE cluster.

Remember to replace placeholders like `TODO:SpecifyChartVersion` and `TODO:SpecifyRepositoryUrl` with actual values before running the Pulumi program.

After you save this program as `index.ts`, you can run it using the Pulumi CLI:

```sh
pulumi up
```

This command will prompt you to confirm the actions before performing them. Once confirmed, Pulumi will carry out the necessary steps to provision your infrastructure and deploy the Helm chart as described in the program.