Deploy the terraform-cloud helm chart on AWS EKS

Question

Pulumi · Accepted Answer

To deploy the Terraform Cloud Helm chart on an AWS EKS cluster using Pulumi, you will need to create an EKS cluster first and then use the Helm chart resource to deploy the chart onto that cluster.

Below is an explanation and a Pulumi TypeScript program that accomplishes this:

EKS Cluster: We'll use the eks.Cluster resource to provision a managed Kubernetes cluster on AWS EKS. You'll define the desired number of nodes, their type, and other settings.
Helm Chart: Once the cluster is up and operational, you'll use the kubernetes.helm.v3.Chart resource to deploy the Terraform Cloud Helm chart. Helm charts help package and deploy applications on Kubernetes clusters.

Make sure you have the Pulumi CLI installed and configured for use with your AWS account. Additionally, you'll need kubectl configured to communicate with your AWS EKS cluster and Helm 3 for working with Helm charts.

Here is the Pulumi TypeScript program that accomplishes the deployment:

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

// Create a VPC for our cluster.
import * as awsx from "@pulumi/awsx";
const vpc = new awsx.ec2.Vpc("my-vpc");

// Create an EKS cluster with the default configuration.
const cluster = new eks.Cluster("my-cluster", {
    vpcId: vpc.id,
    subnetIds: vpc.privateSubnetIds,
    instanceType: "t2.medium",
    desiredCapacity: 2,
    minSize: 1,
    maxSize: 2,
    storageClasses: "gp2", // This specifies the storage class as General Purpose SSD (gp2)
    deployDashboard: false, // Dashboard is not recommended in production environments
});

// Export the cluster's kubeconfig.
export const kubeconfig = cluster.kubeconfig;

// Create a Kubernetes provider instance that uses our EKS cluster from above.
const provider = new k8s.Provider("k8s-provider", {
    kubeconfig: cluster.kubeconfig.apply(JSON.stringify),
});

// Deploy the Terraform Cloud helm chart on the EKS cluster.
const terraformCloudChart = new k8s.helm.v3.Chart("terraform-cloud", {
    chart: "terraform-cloud",
    version: "<CHART VERSION>", // Specify the chart version you want to deploy.
    fetchOpts: {
        repo: "https://helm.releases.hashicorp.com", // URL of the Helm repository where the chart is stored.
    },
}, { provider });

// Export the cluster's name and the Helm chart details.
export const clusterName = cluster.eksCluster.name;
export const chartName = terraformCloudChart.metadata.apply(m => m.name);

Explanation of various components in this program:

@pulumi/eks: This Pulumi package is used to interact with the AWS EKS service. The eks.Cluster resource provisions a new Kubernetes cluster managed by AWS EKS.
@pulumi/awsx: This is an extension Pulumi package that simplifies working with AWS resources. The awsx.ec2.Vpc class creates a new Virtual Private Cloud (VPC) configured with a set of public and private subnets spread across two availability zones.
kubeconfig: This output variable makes the Kubernetes cluster configuration available outside of Pulumi, for instance, for use with kubectl.
@pulumi/kubernetes: Pulumi's core Kubernetes package, which allows us to communicate with the Kubernetes API.
k8s.Provider: This resource lets Pulumi know about the EKS cluster you've created, and how to communicate with it.
k8s.helm.v3.Chart: This represents a Helm chart that you want to deploy on your Kubernetes cluster. We're specifying the chart and version, as well as the Helm repository URL.

Make sure to replace <CHART VERSION> with the actual version of the Terraform Cloud Helm chart you want to deploy.

After you've set up this program, you can run it using the Pulumi CLI to deploy your EKS cluster and the Terraform Cloud Helm chart.

Please ensure to check for any prerequisites that the Terraform Cloud Helm chart may have before deployment, such as Helm chart values that need to be configured for your specific setup. These values can be passed to the values property of the Chart resource.