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

Question

Pulumi · Accepted Answer

To deploy the PipeCD Helm chart on Oracle Kubernetes Engine (OKE), you'll need to follow these steps:

Set up OKE: You need an OKE cluster running to deploy any applications on it. You can either use the existing one or create a new OKE cluster using Pulumi. Make sure you have all the necessary OCI credentials and access to manage resources within your compartment.
Get the Helm Chart: PipeCD Helm chart should be available from its official charts repository or its GitHub repository. You'll need to add the repository to your Helm client and update the Helm repo to fetch the latest charts.
Customize the Helm Chart Values: Based on your requirement, you should configure PipeCD by overriding its default values using a custom values.yaml file or by setting values within your Pulumi program.
Deploy with Pulumi: Utilize the kubernetes.helm.v3.Chart resource within Pulumi to deploy the PipeCD Helm chart to your OKE cluster.

Below is a detailed Pulumi TypeScript program that illustrates these steps:

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

// Step 1: Ensure that the required OKE cluster is already created and running.
// This example assumes you have set up the OKE cluster and kubeconfig appropriately.
// For setting up OKE using Pulumi, refer to the documentation at:
// https://www.pulumi.com/registry/packages/oci/api-docs/containerengine/cluster/

// Fetch the Kubeconfig for the OKE cluster. This could be a retrieved output from your OKE cluster stack
// or simply using a predefined kubeconfig file.
const kubeconfig = "<Your OKE Cluster Kubeconfig Here>";

// Create a Kubernetes provider instance using the kubeconfig.
const k8sProvider = new k8s.Provider("oke-k8s", {
    kubeconfig: kubeconfig,
});

// Step 2: Add the PipeCD Helm Chart and update the Helm repository.
const pipecdHelmRepo = "https://pipecd.github.io/helm-charts";

// Use the Helm Release resource to deploy PipeCD.
const pipecd = new k8s.helm.v3.Chart("pipecd", {
    chart: "pipecd",
    version: "<chart-version>",  // specify the version of PipeCD chart you want to deploy
    repositoryOpts: {
        repo: pipecdHelmRepo,
    },
    values: {  // specify your custom values here
        // e.g., to override the replicaCount
        // replicaCount: 2,
    },
}, { provider: k8sProvider });

// Export the URL or any other relevant output for your PipeCD deployment.
// If PipeCD provides a web interface, you might get an output similar to the below:
export const pipecdUrl = pipecd.getStatus("lb").apply(status => status.loadBalancer.ingress[0].ip);

This program sets up the Pulumi Kubernetes provider to interact with your OKE cluster and deploy the PipeCD Helm chart using the kubernetes.helm.v3.Chart resource which you can use to deploy Helm charts.

OCI Kubernetes Cluster: The kubeconfig variable should be set to the kubeconfig contents of your Oracle Kubernetes Engine cluster. If you're managing the OKE cluster within the same Pulumi program, you would retrieve this from the cluster resource's output.
OCI Helm Chart: The kubernetes.helm.v3.Chart resource deploys the specified Helm chart. In this case, it's the PipeCD Helm chart.
Custom Values: You should update the values section with configurations specific to your deployment needs.

Ensure the kubeconfig is updated with your actual OKE cluster's kubeconfig data for this to work.

Once you apply this Pulumi program, it will orchestrate the deployment of PipeCD on your OKE cluster using the Helm chart and Kubernetes provider. The pipecdUrl export will give you the external IP address through which you can access PipeCD, assuming it exposes an external service.

Remember to replace <Your OKE Cluster Kubeconfig Here> with the actual kubeconfig content and <chart-version> with the version of the PipeCD Helm chart you wish to deploy.