Deploy the nats-js-prom helm chart on AWS EKS

Question

Pulumi · Accepted Answer

To deploy the `nats-js-prom` Helm chart on AWS EKS, you need to follow these steps:

1. **Create an EKS Cluster**: EKS, or Amazon Elastic Kubernetes Service, 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.

2. **Deploy the Helm Chart**: Helm is a package manager for Kubernetes, making it easier to deploy applications. Helm charts are packages of pre-configured Kubernetes resources.

Here's how you can do this using Pulumi:

### Step 1: Setting up the EKS Cluster

We’ll start by creating an EKS cluster using the `awsx` library, which provides a higher-level interface and simplifies the process.

### Step 2: Deploying the Helm Chart

Once the cluster is set up, we’ll use Pulumi’s Kubernetes provider to deploy the `nats-js-prom` Helm chart into the cluster.

Let's dive into the code:

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

// Step 1: Create an EKS cluster
const cluster = new eks.Cluster('my-cluster', {
    // Specify the desired settings for the cluster, such as version, node size, etc.
    instanceType: 't2.medium',
    desiredCapacity: 2,
    minSize: 1,
    maxSize: 2,
    storageClasses: 'gp2',
    deployDashboard: false,
});

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

// Step 2: Deploy the Helm chart
// Create a Kubernetes provider instance that uses our EKS cluster from above.
const provider = new k8s.Provider('k8s-provider', {
    kubeconfig: cluster.kubeconfig,
});

// Deploy the nats-js-prom Helm chart using the Kubernetes provider.
const natsJsPromHelmChart = new k8s.helm.v3.Chart('nats-js-prom', {
    chart: 'nats-js-prom',  // The name of the chart, you may need the correct repository or chart version.
    namespace: 'default',    // Kubernetes namespace to deploy into, adjust if needed.
    values: {},              // Any values you want to override in the Helm chart.
}, { provider });

// Export the URL (if applicable) or any other outputs you may be interested in.
export const natsUrl = natsJsPromHelmChart.getResourceProperty('v1/Service', 'nats-js-prom', 'status').apply(status => status.loadBalancer.ingress[0].ip || status.loadBalancer.ingress[0].hostname);
```

- **EKS Cluster**: First, we set up the EKS cluster by defining parameters like instance types, the number of nodes, and other configurations. The `eks.Cluster` class takes care of provisioning all the necessary AWS resources as well as setting up the Kubernetes control plane.

- **Kubernetes Provider**: With the `kubeconfig` output from our EKS cluster, we instantiate a Pulumi Kubernetes provider. This provider is responsible for delivering our Helm chart to the correct Kubernetes cluster.

- **Deployment of Helm Chart**: We define a Helm chart resource. The chart value of `'nats-js-prom'` indicates the name of the chart you want to deploy. Make sure that you have added the appropriate Helm repository that contains the `nats-js-prom` chart, or specify the absolute path to the chart if it’s locally available.

- **Service URL**: After deployment, we'd typically want to know the endpoint to access our application. Assuming `nats-js-prom` creates a Kubernetes service of type `LoadBalancer`, we extract its IP or hostname to get our access URL.

Please ensure you've configured Pulumi with the appropriate AWS credentials and default region as EKS and associated resources will be provisioned there.

If the Helm chart requires specific values to be overridden, add them to the `values` object in the `natsJsPromHelmChart` instantiation. Check the documentation of the `nats-js-prom` Helm chart for the available configuration options.

To apply this Pulumi program:

1. Ensure you have Pulumi and AWS CLI installed and configured.
2. Create a new directory for your project and initialize a new Pulumi project.
3. Install the necessary Pulumi packages using `npm` or `yarn`.
4. Place the TypeScript code shown above into an `index.ts` file.
5. Run `pulumi up` to preview and deploy the changes.

Remember to replace `'nats-js-prom'` with the correct Helm chart name if it’s different, and verify that your Kubernetes and provider configurations are correct for your use case.