Deploy the laravel-worker helm chart on Oracle Kubernetes Engine (OKE)

Question

Pulumi · Accepted Answer

To deploy the `laravel-worker` Helm chart on Oracle Kubernetes Engine (OKE), you will need to perform the following high-level steps:

1. **Setup the Oracle Kubernetes Engine Cluster**: Ensure you have an OKE cluster up and running. This can be done either through the OCI console, OCI CLI, or using the Pulumi OCI provider if you want to define your infrastructure as code.

2. **Get the Kubeconfig for your OKE Cluster**: You will need the kubeconfig file to interact with your Kubernetes cluster.

3. **Install the `laravel-worker` Helm Chart**: Using Pulumi's Kubernetes provider, you can deploy Helm charts to a Kubernetes cluster.

Below is a Pulumi program that uses the Kubernetes provider to deploy a Helm chart to an OKE cluster. The exact Helm chart for `laravel-worker` is not specified in the Pulumi Registry results, but you can generally use `kubernetes.helm.v3.Chart` resource to install any Helm chart. Replace `"laravel-worker"` with the actual Helm chart name if it's different, and ensure you have the correct repository URL specified in the `repo` property.

Before running the code, ensure you've installed the Pulumi CLI and have logged in. Set up the OCI (Oracle Cloud Infrastructure) provider credentials through the OCI CLI which Pulumi will use.

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

// Replace these variables with actual values from your OKE cluster and Helm chart details
const clusterName = "my-oke-cluster";
const kubeconfig = "path-to-your-kubeconfig-file"; // Path to the kubeconfig file
const laravelWorkerChart = "laravel-worker"; // This might need to be replaced with the actual chart name
const laravelWorkerRepo = "https://charts.yourrepository.com/"; // Replace with the actual Helm chart repository

// Create a Kubernetes provider instance using the kubeconfig from OKE
const clusterProvider = new k8s.Provider(clusterName, {
    kubeconfig: kubeconfig,
});

// Deploy the laravel-worker Helm chart
const laravelWorkerRelease = new k8s.helm.v3.Chart("laravel-worker-release", {
    chart: laravelWorkerChart,
    version: "your-chart-version", // Specify the chart version
    repositoryOpts: {
        repo: laravelWorkerRepo,
    },
    // If your chart requires custom values, you can specify them as an object:
    values: {
        // Customize laravel-worker values here
        image: {
            repository: "your-image-repository", // Replace with the Docker image for the laravel-worker
            tag: "your-image-tag", // Replace with the Docker image tag
        },
        // Add other custom values that your Helm chart accepts
    },
}, { provider: clusterProvider });

// Export the URL for the deployed laravel-worker application
// This assumes that your Helm chart creates a service of type LoadBalancer.
// You might need to adapt the code below based on your Helm chart's output.
export const laravelWorkerUrl = pulumi.interpolate`http://${laravelWorkerRelease.getResourceProperty(
  "v1/Service",
  "laravel-worker-release-laravel-worker", // Replace with the actual name of the Service resource
  "status"
).apply(status => status.loadBalancer.ingress[0].ip)}`;

```

Explanation:
- **OCI Provider**: The usual way to interact with Oracle Cloud Infrastructure services using Pulumi is via the OCI provider. However, for deploying Helm charts to a Kubernetes cluster, we don't interact with OCI services directly. Instead, we use the `kubeconfig` directly with the Kubernetes provider.

- **Kubernetes Provider**: We define a `clusterProvider` which represents the Oracle Kubernetes Engine cluster. It uses `kubeconfig` which includes the necessary cluster access configuration. By setting this up, Pulumi knows where to deploy resources.

- **Helm Chart Resource**: The `kubernetes.helm.v3.Chart` resource is used to install helm charts. This resource abstracts away `helm` CLI commands into a declarative format. Its properties are equivalent to the flags and options that helm CLI accepts (e.g. `--set` command-line flag for value overrides).

- **Custom Values**: Helm charts usually support setting custom values. These are provided to `kubernetes.helm.v3.Chart` using the `values` property.

- **Exporting Output**: Assuming the `laravel-worker` Helm chart creates a Kubernetes Service of type `LoadBalancer`, we can get the external IP address by querying the service's status. The `laravelWorkerUrl` makes this IP address easily accessible after deployment.

To run this code, save it to a file (e.g., `index.ts`), navigate to the directory containing the file, and run `pulumi up`. Pulumi CLI will then execute the program, and you will see the output of the deployment process, including the exported URL for `laravel-worker`.