Deploy the nginx-example helm chart on Oracle Kubernetes Engine (OKE)

Question

Pulumi · Accepted Answer

To deploy the nginx-example Helm chart to an Oracle Kubernetes Engine cluster using Pulumi, you need to perform several steps:

1. Set up your Oracle Cloud Infrastructure (OCI) and local Pulumi environments to interact with OKE.
2. Initialize a Pulumi stack for your deployment.
3. Write the Pulumi program to define the required resources.
4. Deploy the stack using Pulumi CLI commands.

Before writing our Pulumi program, let's break down the steps:

- **Importing Pulumi OCI and Kubernetes packages**: These give us the necessary functions and types to work with OCI resources and to deploy Helm charts on Kubernetes.
  
- **Creating a Kubernetes cluster**: We will define a Pulumi resource representing the Oracle Container Engine for Kubernetes (OKE).

- **Deploying the Helm chart**: Once the cluster is set up, we will use the Pulumi Kubernetes provider to deploy the nginx-example Helm chart.

Let's start writing our Pulumi program:

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

// Provide your compartment ID and other details specific to your OCI setup
const compartmentId = "ocid1.compartment.oc1..xxxxxx";
const vcnId = "ocid1.vcn.oc1..xxxxxx"; // Your VCN ID where OKE should be provisioned
const publicKey = `ssh-rsa AAAAB3NzaC1y... your_public_ssh_key ...`;

// Step 1: Create an Oracle Kubernetes Engine (OKE) cluster
const cluster = new oci.ContainerEngine.Cluster("myOkeCluster", {
  compartmentId: compartmentId,
  kubernetesVersion: "v1.21.5", // Use a supported Kubernetes version for OKE
  name: "pulumi-oke-cluster",
  // Options property may include various settings such as node pools, network settings, etc.
  options: {
    serviceLbSubnetIds: [vcnId] // This is normally a list of subnet IDs
  },
  // ...you might need to specify additional properties for cluster configuration
});

// Step 2: Create a kubeconfig file to connect to the OKE cluster
const kubeconfig = pulumi.all([cluster.id, cluster.name]).apply(([id, name]) => {
  // Here we will call OCI APIs to fetch the kubeconfig file content for the cluster
  // The actual implementation will depend on the mechanism supported by the OCI package
});

// Step 3: Using the kubeconfig from Step 2, set up the Kubernetes provider
const provider = new k8s.Provider("okeK8sProvider", {
  kubeconfig: kubeconfig,
});

// Step 4: Deploy nginx-example Helm chart using the Kubernetes provider
const nginxChart = new k8s.helm.v3.Chart("nginx-example", {
  chart: "nginx", // The name of the chart
  version: "1.17.5", // The version of the nginx chart
  fetchOpts:{
    repo: "https://charts.helm.sh/stable", // The Helm chart repository containing the nginx chart
  },
}, { provider: provider });

// Export the Kubernetes cluster's name and the nginx service endpoint
export const clusterName = cluster.name;
export const nginxServiceEndpoint = nginxChart.getResourceProperty("v1/Service", "nginx-example-nginx", "status").apply(status => status.loadBalancer.ingress[0].ip);

```

In the above program, we start by importing the required Pulumi packages. We then create an instance of OKE cluster. You'll need to replace placeholders like `compartmentId`, `vcnId`, and `publicKey` with actual values from your OCI.

Note that the `options` property in the `oci.ContainerEngine.Cluster` resource might require more detailed configuration depending on your specific networking and node pool requirements.

We then define a provider using the kubeconfig generated by the OKE cluster, which allows us to interact with the Kubernetes cluster.

With the Kubernetes provider set up, we then define a `Chart` resource to deploy nginx. Make sure you specify the correct chart name, version, and Helm repository URL.

Finally, we export the cluster name and the IP address of the nginx service, which you can use to verify that the nginx service is up and running correctly after deployment.

To run this Pulumi program:

1. Save the code to a file named `index.ts`.
2. Run `pulumi stack init` to create a new stack.
3. Run `pulumi up` to create the resources in OCI.
4. After deployment, you can use the displayed outputs to connect to your Nginx service.

Please replace configuration placeholders with values specific to your OCI environment and Helm chart requirements.