Deploy the cloudflare helm chart on AWS EKS

Question

Pulumi · Accepted Answer

To deploy the Cloudflare Helm chart on AWS Elastic Kubernetes Service (EKS), we need to accomplish a few tasks:

1. **Create an EKS Cluster**: We need an EKS cluster where our Kubernetes workloads will run. We’ll use the `eks.Cluster` resource from the `eks` package, which provides a high-level abstraction over EKS clusters, simplifying their creation and configuration.
2. **Install Helm on your local machine**: Helm is a package manager for Kubernetes, allowing you to define, install, and upgrade Kubernetes applications. Cloudflare’s Helm chart will be distributed in a Helm package.
3. **Set up Helm on EKS**: Use the `kubernetes.helm.v3.Chart` resource from the `kubernetes` provider to deploy Cloudflare’s Helm chart to the EKS cluster.

Here is an illustrative Pulumi program that demonstrates how to create an EKS cluster and deploy the Cloudflare Helm chart:

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

// Create an EKS cluster.
const cluster = new eks.Cluster("my-cluster", {
    desiredCapacity: 2,
    minSize: 1,
    maxSize: 3,
    storageClasses: "gp2",
    deployDashboard: false,
});

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

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

// Deploy the Cloudflare Helm chart to the EKS cluster.
const cloudflareChart = new k8s.helm.v3.Chart("cloudflare", {
    chart: "cloudflare",
    version: "1.2.3", // Replace with the desired version of the Cloudflare Helm chart.
    // Values from the Cloudflare Helm chart documentation can be placed here.
    values: {
        // ... Specify your Cloudflare chart values here.
    },
}, { provider: k8sProvider });

// Documentation references:
// EKS cluster: https://www.pulumi.com/registry/packages/eks/api-docs/cluster/
// Kubernetes Provider: https://www.pulumi.com/registry/packages/kubernetes/api-docs/provider/
// Helm Chart: https://www.pulumi.com/registry/packages/kubernetes/api-docs/helm.sh/v3/chart/

// Make sure to replace "1.2.3" with the correct version of the Cloudflare Helm chart you wish to deploy.
// The `values` field should include any custom values you want to provide to the Cloudflare Helm chart.
```

In this program, we first create an EKS cluster using Pulumi's EKS package. We specify the desired, minimum, and maximum number of nodes in the cluster, along with the storage class for persistent storage needs.

Once the cluster is created, we instantiate a Kubernetes provider using the kubeconfig of the EKS cluster. This provider is used to interact with the cluster and deploy resources, like our Cloudflare Helm chart.

Next, we use the Helm chart resource from the `@pulumi/kubernetes` package to deploy the Cloudflare Helm chart to our EKS cluster. You'd need to specify the chart name and version, along with any values you want to customize.

Remember to replace the placeholder version (`"1.2.3"`) with the actual version of the Cloudflare Helm chart you'd like to use. Additionally, you'd need to provide specific values for the chart in the `values` property depending on your Cloudflare configuration requirements.

To apply this Pulumi program:

1. Save the code to a file, such as `index.ts`.
2. Run `pulumi up` in the same directory as the file, which will create the resources on AWS and deploy the Cloudflare Helm chart to your cluster.

Make sure you have Pulumi installed, you are authenticated with AWS, and Helm is set up on your local machine before running the program.