NavigationContentFooter
Jump toSuggest an edit

Kubernetes - Quickstart

Reviewed on 27 December 2023Published on 26 May 2021

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.

Kubernetes decision tree

1 An Introduction To Kubernetes8 Let’s learn how to create and push a container image to the Scaleway Container Registry and how to use it on Kubernetes Kapsule
2 Basics hands-on9 How to deploy containerized applications with the Easy Deploy Feature
3 Concepts10 Odoo on a Scaleway Kubernetes Kapsule using the Easy Deploy Feature
4 Introduction video to Kubernetes11 How does containerizing two simple applications with Docker sound
5 Scaleway Instances12 Docker concepts
6 How to connect to a cluster with kubectl13 How to deploy a containerized application with Kubernetes Kapsule
7 kubectl definition14 How to add a load balancer service to your Scaleway Kubernetes Kapsule
Tip

This content is also available as a printable PDF file. Click the link below to download:

  • Kubernetes decision tree - Printable (PDF, 2.03MB)

Before you start

To complete the actions presented on this page, you must have:

Requirements
  • You have an account and are logged into the Scaleway console

How to create a Kubernetes cluster

  1. Click Kubernetes in the Containers section of the Scaleway console side menu. The Kubernetes dashboard displays.
  2. Click Create cluster. The first page of the cluster creation wizard displays.
  3. This page concerns the configuration of your cluster. Enter the following information:
    • The cluster type. Select Kubernetes Kapsule cluster to create a cluster using exclusively Scaleway Instances.
      Note

      This document concerns the creation and management of a Kubernetes Kapsule cluster. To create a Kubernetes Kosmos cluster, refer to the Kubernetes Kosmos documentation

    • The geographical region of the cluster.
    • The Kubernetes version for the cluster.
  4. Configure the Private Network for the cluster. A Private Network allows your cluster to communicate in an isolated and secure network. Each cluster is autoconfigured using a /22 IP subnet. You can either:
    • Attach an existing Private Network (VPC) within the same Availability Zone from the drop-down.
    • Attach a new Private Network to the cluster.
    Important

    The Private Network of your cluster can not be detached, and the cluster can not be moved to another Private Network after creation.

  5. Enter the name for the cluster and, optionally, a description and tags, which can help you organize your cluster.
  6. Click Configure pool. The second page of the Kapsule cluster creation wizard displays.
  7. This page concerns the settings for your cluster’s pool. Enter the following information:
    • The Availability Zone in which all your pool’s nodes will be created.
    • The node type you require.
    • 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.
  8. Click Create cluster. Your cluster is being deployed. Once the cluster is ready, it appears in the clusters list.

How to add a Scaleway pool to a Kubernetes cluster

  1. Click Kubernetes in the Containers section of the side menu. The Kubernetes dashboard displays.
  2. Click «See more Icon» next to the cluster you want to edit. Click Add pool in the menu. The pool configuration wizard displays.
  3. 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.
  4. Click Add pool.

How to add a multi-cloud pool to a Kubernetes cluster

  1. Click Kubernetes in the Containers section of the side menu. The Kubernetes dashboard displays.
  2. Click «See more Icon» next to the pool you want to edit. Click Add pool in the menu. The pool configuration wizard displays.
  3. Click Add pool.

How to add external nodes to a multi-cloud pool

  1. Click Kubernetes in the Containers section of the Scaleway console side menu. The Kubernetes dashboard displays.

  2. Click Create cluster. The first page of the cluster creation wizard displays. This concerns the configuration of your cluster.

  3. 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.
      Note

      This document concerns the creation and management of a Kubernetes Kosmos cluster. To create a Kubernetes Kapsule cluster, refer to the Kubernetes Kapsule documentation.

    • The geographical region of the cluster.
    • The Kubernetes version for the cluster.
    • A name for the cluster and, optionally, a description and tags.
  4. 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.

  5. 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.
  6. Click Create cluster. Your cluster is deployed, and you are taken to the cluster’s Overview tab.

Important

Make sure you have:

  • An arm64 or amd64 server running with Ubuntu or Debian, having a public IP assigned to it.
  • A Scaleway secret key.
Tip

For more information about adding external nodes to your Kosmos cluster, refer to our dedicated How to manage a Kosmos cluster documentation.

How to edit a Kubernetes cluster

  1. Click Kubernetes in the Containers section of the side menu. The Kubernetes dashboard displays.
  2. Click «See more Icon» next to the cluster you want to edit.
  3. 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.
Tip

Click the name of the cluster you want to edit to display all available options.

How to delete a Kubernetes cluster

  1. Click Kubernetes in the Containers section of the side menu. The Kubernetes dashboard displays.
  2. Click «See more Icon» to display the options menu, then click Delete. A cluster deletion pop-up displays.
  3. 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.
    Important

    Deleting your cluster will permanently destroy your cluster and all its associated pools and Instances. External compute resources cannot be destroyed automatically and will remain active until destroyed at the concerned cloud service provider (CSP).

Cloud Products & Resources
  • Scaleway Console
  • Compute
  • Storage
  • Network
  • IoT
  • AI
Dedicated Products & Resources
  • Dedibox Console
  • Dedibox Servers
  • Network
  • Web Hosting
Scaleway
  • Scaleway.com
  • Blog
  • Careers
  • Scaleway Learning
Follow us
FacebookTwitterSlackInstagramLinkedin
ContractsLegal NoticePrivacy PolicyCookie PolicyDocumentation license
© 1999-2024 – Scaleway SAS