Creating a Cluster

You can create managed Kubernetes clusters for the deployment of your containerized applications. OKS enables you to start Kubernetes clusters with a predefined configuration and pre-installed essential services, so that you do not have to manage unnecessary deployments.

Creating a Cluster Using OKS CLI

Before you begin:

Install OKS CLI. For more information, see Installing and Configuring OKS CLI.
Configure your OKS CLI profile. For more information, see Managing Your Profiles Using OKS CLI.
Create a project. For more information, see Managing Your Projects Using OKS CLI.

To create a cluster, use the cluster create command following this syntax:

Request sample

$ oks-cli cluster create \
    --cluster-name NAME_OF_CLUSTER \
    --project-name NAME_OF_PROJECT \
    --admin "1.2.3.4/32,5.6.7.8/32" \
    --version VERSION_NUMBER \
    --control-plane "cp.3.masters.small" \
    --zone "2a" \
    --zone "2c"

This command contains the following options that you need to specify:

cluster-name: The name of the cluster, with a maximum length of 40 alphanumeric characters and dashes (-). This name must start with a lowercase letter and must not end with a dash. It must be unique within the project.
(optional) project-name: The name of the project in which you want to create the cluster.
admin: The CIDRs to be whitelisted, separated by commas. This range of one or multiple IPs is empty by default, and should be specified in order to manage the cluster after creation.
(optional) version: One of the supported versions of Kubernetes. For more information about the supported versions, see About OKS > Kubernetes Versions Support.
(optional) cidr-pods: The /16 CIDR to be used internally for pods. The project’s CIDR, the pods' CIDRs and the services' CIDR’s should not overlap.
(optional) cidr-service: The /16 CIDR to be used internally for services. The project’s CIDR, the pods' CIDRs and the services' CIDR’s should not overlap.
(optional) control-plane: The desired control plane sizing. For more information, see Control Planes.
(optional) zone: The Subregion you want to start the cluster in. To create a multi-Subregion cluster, you need to repeat this option for each Subregion you want to deploy the cluster in.

Only high availability control planes can be deployed in a multi-Subregion cluster.
(optional) enable-admission-plugins: The list of additional admission plugins you want to enable on the cluster. For more information about the admissions plugins, see the Kubernetes documentation.
(optional) disable-admission-plugins: The list of admission plugins from the default list that you want to disable.
(optional) quirk: The keys and parameters to pass to the cluster. This option is required for feature requests.
(optional) tags: The tags you want to apply to cluster nodes.
(optional) dry-run: Enables the process to simulate the command and preview requirements.
(optional) output: The output format for the response (json | yaml). By default, the response format is JSON. The file generated with the cluster definition can be edited and applied by using the -f --filename … command.
(optional) filename: The name of the definition file you want to create the cluster from.

You can display all the available options using the cluster create command following this syntax:

$ oks-cli cluster create --help

You can use the cluster list command to check the cluster’s status. Your cluster is created when its status changes from deploying to ready.

Related Pages

Corresponding API Method

CreateCluster (OKS API)