Deploy the keycloak-umbrella helm chart on AWS EKS

Question

Pulumi · Accepted Answer

To deploy the keycloak-umbrella helm chart on AWS EKS using Pulumi, you'll need to follow these steps:

1. Set up the EKS Cluster: You will use the `eks.Cluster` class to create a new EKS cluster. This cluster will form the underlying network infrastructure for your Kubernetes applications.

2. Deploy the Helm Chart: To deploy the keycloak-umbrella Helm chart, which is presumably a package containing the keycloak application configured for Kubernetes, you will use the `kubernetes.helm.v3.Chart` class.

Here's a comprehensive example that will guide you through this process. For this example, I'll be using Pulumi's TypeScript language. Make sure that you have Pulumi CLI installed and configured for use with AWS.

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

// Step 1: Create an EKS cluster where Keycloak will be deployed.
const cluster = new eks.Cluster("my-cluster", {
    // Specify the desired capacity of the node group if needed
    desiredCapacity: 2,
    minSize: 1, // Minimum size of the cluster
    maxSize: 3, // Maximum size of the cluster
    storageClasses: "gp2", // Type of storage
});

// Step 2: Deploy the keycloak-umbrella Helm chart.
// The Helm chart should be publicly available or stored in a repository
// that your AWS account has access to.
const keycloak = new k8s.helm.v3.Chart("keycloak", {
    namespace: "default", // Namespace where you want to install your chart
    chart: "keycloak-umbrella", // Chart name
    // If your chart is in a Helm repository, specify the 'repo' option
    version: "x.y.z", // Use the version that suits your needs
    fetchOpts: {
        // Include fetch options if necessary, such as the Helm repo URL.
    },
    // Pass necessary values that the chart requires via `values`.
    values: {
        keycloak: {
            // Custom values for Keycloak deployment
        }
    },
}, { provider: cluster.provider });

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

Let's break down what each part of this example does:

- We import the necessary Pulumi libraries for working with EKS and Kubernetes.
- The `eks.Cluster` object, `my-cluster`, is created with a certain number of nodes. The `desiredCapacity`, `minSize`, and `maxSize` parameters control the scaling behavior of your EKS cluster.
- A new Helm `Chart` object, `keycloak`, is created, which represents the keycloak-umbrella helm chart. This chart is installed in the `default` namespace of the Kubernetes cluster. You would add the chart repository URL, the version number, and any other fetch options as needed. Additionally, you can customize the deployment by passing values to the `values` parameter, specifically tailored for the keycloak deployment.

To deploy this program with Pulumi, place the code in a file with the `.ts` extension, like `index.ts`, inside a Pulumi project and run `pulumi up`. This command will start the deployment based on your code, and show you a preview of the resources that will be created.

Remember to replace placeholders (like `x.y.z` for the version and additional values passed to the `values` parameter based on your configuration requirements) with the actual values that are applicable to your deployment.

Once the deployment is successful, the EKS cluster kubeconfig will be exported, which you can use to interact with your cluster using `kubectl`. Ensure that you keep this information secure as it provides administrative access to your Kubernetes cluster.