Deploy the stablesats helm chart on AWS EKS

Question

Pulumi · Accepted Answer

To deploy the `stablesats` helm chart on an AWS EKS (Elastic Kubernetes Service) cluster, we will follow these steps:

1. Create an EKS cluster using Pulumi's `eks` package, which provides a high-level approach to create and manage an EKS cluster with sensible defaults.
2. Deploy the helm chart to the newly created EKS cluster using `helm.sh/v3.Chart` resource from the `kubernetes` package. This resource allows us to use Helm to deploy our application.

Below is a detailed TypeScript program that accomplishes these steps.

First, ensure you have imported the necessary Pulumi packages in your project:

```bash
npm install @pulumi/eks @pulumi/kubernetes
```

Now, let's walk through the Pulumi program:

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

// Step 1: Create an AWS EKS cluster.
// The eks.Cluster class provisions an EKS cluster with default configurations that
// should work for most use cases. For example, it creates a VPC with public and private subnets
// that the EKS cluster will use.
const cluster = new eks.Cluster("my-eks-cluster", {
    desiredCapacity: 2, // desired number of EC2 instances for the cluster
    minSize: 1, // the minimum number of EC2 instances in the cluster
    maxSize: 2, // the maximum number of EC2 instances in the cluster
    storageClasses: "gp2", // type of storage class
    deployDashboard: false, // do not deploy the Kubernetes Dashboard
});

// Step 2: Use a StackReference to fetch the kubeconfig from the cluster stack,
// which we need to communicate with the cluster.
const kubeconfig = pulumi.output(cluster.kubeconfig);

// Step 3: Deploy the 'stablesats' helm chart to the EKS cluster.
// We create a Chart resource and pass the kubeconfig we got from the EKS cluster
// to the provider argument. We assume 'stablesats' chart is available in a Helm repo.
const chart = new k8s.helm.v3.Chart("stablesats-chart", {
    chart: "stablesats",
    // Specify the namespace where Helm will install the "stablesats" resources, or
    // remove this line if you want it installed in the default namespace.
    namespace: "my-namespace",
    // You can specify the Helm chart version to use, if there is a specific one you need;
    // otherwise, Helm will use the latest version by default.
    // version: "1.2.3",
    // You could pass custom values to overwrite values in the Helm chart, for example:
    // values: { /* ... */ },
}, { provider: new k8s.Provider("k8s-provider", { kubeconfig }) });

// Export cluster's kubeconfig and name of the chart.
export const kubeconfigOutput = kubeconfig;
export const chartName = chart.name;
```

Please note the following:
- To use this code, you will need to have configured Pulumi with AWS credentials and have the necessary IAM permissions to create an EKS cluster.
- You'll need to replace `"stablesats"` with the correct Helm chart name if it differs or specify additional repository configuration if the chart is not in the public Helm repository.

In the program above, a new EKS cluster is instantiated with name "my-eks-cluster." For the purposes of this demonstration, we've defaulted to a small cluster size suitable for light testing, but in a production environment, you may need to adjust the `desiredCapacity`, `minSize`, and `maxSize` parameters to suit your load requirements.

Then, using the `kubeconfig` generated by the EKS cluster resource, we create an instance of the Helm chart by creating a `k8s.helm.v3.Chart` resource. This Helm chart resource references the `stablesats` chart, which should be accessible via a Helm repository or some other means. You might need to adjust parameters such as the `namespace`, `chart` version, and `values` input to match your specific deployment requirements.

The chart name is exported so you can easily identify the Helm deployment within your Kubernetes cluster, and the kubeconfig is exported so you can interact with your EKS cluster using `kubectl` or other Kubernetes tools.