Oracle Cloud Infrastructure Container Engine for Kubernetes (sometimes abbreviated to just OKE) is a fully-managed, scalable, and highly available service that you can use to deploy your containerized applications to the cloud.

This quick start guide will lead you through the process of launching an OKE cluster with Banzai Cloud Pipeline.


  • OCI credentials
  • Banzai CLI tool logged in to a Pipeline instance

Create OKE secret

For creating an OKE cluster, we will need to add Oracle Cloud Infrastructure credentials to Banzai Cloud Pipeline’s secret store.

Follow this guide to create OCI credentials

You need the followings to create an OCI secret:

  • Tenant OCID
  • User’s OCID
  • Compartment OCID
  • API Key
  • API Fingerprint
  • Region

You can simply do this with the following command (substitute the placeholders in curly brackets):

banzai secret create <<EOF
  "name": "oci-default",
  "type": "oracle",
  "values": {
   "tenancy_ocid": "{{tenancyOCID}}",
   "user_ocid": "{{userOCID}}"
   "compartment_ocid": "{{compartmentOCID}}",
   "api_key": "{{apiKey}}",
   "api_key_fingerprint": "{{apiKeyFingerPrint}}",
   "region": "{{region}}",

Id                                                           Name         Type    UpdatedBy  Tags
b8b7f1cf38e75a2baf8f1a20456ef1c8f899d4bd7af7321a2f0e6e3d4cf  oci-default  oracle  waynz0r    []

Create an OKE cluster

Use the following command to create a 2 node OKE cluster in the ashburn region.

You can check the available regions and instance types at our Cloudinfo service.

banzai cluster create <<EOF
  "name": "oke-cluster-01",
  "location": "us-ashburn-1",
  "cloud": "oracle",
  "secretName": "oci-default",
  "properties": {
    "oke": {
      "version": "v1.13.5",
      "nodePools": {
        "pool1": {
          "count": 1,
          "shape": "VM.Standard2.1",
          "version": "v1.13.5"
        "pool2": {
          "count": 1,
          "shape": "VM.Standard2.2",
          "version": "v1.13.5"

INFO[0011] cluster is being created
INFO[0011] you can check its status with the command `banzai cluster get "oke-cluster-01"`
Id    Name
1     oke-cluster-01

Verify running cluster

You can check the status of the cluster creation with the following command:

banzai cluster get "oke-cluster-01"

Once the cluster is ready, you can try it with some simple commands. banzai cluster shell executes a shell within the context of the selected cluster. If you type a command in the shell opened, or pass it as arguments, it will be executed in a prepared environment. For example, you can list the nodes of the cluster using the original kubectl command:

banzai cluster shell --cluster-name "oke-cluster-01" -- kubectl get nodes

Further steps

If you are happy with the results, go on with the Deploying workload guide to learn about the basic features of a cluster.