Deploy the sloth helm chart on AWS EKS

Question

Pulumi · Accepted Answer

To deploy the Sloth Helm chart on an AWS EKS cluster, you will follow these steps:

1. **Set up an EKS cluster**: We will use the `eks.Cluster` from Pulumi's EKS package, a higher-level abstraction that simplifies EKS cluster creation. This resource will create an EKS cluster with default settings which include the necessary AWS roles and VPC configuration.

2. **Deploy the Sloth Helm chart**: After setting up the EKS cluster, we'll use the standard `helm.v3.Chart` resource from Pulumi's Kubernetes package to deploy Sloth. Helm charts are packages of pre-configured Kubernetes resources, and Sloth Helm chart is expected to be one such package that defines everything Sloth needs to run on Kubernetes.

Below is a detailed Pulumi program in TypeScript that accomplishes these steps. Note that this assumes that you have AWS credentials configured in your Pulumi environment, as well as `kubectl` and `helm` command-line tools installed if you are going to interact directly with your cluster outside of Pulumi.

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

// A new EKS cluster is created with the default configuration.
// Documentation: https://www.pulumi.com/docs/reference/pkg/eks/cluster/
const cluster = new eks.Cluster("my-sloth-cluster");

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

// Set up a Kubernetes provider instance using the above EKS cluster's kubeconfig.
const provider = new k8s.Provider("k8s-provider", {
    kubeconfig: cluster.kubeconfig.apply(JSON.stringify),
});

// Deploy Sloth Helm chart using the Kubernetes provider.
// The `repositoryOpts` and `chartOpts` need to be replaced by the actual Sloth Helm chart details.
// Assuming Sloth is available in a public Helm chart repository,
// otherwise you'd have to configure access to a private repository.
const slothHelmChart = new k8s.helm.v3.Chart("sloth-chart", {
    chart: "sloth", // Replace with the Sloth chart name if different
    version: "1.0.0", // Replace with the specific version you want to install
    fetchOpts:{
        repo: "http://example.com/sloth-helm-charts", // Replace with the actual Sloth Helm chart repository URL
    },
}, { provider });

// Export the name of the chart and the resources it includes (for clarity and debugging)
export const chartName = slothHelmChart.metadata.apply(m => m.name);
export const chartResources = slothHelmChart.getResource("v1/Service", "sloth-service");

```

Here is some information about the Pulumi resources used above:

- `eks.Cluster`: This resource creates and manages an AWS EKS cluster. In this case, we create a new cluster named "my-sloth-cluster". The creation includes all default configurations, which include the necessary AWS IAM roles and networking infrastructure required for an EKS cluster.

- `k8s.Provider`: This sets up a Kubernetes provider configured to use the kubeconfig from the created EKS cluster. This is essential for interacting with the cluster to deploy Kubernetes resources such as the Sloth Helm chart.

- `k8s.helm.v3.Chart`: This is a Pulumi resource that represents a Helm chart in a Kubernetes cluster. It's equivalent to running `helm install` from the command line. Pulumi will manage the Helm release as a resource in the Pulumi state, and any changes to the configuration will be updated within the cluster on subsequent Pulumi updates.

- `fetchOpts` parameter: This specifies the Helm chart repository details. Replace the `repo` with the URL of the Sloth Helm chart repository.

- `kubeconfig`: This output variable contains the kubeconfig file contents for the created EKS cluster. You need this to interact with your cluster through `kubectl`.

- `chartName` and `chartResources`: These are export statements to help you identify the chart and fetch service details after deployment.

You would run this Pulumi program with `pulumi up`, which will provision the resources in AWS and deploy the Sloth Helm chart into your EKS cluster. Make sure to replace placeholder values like the Helm repo URL with actual values matching the Sloth Helm chart that you have.