Deploy the castai-agent helm chart on Oracle Kubernetes Engine (OKE)

Question

Pulumi · Accepted Answer

Deploying the `castai-agent` Helm chart on Oracle Kubernetes Engine (OKE) using Pulumi involves several steps. I'll guide you through the process.

## Prerequisites

Before we begin, ensure the following prerequisites are met:
1. You have an Oracle Cloud Infrastructure (OCI) account with permission to manage Kubernetes clusters and container repositories.
2. The Pulumi CLI is installed and configured with the appropriate credentials for creating and managing resources on OCI.
3. You have the `kubectl` command-line tool installed and configured to interact with your Kubernetes cluster.
4. Helm CLI is installed on your work environment as we will use it to manage the Helm chart releases.

## Overview

We'll take the following actions:

1. Provision an OKE cluster using the `oci.ContainerEngine.Cluster` resource.
2. Deploy the `castai-agent` Helm chart to the OKE cluster using `kubernetes.helm.sh/v3.Chart` resource.

Each action translates to Pulumi code that creates the appropriate resources on OCI and Kubernetes.

## Pulumi Program

Let's examine a TypeScript Pulumi program to accomplish these tasks:

```typescript
import * as pulumi from "@pulumi/pulumi";
import * as kubernetes from "@pulumi/kubernetes";
import * as oci from "@pulumi/oci";

// Create an OKE cluster.
const okeCluster = new oci.containerengine.Cluster("okeCluster", {
    // Specify required properties such as compartmentId, vcnId, and others according to your OCI account setup.
    // It might include setting up node pools and VCN configurations.
    // ...
});

// The following step would usually be required, but we're going to skip it in this case:
// Set up a kubeconfig file that Pulumi can use to communicate with the new cluster.

// Deploy the castai-agent Helm chart.
const castaiAgentChart = new kubernetes.helm.v3.Chart("castai-agent", {
    chart: "castai-agent",
    // Specify the repository that contains the castai-agent chart, and the version if necessary.
    // It may look like this:
    // repo: "https://charts.cast.ai",
    version: "latest",   // Replace with the desired chart version
    namespace: "default",  // Specify the namespace where the chart should be installed.
    // Values can be customized depending on the chart's requirements.
    values: {
        // ... custom values for the castai-agent chart...
    },
}, { provider: new kubernetes.Provider("k8s-provider", { kubeconfig: okeCluster.kubeconfig }) });

// Export the cluster name and URL.
export const clusterName = okeCluster.name;
export const clusterEndpoint = okeCluster.endpoints.apply(e => e.publicEndpoint);

// You can use the clusterName and clusterEndpoint outputs to interact with your OKE cluster.
```

In this program, we define two resources:

1. `oci.containerengine.Cluster` - This resource sets up the underlying infrastructure for your OKE cluster. You need to provide the necessary parameters like `compartmentId` and `vcnId`. For details on these parameters, you can refer to the [OCI documentation for clusters](https://www.pulumi.com/registry/packages/oci/api-docs/containerengine/cluster/).

2. `kubernetes.helm.v3.Chart` - This resource is responsible for deploying Helm charts. Here, we're deploying the `castai-agent` chart from its Helm repository. You'll need to specify the version of the chart and if required, any custom value overrides for the Helm chart installation. For reference on the chart resource, check out the [Pulumi documentation for Helm.v3.Chart](https://www.pulumi.com/registry/packages/kubernetes/api-docs/helm.sh/v3/chart/).

After defining the resources, the program exports the cluster's name and the cluster's public endpoint URL, which you can use to interact with the OKE cluster through `kubectl` or the OCI console.

## Next Steps

After you run the Pulumi program, the OKE cluster and the `castai-agent` Helm chart will be deployed. You can monitor the chart deployment status using `kubectl get pods -n default` (or the specified namespace) and checking the status of the `castai-agent` pods.

Please replace placeholder comments and values with the actual configuration that suits your OCI environment and Helm chart requirements.

Remember that this code will provision real resources that might incur costs, and you should manage them accordingly within your OCI account.