Deploy the apache-knox-helm helm chart on AWS EKS

Question

Pulumi · Accepted Answer

To deploy the Apache Knox Helm chart on an AWS Elastic Kubernetes Service (EKS), you will need to perform the following high-level steps:

1. **Create an AWS EKS Cluster:** This will be the Kubernetes environment where your Helm chart will be deployed.
2. **Configure your local `kubectl` and Helm:** Your local machine will need to have `kubectl` configured to interact with your EKS cluster. You will also need Helm installed to manage the Chart deployment process.
3. **Deploy the Apache Knox Helm Chart:** Using Helm, you will deploy the Apache Knox Helm chart to your EKS cluster.

Below is a Pulumi TypeScript program that illustrates how to accomplish these steps using Pulumi's AWS and Kubernetes libraries:

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

// Step 1: Create an AWS EKS Cluster.
// This uses Pulumi's AWSX library to simplify the cluster creation.
// Documentation: https://www.pulumi.com/registry/packages/awsx/api-docs/eks/cluster/

const vpc = new awsx.ec2.Vpc("my-vpc", { numberOfAvailabilityZones: 2 });

const cluster = new awsx.eks.Cluster("my-cluster", {
    vpcId: vpc.id,
    publicSubnetIds: vpc.publicSubnetIds, // EKS requires at least two subnets in different AZs.
    desiredCapacity: 2,                    // Determines the number of EC2 instances for your cluster.
    minSize: 1,
    maxSize: 3,
    deployDashboard: false,                // AWS recommends not to deploy the Kubernetes dashboard.
});

// Export the cluster's kubeconfig for our `kubectl` and Helm commands.
export const kubeconfig = cluster.kubeconfig;

// Step 2: Configure Helm provider with the created cluster's kubeconfig.
// This allows Pulumi to deploy Helm charts to the EKS cluster.
// Documentation: https://www.pulumi.com/registry/packages/kubernetes/api-docs/helm/

const k8sProvider = new k8s.Provider("k8s-provider", {
    kubeconfig: kubeconfig.apply(JSON.stringify),
});

// Step 3: Deploy the Apache Knox Helm Chart.
// Helm chart deployment makes use of Pulumi's Kubernetes provider.
// The Helm release will be created within the EKS cluster.

const apacheKnoxChart = new k8s.helm.v3.Chart("apache-knox-helm-chart", {
    chart: "knox",                     // The name of the chart, assuming 'knox' is the chart name.
    version: "1.2.0",                  // The version of the chart.
    fetchOpts: {repo: "http://helm-repository/url/where/chart/is/located"}, // Replace with the actual Helm chart repo URL.
}, { provider: k8sProvider });

// Export Helm chart status and other details as needed.
export const chartStatus = apacheKnoxChart.status;

```

In this program:

- We create a VPC and an EKS cluster using `awsx` — Pulumi's higher-level AWS library designed to simplify resource creation.
- We establish a Kubernetes provider configured to communicate with the created EKS cluster.
- We deploy the Apache Knox Helm chart using Pulumi's Helm support.

After applying this Pulumi code (`pulumi up`), it will provision an EKS cluster and deploy the Helm chart. You need to replace `"http://helm-repository/url/where/chart/is/located"` with the actual Helm chart repository URL for Apache Knox.

Make sure you have AWS access configured, and Pulumi CLI and Helm installed on your local machine. The AWS credentials need the necessary permissions to create EKS clusters and related resources.

The program will output the `kubeconfig` needed to interact with the EKS cluster via `kubectl` and the status of the deployed Helm chart so you can ensure it's running as expected.