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

Question

Pulumi · Accepted Answer

To deploy the Saleor Helm chart on Oracle Kubernetes Engine (OKE), you will need to:

Create or use an existing Kubernetes cluster within Oracle Cloud Infrastructure (OCI).
Install Helm if you haven't already, since it will be used to manage Kubernetes applications.
Use Pulumi to deploy the Saleor Helm chart onto your Kubernetes cluster.

Below is a step-by-step TypeScript program using Pulumi which demonstrates how this process can be accomplished. Before running the program, make sure you have set up the Oracle and Kubernetes configuration and have proper access rights.

First, let's start with creating an OKE cluster. In this example, we assume that a Kubernetes cluster has already been provisioned and configured to work with Pulumi through kubeconfig. You must configure the OCI provider with the necessary credentials and region information.

Detailed Explanation:

Oracle Kubernetes Engine (OKE) Cluster: You will create a Kubernetes cluster within OCI. The oci.ContainerEngine.Cluster Pulumi resource allows you to define and provision an OKE cluster programmatically.

Helm and Helm Chart: Helm is a package manager for Kubernetes that allows you to define, install, and upgrade even the most complex Kubernetes applications. For Saleor, you need a Helm chart, which is a collection of files that describe a related set of Kubernetes resources. A chart might contain a Deployment, ServiceAccount, Service, Ingress, etc.

Saleor Helm Chart: Saleor provides a Helm chart that we will use to deploy. The chart includes all the Kubernetes resources needed to run Saleor in a cluster.

Pulumi Program: We will use the kubernetes.helm.v3.Chart resource from Pulumi's Kubernetes provider to deploy the Saleor Helm chart. This allows us to specify the chart, version, and any overrides we wish to apply to the default configuration.

Pulumi Program:

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

const config = new pulumi.Config();

// Configure OCI provider with credentials and a target region if not using environment variables or default profile.
const provider = new oci.Provider("oci-provider", {
    // Optionally specify the region, tenancyOcid, userOcid, privateKey, and fingerprint for your OCI account.
});

// Reference an existing Kubernetes cluster on OCI.
const clusterId = config.require("okeClusterId");
const okeCluster = oci.containerengine.Cluster.get("cluster", clusterId, { provider: provider });

// Kubernetes provider configuration to deploy resources to the OKE cluster.
const k8sProvider = new k8s.Provider("k8s-provider", {
    kubeconfig: okeCluster.kubeConfigs[0].content,
});

// Deploy Saleor using the official Helm chart.
const saleorChart = new k8s.helm.v3.Chart("saleor", {
    chart: "saleor",
    version: "<CHART-VERSION>", // Specify the version of Saleor Helm chart or remove this line to use the latest version.
    fetchOpts: {
        repo: "https://charts.saleor.io/", // Saleor Helm chart's repository URL.
    },
}, { provider: k8sProvider });

// Export the Saleor service's endpoint for easy access.
const endpoint = saleorChart.getResourceProperty("v1/Service", "saleor", "status")
    .apply(status => status.loadBalancer.ingress[0].ip || status.loadBalancer.ingress[0].hostname);

pulumi.export("saleorEndpoint", endpoint);

Next Steps:

Replace <CHART-VERSION> with the desired version of the Saleor Helm chart. If you're unsure, you can remove the version key to fetch the latest version.
Provide the necessary OCI configuration or ensure your environment is configured for Pulumi to access your OCI resources.
Ensure you have the required Saleor Helm chart repository added to your Helm configuration (you can do this with the helm repo add command outside of this script).
After setting up the program, run pulumi up to execute the script and deploy Saleor to your OKE cluster. This can be done in the CLI or through Pulumi's CI/CD integrations.

The program uses Pulumi to deploy resources onto Kubernetes. When pulumi up is executed, Pulumi will automatically perform the necessary steps to create the defined resources, and the endpoint of the Saleor service will be exported for you to access Saleor's web interface.

Keep in mind that Saleor has its own set of configurations, such as database access credentials and other environment settings, that need to be provided for a proper deployment. Make sure to review Saleor's chart documentation for details on how to provide these configurations.