Getting started with Managed Service for Kubernetes
Create a Managed Service for Kubernetes cluster and node group and manage them using kubectl, the Kubernetes command-line interface.
Getting started
To get started with Managed Service for Kubernetes:
-
Go to the management console
and log in to Nebius AI or create an account if you do not have one yet. -
Install the Kubernetes CLI (kubectl)
. -
Make sure you have enough resources available in the cloud.
Create a Managed Service for Kubernetes cluster
-
In the management console
, select the folder where you want to create a Managed Service for Kubernetes cluster. -
Select Managed Service for Kubernetes.
-
Click Create cluster.
-
Enter a name for the cluster. It must be unique within the folder.
-
(Optional) Enter a cluster description.
-
Under Master configuration:
- Kubernetes version: Select a Kubernetes version to install on the master and nodes.
- Public address: Select the IP address assignment method:
- Auto: Assign a random IP address from the Nebius AI IP pool.
- No address: Do not assign a public IP address.
- Master type: Select the type of the master:
- Single: A master created in one subnet. Specify a cloud network and select a subnet that the master host will be on.
- Highly available: A master distributed between three subnets in one availability zone. Specify a cloud network and subnet for each master location.
-
Under Cluster network settings:
- Cluster CIDR: Specify an IP range to allocate addresses to pods from.
- Service CIDR: Specify an IP range to allocate IP addresses to services from.
-
Click Create cluster.
For more information, see the step-by-step instructions for creating a cluster.
Add credentials to the kubectl configuration file
If you don't have the Nebius AI command line interface yet, install and initialize it.
The folder specified in the CLI profile is used by default. You can specify a different folder using the --folder-name
or --folder-id
parameter.
To add Managed Service for Kubernetes cluster credentials to the kubectl configuration file:
-
Run the following command:
ncp managed-kubernetes cluster get-credentials test-k8s-cluster --external
- By default, credentials are added to the
$HOME/.kube/config
directory. - If you need to change the configuration location, use the
--kubeconfig <file path>
flag.
- By default, credentials are added to the
-
Check the kubectl configuration after adding the credentials:
kubectl config view
Command result:
apiVersion: v1 clusters: - cluster: certificate-authority-data: DATA+OMITTED ...
Create a node group
To create a node group:
- In the management console
, select the folder where the required Managed Service for Kubernetes cluster was created. - In the list of services, select Managed Service for Kubernetes.
- Select the Managed Service for Kubernetes cluster to create a node group for.
- On the Managed Service for Kubernetes cluster page, click the Nodes manager tab.
- Click Create node group.
- Enter a name and description for the node group.
- Under Scaling, select a type:
- Fixed: The number of nodes in the group remains unchanged. Specify the number of nodes in the group.
- Automatic: The number of nodes in the group can be controlled using automatic cluster scaling.
- Under Computing resources:
- Choose a platform.
- Specify the requisite number of vCPUs and the amount of RAM.
- (optional) Specify that the VM must be preemptible.
- Under Storage:
-
Specify the Disk type for the group's nodes:
- Network SSD (
network-ssd
): Fast network drive, which is an SSD based network block storage. - Network HDD (
network-hdd
): Standard network drive, which is an HDD based network block storage. - Non-replicated SSD (
network-ssd-nonreplicated
): Network drive with enhanced performance without redundancy. - High-performance SSD (
network-ssd-io-m3
): Network drive with the same performance characteristics asnetwork-ssd-nonreplicated
, plus redundancy.
For more information about disk types, see the Compute Cloud documentation.
- Network SSD (
-
Specify the disk size for the group's nodes.
-
- Under Network settings:
- In the Public IP field, choose a method for assigning an IP address:
- Auto: Assign a random IP address from the Nebius AI IP pool.
- No address: Do not assign a public IP address.
- Select an availability group and subnet to deploy the group's nodes to.
- In the Public IP field, choose a method for assigning an IP address:
- Under Access, specify the information required to access the group nodes over SSH:
- Login: Enter the username.
- SSH key: Insert the contents of the public key file.
- Click Create.
For more information, see the step-by step instructions for creating node groups.
What's next
- Read about service concepts.
- Learn how to work with a Managed Service for Kubernetes cluster and node groups.
- Read questions and answers.
- Review the recommendations for using Kubernetes.