Deploy the keycloak-setup helm chart on Oracle Kubernetes Engine (OKE)

Question

Pulumi · Accepted Answer

To deploy the Keycloak setup Helm chart on Oracle Kubernetes Engine (OKE) using Pulumi, we'll need to complete a series of steps. We'll first set up the Kubernetes provider to interact with the OKE cluster. Then we will use Helm to deploy Keycloak onto that cluster.

You'll need to have your Oracle Cloud Infrastructure (OCI) credentials configured for interacting with OKE. Specifically, you'll have to have the ~/.kube/config file set up, so that kubectl and thus Pulumi can interact with your Kubernetes cluster.

Below is a Pulumi program written in TypeScript that achieves this. It assumes you have already created an OKE cluster and are ready to deploy the chart to it.

import * as k8s from "@pulumi/kubernetes";

// Create a Kubernetes provider instance that uses our existing cluster configuration
const provider = new k8s.Provider("oke-provider", {
    kubeconfig: <your_kubeconfig_here>, // You can directly pass in your kubeconfig file contents here
});

// Define the Keycloak helm chart from the stable repository
const keycloakChart = new k8s.helm.v3.Chart("keycloak-setup", {
    chart: "keycloak",
    version: "<chart_version_here>", // Specify the version of the chart you wish to deploy
    // For example version: "9.8.1"
    fetchOpts:{
        repo: "https://bitnami.com/bitnami",
    },
    // Values from the default chart are used by not specifying a `values` argument. If you need to override these,
    // specify them as an object below (commented out for this example).
    // values: {
    //   keycloak: {
    //     replicaCount: 2,
    //     service: {
    //       type: "LoadBalancer",
    //       port: 8080,
    //     },
    //     // ... more overrides here as needed
    //   },
    //},
}, { provider: provider });

// Optionally, you can export the chart status for easy access later
export const keycloakStatus = keycloakChart.status;

In this program, we:

Import the K8s package from Pulumi's Kubernetes SDK which allows us to define Kubernetes resources.
Instantiate a Kubernetes provider (oke-provider) to manage the lifecycle of Kubernetes resources within an existing OKE cluster. The kubeconfig should be replaced with the contents of your OKE cluster's kubeconfig file or be passed as a configuration parameter.
Define the keycloakChart using Pulumi's Helm Chart resource which declares a Helm chart to install. The chart property specifies the name of the chart ("keycloak"), and you should specify the version you wish to use. The fetchOpts.repo property points to the Bitnami Helm chart repository where the Keycloak chart is located.
The values object in the chart definition can be used to override default configurations. It's shown here as commented-out since it will depend on your specific needs. You should place your configuration overrides in this section.
Optionally, the status of the Helm chart deployment is exported so you can easily query its state using Pulumi's command line interface (CLI).

Before running pulumi up, replace the placeholders <your_kubeconfig_here> and `<chart_version