{{ contents }}

Overview 🔗︎

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.

Prerequisites 🔗︎

  • 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}}",
  }
}
EOF

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 in 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"
        }
      }
    }
  }
}
EOF

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

Check the status of the cluster 🔗︎

To check the status of the cluster, run the following command:

banzai cluster get "<cluster-name>"

Once the cluster is ready, you can try to run 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 arguments to it, it will be executed in a prepared environment. For example, you can list the nodes of the cluster using the original kubectl command by running:

banzai cluster shell --cluster-name "<cluster-name>" -- 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.