Creating a Basic Cluster

Find out how to create a basic cluster using Kubernetes Engine (OKE).

You can create basic clusters using the Console, the CLI, and the API.

Note the following when creating clusters:

  • When using the Console to create a cluster, if you don't select any enhanced features during cluster creation, you have the option to create the new cluster as a basic cluster. A new cluster is created as an enhanced cluster by default, unless you explicitly choose to create a basic cluster.
  • When using the CLI or the API to create a cluster, you can specify whether to create a basic cluster or an enhanced cluster. If you don't explicitly specify the type of cluster to create, a new cluster is created as a basic cluster by default.

Also note that you can upgrade a basic cluster to an enhanced cluster, provided it is VCN-native (see Upgrading a Basic Cluster to an Enhanced Cluster). However, having upgraded a basic cluster to an enhanced cluster, you can't downgrade the enhanced cluster back to a basic cluster.

  • To create a basic cluster using the Console:

    1. Follow the instructions in either of the following topics to create the cluster:
    2. Do not select any of the enhanced cluster features in the 'Quick Create' or 'Custom Create' workflows.

      Enhanced cluster features include:

      When you do not select any of the enhanced cluster features, the Create a Basic cluster option is shown on the Review page of the workflow.

    3. Choose the Create a Basic cluster option on the Review page.
    4. Select Create cluster to create the new cluster as a basic cluster.
    5. Verify that you have created the new cluster as a basic cluster by confirming that the Cluster Details page shows Cluster type: Basic.
  • Use the oci ce cluster create command and required parameters to create a basic cluster

    oci ce cluster create --compartment-id <compartment-ocid> --kubernetes-version <kubernetes-version> --name <cluster-name> --vcn-id <vcn-ocid> --type BASIC_CLUSTER [OPTIONS]

    For example:

    oci ce cluster create --compartment-id ocid1.compartment.oc1..aaaaaaaay______t6q --kubernetes-version v1.25.4 --name Finance-Cluster --vcn-id ocid1.vcn.oc1.iad.aaaaaae___yja --type BASIC_CLUSTER

    For a complete list of parameters and values for CLI commands, see the CLI Command Reference.

  • Run the CreateCluster operation to create a basic cluster.