Kubernetes - Quickstart
Scaleway Kubernetes Kapsule and Kosmos provide a managed environment to create, configure, and run a cluster of preconfigured machines for containerized applications. This allows you to create Kubernetes clusters without the complexity of managing the infrastructure. You can create a Kapsule cluster to your required specifications, edit it after creation, and delete it all when you no longer need it. You might also want to check out our how-to on deploying an image on your cluster.
Console overview
Discover the Kubernetes interface on the Scaleway console.
Before you start
To complete the actions presented below, you must have:
- A Scaleway account logged into the console
- Owner status or IAM permissions allowing you to perform actions in the intended Organization
How to create a Kubernetes cluster
Cluster configuration
- Navigate to Kubernetes under the Containers section of the Scaleway console side menu. The Kubernetes dashboard displays.
- From the drop-down menu, select the geographical region where you want to create your cluster.
- Click Create cluster to launch the cluster creation wizard.
- On the cluster configuration page, provide the following details:
- Check the Organization and Project for the new cluster.
- Select Kubernetes Kapsule as the cluster type, which uses exclusively Scaleway Instances.
- Confirm the geographical region for the cluster.
- Select the control plane offer for your cluster. Options include shared or dedicated control planes.
- Specify the Kubernetes version for your cluster.
- Enter the cluster's details. Provide a name for the cluster. Optionally, you can add a description and tags for better organization.
- Configure the Private Network for the cluster to ensure secure and isolated network communication. Each cluster is auto-configured with a /22 IP subnet. Click Select Private Network to:
- Attach an existing Private Network (VPC) within the same Availability Zone from the drop-down menu.
- Attach a new Private Network to the cluster.
- Click Configure pools to proceed.
Pool configuration
This section outlines the settings for your cluster pools. You can configure as many pools for your cluster as you require.
- Configure the following for each pool:
- Choose an Availability Zone for the pool's nodes.
- Select the node type for the pool.
- Configure the system volume. This volume contains the operating system of the nodes in your pool.
- Configure pool options, including node count and whether to enable autoscaling. Options also include enabling autoheal and linking to a placement group, or you can retain default settings.
- Enable full isolation, if required.
- Click Add pool to integrate the pool into the cluster.
- To add more pools, click Expand and repeat the steps above.
- Once all pools are configured, click Review to finalize your cluster setup.
Review configuration
- Review the configuration details of your Kubernetes cluster and its pools.
- Click Create cluster to deploy your cluster. Once deployment is complete, the cluster appears in the clusters list.
You can now download the
kubeconfig
file for your cluster and learn how to connect to a Kubernetes Kapsule cluster with kubectl.
How to add a Scaleway pool to a Kubernetes cluster
- Click Kubernetes in the Containers section of the side menu. The Kubernetes dashboard displays.
- From the drop-down menu, select the geographical region you want to manage.
- Click more icon next to the cluster you want to edit. Click Add pool in the menu. The pool configuration wizard displays.
- This page concerns the configuration of your cluster. Enter the following information:
- The geographical region of the pool.
- The node type for the pool.
- If required, configure the pool options like autoscaling, autohealing, or link the pool to an existing placement group.
- The name for the pool. Optionally, you can assign tags to it.
- Click Add pool.
How to add a multi-cloud pool to a Kubernetes cluster
- Click Kubernetes in the Containers section of the side menu. The Kubernetes dashboard displays.
- From the drop-down menu, select the geographical region you want to manage.
- Click more icon next to the pool you want to edit. Click Add pool in the menu. The pool configuration wizard displays.
- Click Add pool.
How to add external nodes to a multi-cloud pool
-
Click Kubernetes in the Containers section of the Scaleway console side menu. The Kubernetes dashboard displays.
-
From the drop-down menu, select the geographical region you want to manage.
-
Click Create cluster. The first page of the cluster creation wizard displays. This concerns the configuration of your cluster.
-
Complete the following steps of the wizard:
- Choose a cluster type. Select Kubernetes Kosmos to create a cluster, that allows you to attach a compute Instance or dedicated server from any Cloud provider to a Scaleway Kubernetes control plane.
- The geographical region of the cluster.
- The Kubernetes version for the cluster.
- A name for the cluster and, optionally, a description and tags.
-
Click Create cluster to create your cluster without any Scaleway pools. If you choose this option, your cluster and its control plane are deployed, and you are taken to the cluster's overview tab. Continue to How to manage your Kubernetes Kosmos cluster to find out how to add multi-cloud pools to your cluster.
Alternatively, click Add and configure a pool to add a pool of Scaleway nodes to your cluster. In this case, the second page of the cluster creation wizard displays. This concerns the settings for your pool.
-
Enter the following information to configure a Scaleway pool:
- The Availability Zone in which all your pool's nodes will be created.
- The node type you need.
- The configuration for your pool options, including the number of nodes and whether to enable autoscale. You can also choose whether to enable autoheal and whether to link the cluster to a placement group. Alternatively, you can leave these options at default values.
-
Click Create cluster. Your cluster is deployed, and you are taken to the cluster’s Overview tab.
How to edit a Kubernetes cluster
- Click Kubernetes in the Containers section of the side menu. The Kubernetes dashboard displays.
- From the drop-down menu, select the geographical region you want to manage.
- Click more icon next to the cluster you want to edit.
- Choose the option you require:
- Add pool: Add additional computing resources to the cluster.
- Get kubeconfig: Download the
.kubeconfig
file of the cluster. - Delete: Delete the cluster.
How to delete a Kubernetes cluster
- Click Kubernetes in the Containers section of the side menu. The Kubernetes dashboard displays.
- From the drop-down menu, select the geographical region you want to manage.
- Click more icon to display the options menu, then click Delete. A cluster deletion pop-up displays.
- Type DELETE to confirm the deletion of your cluster. Tick the checkbox to automatically delete all volumes (including those with volume type “retain”) and Load Balancers whose names start with the cluster ID. Validate your choice by clicking Delete cluster.