Deploy the envoy helm chart on AWS EKS

Question

Pulumi · Accepted Answer

Deploying an Envoy Helm chart on an Amazon EKS (Elastic Kubernetes Service) cluster involves several steps, including setting up the EKS cluster, deploying the Helm chart, and configuring other required AWS resources as necessary. Below, I'm providing you with a detailed Pulumi TypeScript program that will help you accomplish this.

1. **Create an EKS Cluster:** First, we need to set up an AWS EKS cluster, which is a managed Kubernetes service. The cluster is where our Kubernetes applications will run.

2. **Deploy the Envoy Helm Chart:** Once the cluster is provisioned, we'll deploy the Envoy proxy using its Helm chart. Helm is a package manager for Kubernetes, and Helm charts are prepackaged applications that can be deployed easily.

Here's a Pulumi program that performs these actions:

```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";

// Create an EKS cluster.
const cluster = new eks.Cluster("my-cluster", {
    // Specify the desired version of Kubernetes.
    version: "1.21",
    // Configure the nodes and their properties.
    instanceType: "t2.medium",
    desiredCapacity: 2,
    minSize: 1,
    maxSize: 3,
});

// Create a Kubernetes provider instance using the EKS cluster's kubeconfig.
const k8sProvider = new k8s.Provider("k8s-provider", {
    kubeconfig: cluster.kubeconfig,
});

// Deploy the Envoy Helm chart from the stable repository.
const envoyChart = new k8s.helm.v3.Chart("envoy", {
    chart: "envoy",
    version: "1.18.3", // Use the Envoy version that fits your needs.
    fetchOpts: {
        repo: "https://charts.envoyproxy.io",
    },
}, { provider: k8sProvider });

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

// Export the Helm chart resources.
export const helmChartResources = envoyChart.resources;
```

### Explanation:

- We create an EKS cluster using the `eks.Cluster` class ([EKS Cluster documentation](https://www.pulumi.com/registry/packages/eks/api-docs/cluster/)). Here we specify several options such as the desired Kubernetes version, instance type, and scaling options for node groups.

- After the cluster is up and running, we initialize a Kubernetes provider with the `kubeconfig` output from the EKS cluster. The provider will allow us to interact with the EKS cluster to deploy applications.

- Then, we deploy the Envoy Helm chart using the `k8s.helm.v3.Chart` class ([Helm Chart documentation](https://www.pulumi.com/registry/packages/kubernetes/api-docs/helm.sh/v3/chart/)). This resource points to the Envoy Helm chart repository and specifies the version of the chart to use.

- Finally, we export the `kubeconfig` so you can interact with your cluster using `kubectl` or other Kubernetes tools. We also export the Helm chart resources for reference.

Run this program with Pulumi CLI after having AWS account setup and Pulumi configuration done. Once the deployment finishes, you will have an Envoy proxy running in your EKS cluster. You can interact with your new EKS cluster using the outputted `kubeconfig`.