Deploy the dotstatsuite helm chart on Oracle Kubernetes Engine (OKE)

Question

Pulumi · Accepted Answer

To deploy the `dotstatsuite` Helm chart on Oracle Kubernetes Engine (OKE), you'll first need to set up an OKE cluster on Oracle Cloud Infrastructure (OCI). Once you have your Kubernetes cluster running, you can use Pulumi's `kubernetes` package to deploy applications with Helm charts.

The following Pulumi program in TypeScript illustrates how to perform these tasks. It assumes you have an OCI account set up and have configured your Pulumi environment with the necessary OCI credentials.

### Explanation of Resources:

- **oci.ContainerEngine.Cluster**: This resource is used to create a Kubernetes cluster in the Oracle Cloud Infrastructure Container Engine for Kubernetes (OKE).

- **kubernetes.helm.v3.Chart**: This resource is a Pulumi abstraction that allows us to deploy a Helm chart into our Kubernetes cluster.

### Prerequisite:

Before running the Pulumi program, you need to ensure you've installed Pulumi CLI and set up your OCI configuration with the appropriate credentials. This usually involves creating a service account in your OCI tenancy with the necessary permissions to create and manage Kubernetes clusters.

### Pulumi Program:

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

// Define the OCI provider configuration (assumes you have done `pulumi config set` for the necessary properties or have OCI CLI configured).
const provider = new oci.Provider("oci-provider", {
    // Your configuration like region, tenancyId, userId, fingerPrint, privateKeyPath goes here
});

// Create a new Oracle Kubernetes Engine cluster
const cluster = new oci.containerengine.Cluster("okeCluster", {
    name: "dotstatsuiteCluster",
    compartmentId: provider.compartmentId, // Make sure to replace with your compartment ID
    vcnId: "your-virtual-cloud-network-id", // Replace with your VCN ID
    kubernetesVersion: "v1.20.8", // Use a supported Kubernetes version
    options: {
        // Additional OKE configuration options if required
        // Refer to the documentation (https://www.pulumi.com/registry/packages/oci/api-docs/containerengine/cluster/) for supported options
    },
}, { provider: provider });

// Obtain the kubeconfig for the created cluster
const kubeconfig = pulumi.
    all([cluster.id, provider.region, provider.tenancyId, provider.userId, provider.privateKey]).
    apply(([clusterId, region, tenancyId, userId, privateKey]) => {
        // Logic to fetch or construct the kubeconfig for the OKE cluster
        // This may involve using OCI CLI utilities or APIs to obtain the kubeconfig content
        // You can store the generated kubeconfig content in a secret for added security
        return `Your Kubeconfig content here`;
    });

// Define the Kubernetes provider instance using the kubeconfig obtained from the OKE cluster
const k8sProvider = new k8s.Provider("okeK8s", {
    kubeconfig: kubeconfig,
});

// Deploy the dotstatsuite helm chart
const dotstatsuiteChart = new k8s.helm.v3.Chart("dotstatsuite", {
    chart: "dotstatsuite",
    // Replace 'repo_url' with the URL of the chart repository
    fetchOpts: {
        repo: "repo_url",
    },
    values: {
        // The values here would configure the dotstatsuite chart configurations like image settings, service type, etc.
        // Refer to the helm chart's 'values.yaml' to see what options you need to configure
    },
}, { provider: k8sProvider });

// Export the resulting application URL
export const dotstatsuiteUrl = pulumi.interpolate`http://your-dotstatsuite-service-url`; // Replace with how to access your dotstatsuite service
```

### Running the Pulumi Program:

To execute the program:

1. Save the above TypeScript code to a file named `index.ts`.
2. Run the following commands in your terminal:

```bash
pulumi stack init oke-dotstatsuite-deployment  # Initializes a new stack for your deployment
pulumi up                                      # Preview and deploy the changes
```

3. Pulumi will perform a dry-run and show you the resources that will be created. If everything looks good, select `yes` to proceed with the deployment.
4. After a successful deployment, Pulumi will output the `dotstatsuiteUrl` if you configured it to do so.

The program will create the necessary resources on OCI to run an OKE cluster and deploy the `dotstatsuite` Helm chart into that cluster. Adjust the configurations wherever necessary to match the specific details of your OCI setup and the Helm chart's requirements.