Creating an Enhanced Cluster
Find out how to create an enhanced cluster using Kubernetes Engine (OKE).
You can create enhanced clusters using the Console, the CLI, and the API. Regardless of how you create it, the cluster you create must be VCN-native.
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.
Note that once you have created an enhanced cluster, you cannot downgrade the enhanced cluster to a basic cluster.
To create an enhanced cluster using the Console:
- Follow the instructions in either of the following topics to create the cluster:
-
If you select one or more of the enhanced cluster features in the 'Quick Create' or 'Custom Create' workflows, skip the remaining steps in this task because the new cluster is automatically created as an enhanced cluster.
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 have not selected any of the enhanced cluster features, the Create a Basic cluster option is shown on the Review page of the workflow. By default, the Create a Basic cluster option is not selected, so the new cluster is created as an enhanced cluster unless you explicitly specify that you want to create a basic cluster.
- If you want to create the new cluster as an enhanced cluster even though you did not select any enhanced cluster features, simply ensure that you do not choose the Create a Basic cluster option on the Review page of the workflow.
- Click Create cluster to create the new cluster as an enhanced cluster.
- Verify that you have created the new cluster as an enhanced cluster by confirming that the Cluster Details page shows Cluster type: Enhanced.
Use the oci ce cluster create command and required parameters to create an enhanced cluster:
oci ce cluster create --compartment-id <compartment-ocid> --kubernetes-version <kubernetes-version> --name <cluster-name> --vcn-id <vcn-ocid> --endpoint-subnet-id <subnet-id> --type ENHANCED_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 --endpoint-subnet-id ocid1.subnet.oc1.phx.aaaaaaaa______sna --type ENHANCED_CLUSTERFor a complete list of parameters and values for CLI commands, see the CLI Command Reference.
Run the CreateCluster operation to create an enhanced cluster.