Deploy the grafana-stakewise-dashboards helm chart on AWS EKS

Question

Pulumi · Accepted Answer

In order to deploy the Grafana Stackwise dashboards Helm chart on AWS EKS using Pulumi, first, you'll need an existing Amazon EKS cluster. The process includes creating an EKS cluster and then using the Helm chart to deploy Grafana onto that cluster.

Below is an explanation followed by a Pulumi program written in TypeScript that demonstrates how to accomplish this:

Setting up the EKS Cluster:
- Use the aws.eks.Cluster resource to provision a managed Kubernetes cluster in AWS EKS.
- Ensure the cluster has associated IAM roles and VPC configuration required for EKS.
Deploying the Helm Chart:
- Utilize the kubernetes.helm.v3.Chart resource which allows you to deploy Helm charts.
- As an input, you will need to specify the details of the Helm chart such as the name, version, and any configuration values specific to the chart.
Prerequisites:
- Make sure you have AWS credentials configured for your environment.
- Install Pulumi CLI and set up the TypeScript programming environment.
- Have kubectl installed and configured to interact with the Kubernetes cluster.

Below is the Pulumi TypeScript program that defines the deployment:

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

// Create an EKS cluster.
const eksCluster = new aws.eks.Cluster("my-cluster", {
    roleArn: "<ARN of EKS IAM role>", // Replace with the ARN of your IAM role
    vpcConfig: {
        subnetIds: ["<Subnet ID 1>", "<Subnet ID 2>"], // Replace with your VPC subnet IDs
    },
});

// Create a kubeconfig for the EKS cluster.
// This is needed to communicate with the cluster once it is up and running.
export const kubeconfig = pulumi.
    all([eksCluster.name, eksCluster.endpoint, eksCluster.certificateAuthority, eksCluster.roleArn])
    .apply(([name, endpoint, ca, roleArn]) => {
        return `apiVersion: v1
clusters:
- cluster:
    server: ${endpoint}
    certificate-authority-data: ${ca.data}
  name: ${name}
contexts:
- context:
    cluster: ${name}
    user: ${name}
  name: ${name}
current-context: ${name}
kind: Config
preferences: {}
users:
- name: ${name}
  user:
    exec:
      apiVersion: client.authentication.k8s.io/v1alpha1
      command: aws
      args:
        - "eks"
        - "get-token"
        - "--cluster-name"
        - "${name}"
      # You'll need to ensure your role has appropriate
      # rights for the token command to work.
      env:
        - name: AWS_ROLE_ARN
          value: "${roleArn}"
`;
    });

// Import the Kubernetes provider package.
import * as k8s from "@pulumi/kubernetes";

// Now, we deploy a Helm chart for Grafana Stackwise dashboards.
const grafanaChart = new k8s.helm.v3.Chart("grafana-stackwise", {
    chart: "grafana-stakewise-dashboards",
    // Ensure you have the correct repository for your Helm chart.
    // This is a placeholder repository.
    fetchOpts: { repo: "https://charts.example.com/" },
    // The version of the chart should be provided.
    // If not specified, the latest version will be installed.
    version: "1.0.0",
}, { provider: new k8s.Provider("k8s-provider", { kubeconfig }) });

// Export the URL to access the Grafana dashboard
export const grafanaUrl = eksCluster.endpoint.apply(endpoint => `http://${endpoint}:3000`);

This program creates an Amazon EKS cluster and deploys the Grafana Stackwise dashboards using a Helm chart. Remember to replace placeholder values such as <ARN of EKS IAM role>, <Subnet ID 1>, <Subnet ID 2>, and the Helm repository URL with actual values relevant to your AWS and Helm chart configurations.

To run this Pulumi program, save the code in a file named index.ts, and from your terminal in the same directory, run pulumi up. The program will provision resources in your AWS account and output the kubeconfig needed to manage the EKS cluster, as well as the URL to access the Grafana dashboard.