HomeContainersKubernetesHow to
Manage a Kosmos cluster

Jump toUpdate content

How to manage a Kubernetes Kosmos cluster

Published on 31 May 2021

You can add nodes and pools to your Kosmos cluster from the Scaleway Console or by using the API. Here, we show you how to edit from the console.

Security & Identity (IAM):

You may need certain IAM permissions to carry out some actions described on this page. This means:

  • you are the Owner of the Scaleway Organization in which the actions will be carried out, or
  • you are an IAM user of the Organization, with a policy granting you the necessary permission sets
Note:

This document concerns the management of a Kosmos cluster. For a Kapsule cluster, refer to the corresponding documentation for Kapsule

Important:

Be aware that nodes from multi-cloud pools cannot benefit from the auto-healing and auto-scaling features of Scaleway Kapsule pool. Since Scaleway does not have access to your other providers’ accounts, it is not possible to carry out actions such as automatic deletion, creation,and reboot of external nodes.

Requirements:
  • You have an account and are logged into the Scaleway console
  • You have created a Kubernetes Kosmos cluster
  • You have external machines running Ubuntu 20.04 LTS that you want to add to your cluster

How to add a multi-cloud pool to your Kosmos cluster

A multi-cloud pool allows you to attach external Instances and servers to your cluster. Instances added to the same pool do not need to share the same configuration, nor do they have to be managed by the same Cloud provider.

  1. Click Kubernetes in the Containers section of the side menu. The Kubernetes creation page displays.
  2. Click the cluster you want to add a pool to.
  3. Click the Pools tab.
  4. Click the + Add pool button. The pool creation wizard displays.
  5. Complete the following steps of the wizard:
    • Choose a pool type. This can be a Scaleway Kubernetes Kapsule Pool or a Kubernetes Multi-Cloud Pool. This document concerns the addition of a Multi-Cloud Pool.
    • A name for the pool and optionally a description and tags.
  6. Click Add pool to finish.

How to add external nodes to your multi cloud pool

In order to add external nodes to your Multi Cloud cluster, you must first create a Multi Cloud pool.

  1. Click Kubernetes in the Compute section of the side menu. The Kubernetes creation page displays.

  2. Click the cluster you want to add external nodes to.

  3. Click the Nodes tab.

  4. Click the + Add an external node button.

    The instructions for adding an external node display:

Connect to the node you want to add to your Kubernetes Kosmos cluster and run the command as described in the instruction panel.

How to detach nodes from your multi cloud pool

  1. Click Kubernetes in the Compute section of the side menu. The Kubernetes creation page displays.
  2. Click the cluster in question.
  3. Click the Nodes tab.
  4. Click the unlink icon next to the node you want to detach. A pop-up asks you to confirm the action.
  5. Click Detach node.
    Note:

    This action will remove your node from the cluster. Your external node will not be deleted from your other cloud provider account(s).

See Also