This guide covers the creation of a Kubernetes Kapsule cluster. For Kubernetes Kosmos clusters, refer to the Kubernetes Kosmos documentation.
How to create a Kubernetes Kapsule cluster
Scaleway Kubernetes Kapsule provides a managed environment for creating, configuring, and operating a cluster of preconfigured nodes for containerized applications. This service allows you to deploy Kubernetes clusters without the complexity of managing the underlying infrastructure.
Key benefits include:
- Dynamic scaling of pods based on workload demands.
- Simplified cluster management via kubectl, the Kubernetes command-line tool.
To facilitate cluster administration, Scaleway provides a .kubeconfig
file, enabling you to manage your cluster locally using kubectl
. This tool is essential for executing commands against Kubernetes clusters.
Before you startLink to this anchor
To complete the actions presented below, you must have:
- A Scaleway account with access to the console
- Owner status or IAM permissions allowing you to perform actions in the intended Organization
Cluster configurationLink to this anchor
- Navigate to Kubernetes under the Containers section of the Scaleway console side menu. The Kubernetes dashboard displays.
- 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.
Important
You cannot move a cluster from one Organization or Project to another once created.
- Select Kubernetes Kapsule as the cluster type, which uses exclusively Scaleway Instances.
- Choose the geographical region for the cluster.
- Select the control plane offer for your cluster. Options include shared or dedicated control planes.
Tip
Need help deciding on a control plane offer? Learn more about our Kubernetes control plane offers.
- Specify the Kubernetes version for your cluster.
- Check the Organization and Project for the new 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.
ImportantThe Private Network cannot be detached, and the cluster cannot be moved to another Private Network post-creation.
- Click Configure pools to proceed.
Pool configurationLink to this anchor
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.
Tip
Need advice on choosing a node type? Learn more about Kubernetes nodes.
- 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.
Tip
- Unsure about the autoheal feature? Learn more about autoheal.
- Need more information about placement groups? Learn more about placement groups.
- Enable full isolation, if required.
Tip
Need more information on full isolation? Learn more about full isolation.
- Click Add pool to integrate the pool into the cluster.
- To add more pools, click Expand and repeat the steps above.
Tip
You can add or remove pools as needed before finalizing your cluster configuration. To remove a pool, click Remove within the respective pool.
- Once all pools are configured, click Review to finalize your cluster setup.
Review configurationLink to this anchor
- Review the configuration details of your Kubernetes cluster and its pools.
Tip
To modify any element, click the «Edit Icon» Edit icon next to the respective configuration component.
- Click Create cluster to deploy your cluster. Once deployment is complete, the cluster appears in the clusters list.