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:
- Follow the instructions in either of the following topics to create the cluster:
-
Do not select any of the enhanced cluster features in the 'Quick Create' or 'Custom Create' workflows.
Enhanced cluster features include:
- Virtual node pools and virtual nodes (both 'Quick Create' and 'Custom Create' workflows). See Working with Virtual Nodes.
- Cluster add-on management ('Custom Create' workflow only). See Configuring Cluster Add-ons.
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.
- Choose the Create a Basic cluster option on the Review page.
- Click Create cluster to create the new cluster as a basic cluster.
- 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.