Deploy the castlemock helm chart on AWS EKS

Question

Pulumi · Accepted Answer

To deploy the CastleMock Helm chart on AWS EKS, we'll go through the process step by step. First, we will set up an EKS cluster using Pulumi's EKS package. Next, we will deploy the CastleMock Helm chart into our cluster. CastleMock is a tool for mocking out RESTful APIs and SOAP web services. This solution provides you with a simple way of creating and managing an instance of CastleMock in a Kubernetes cluster.

### Step 1: Set up the AWS EKS cluster

We'll start by creating an Amazon EKS cluster. EKS is a managed Kubernetes service that makes it easier to run Kubernetes on AWS without needing to install and operate your own Kubernetes control plane. We'll also need an IAM role for EKS and a VPC with the proper configuration for our EKS cluster.

We'll be using the `eks.Cluster` resource from Pulumi's EKS package, which is a high-level component that abstracts away much of the complexity of setting up an EKS cluster.

### Step 2: Deploy the CastleMock Helm chart

Once the EKS cluster is up and running, we'll deploy applications using Helm charts, which are collections of pre-configured Kubernetes resources. Pulumi's `kubernetes.helm.v3.Chart` resource allows us to deploy charts into a Kubernetes cluster.

Below is the TypeScript program that accomplishes this task:

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

// Create a VPC for our cluster.
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.publicSubnetIds,
});

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

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

// Deploy the CastleMock Helm chart into the cluster we created.
const castleMockChart = new k8s.helm.v3.Chart("castlemock", {
    chart: "castlemock",
    version: "1.0", // Replace with the version of the chart you want to deploy
    fetchOpts: {
        repo: "https://repository-url/", // Replace with the Helm repository URL that contains CastleMock
    },
}, { provider });

// Export the URL for the deployed CastleMock instance
export const castlemockUrl = pulumi.interpolate`http://${vpc.publicSubnets[0].subnet.id}.elb.amazonaws.com`;

```

### Explanation:

The above program does the following:

1. **VPC Creation**: Creates a new VPC for our EKS cluster to reside in.

2. **EKS Cluster Creation**: Using Pulumi's EKS package, we instantiate an EKS cluster named 'my-cluster'.

3. **Kubeconfig Export**: We export the kubeconfig of the cluster, which is necessary for our local kubectl to communicate with the cluster.

4. **Kubernetes Provider Setup**: Establish a Pulumi Kubernetes provider to interact with our EKS cluster. This provider uses the kubeconfig output from our EKS cluster.

5. **Helm Chart Deployment**: Deploy the CastleMock application using Helm by creating an instance of the `Chart` resource.

6. **Access URL Export**: Finally, we export a URL (assuming that the Helm chart creates a LoadBalancer service) where the CastleMock can be accessed.

Please replace the `version` and `repo` with the appropriate version number and Helm repository URL where the CastleMock chart is located.

To deploy this Pulumi program:

1. Make sure you have Pulumi CLI installed.
2. Set up your AWS credentials.
3. Run `pulumi up` to create the resources on AWS.

This program will deploy a CastleMock instance in the EKS cluster that can be accessed through an autogenerated URL once the LoadBalancer is provisioned.