feat(k8s): kube cluster creation update (#3478)

bene2k1 · web-flow · commit f639719784d8 · 2024-09-30T16:51:40.000+02:00
diff --git a/containers/kubernetes/how-to/create-cluster.mdx b/containers/kubernetes/how-to/create-cluster.mdx
@@ -1,53 +1,92 @@
 ---
+
 meta:
   title: How to create a Kubernetes Kapsule cluster
-  description: Learn how to create and manage a Scaleway Kubernetes Kapsule cluster, a managed environment for running containerized applications.
+  description: Learn how to create and manage a Scaleway Kubernetes Kapsule cluster, an advanced managed environment for containerized applications.
 content:
   h1: How to create a Kubernetes Kapsule cluster
-  paragraph: Learn how to create and manage a Scaleway Kubernetes Kapsule cluster, a managed environment for running containerized applications.
-tags: kubernetes kapsule-cluster kapsule
+  paragraph: Master the process of creating and managing a Scaleway Kubernetes Kapsule cluster, an advanced managed environment for containerized applications.
+tags: kubernetes, kapsule-cluster, kapsule
 dates:
-  validation: 2024-06-17
+  validation: 2024-09-30
   posted: 2021-05-31
 categories:
   - kubernetes
 ---
 
-Scaleway Kubernetes Kapsule provides a managed environment for you to create, configure and run a cluster of preconfigured machines for containerized applications. You will be able to create [Kubernetes](https://kubernetes.io) clusters without the complexity of managing the infrastructure.
+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](https://kubernetes.io) clusters without the complexity of managing the underlying infrastructure.
 
-The service offers full flexibility such as:
-  * Scaling the number of pods depending on the workload.
-  * Managing your cluster easily via the [Kubectl](https://kubernetes.io/docs/reference/kubectl/overview/)
+Key benefits include:
+  * Dynamic scaling of pods based on workload demands.
+  * Simplified cluster management via [kubectl](https://kubernetes.io/docs/reference/kubectl/overview/), the Kubernetes command-line tool.
 
-To administrate your Kubernetes cluster easily, Scaleway provides a `.kubeconfig` file that allows you to manage your cluster from your local computer by using `kubectl`. [Kubectl](https://kubernetes.io/docs/reference/kubectl/overview/) is the command line interface for running commands against Kubernetes clusters.
+To facilitate cluster administration, Scaleway provides a `.kubeconfig` file, enabling you to manage your cluster locally using `kubectl`. [kubectl](https://kubernetes.io/docs/reference/kubectl/overview/) is essential for executing commands against Kubernetes clusters.
 
 <Macro id="requirements" />
 
-- A Scaleway account logged into the [console](https://console.scaleway.com)
+- A Scaleway account with access to the [console](https://console.scaleway.com)
 - [Owner](/identity-and-access-management/iam/concepts/#owner) status or [IAM permissions](/identity-and-access-management/iam/concepts/#permission) allowing you to perform actions in the intended Organization
 
-1. Click **Kubernetes** in the **Containers** section of the [Scaleway console](https://console.scaleway.com/) 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.
-      <Message type="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](/containers/kubernetes/how-to/create-kosmos-cluster/)
-      </Message>
-    * 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.
+## Cluster configuration
+
+<Message type="note">
+  This guide covers the creation of a **Kubernetes Kapsule** cluster. For Kubernetes Kosmos clusters, refer to the [Kubernetes Kosmos documentation](/containers/kubernetes/how-to/create-kosmos-cluster/).
+</Message>
+
+1. Navigate to **Kubernetes** under the **Containers** section of the [Scaleway console](https://console.scaleway.com/) side menu. The Kubernetes dashboard displays.
+2. Click **Create cluster** to launch the cluster creation wizard.
+3. On the cluster configuration page, provide the following details:
+    * Check the Organization and Project for the new cluster.
+        <Message type="important">
+          You cannot move a cluster from one Organization or Project to another once created.
+        </Message>
+    * 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.
+        <Message type="tip">
+          Need help deciding on a control plane offer? Learn more about our [Kubernetes control plane offers](/containers/kubernetes/reference-content/kubernetes-control-plane-offers/).
+        </Message>
+    * Specify the **Kubernetes version** for your cluster.
+4. Enter the **cluster's details**. Provide a name for the cluster. Optionally, you can add a description and tags for better organization.
+5. 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.
     <Message type="important">
-      The Private Network of your cluster can not be detached, and the cluster can not be moved to another Private Network after creation.
+      The Private Network cannot be detached, and the cluster cannot be moved to another Private Network post-creation.
+    </Message>
+6. 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.
+
+1. Configure the following for each pool:
+    * Choose an **Availability Zone** for the pool's nodes.
+    * Select the **node type** for the pool.
+        <Message type="tip">
+          Need advice on choosing a node type? [Learn more about Kubernetes nodes.](/containers/kubernetes/concepts/#node)
+        </Message>
+    * 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.
+        <Message type="tip">
+          - Unsure about the autoheal feature? [Learn more about autoheal.](/containers/kubernetes/concepts/#autoheal)
+          - Need more information about placement groups? [Learn more about placement groups.](/compute/instances/concepts/#placement-groups)
+        </Message>
+    * Enable full isolation, if required.
+        <Message type="tip">
+          Need more information on full isolation? [Learn more about full isolation.](/containers/kubernetes/reference-content/secure-cluster-with-private-network/#what-is-the-difference-between-controlled-isolation-and-full-isolation)
+        </Message>
+2. Click **Add pool** to integrate the pool into the cluster.
+3. To add more pools, click **Expand** and repeat the steps above.
+    <Message type="tip">
+      You can add or remove pools as needed before finalizing your cluster configuration. To remove a pool, click **Remove** within the respective pool.
     </Message>
-5. Enter the **name** for the cluster and, optionally, a description and tags, which can help you organize your cluster.
-6. Click **Next**. 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 **node 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.
+4. Once all pools are configured, click **Review** to finalize your cluster setup.
 
+## Review configuration
 
+1. Review the configuration details of your Kubernetes cluster and its pools.
+    <Message type="tip">
+      To modify any element, click the <Icon name="edit" /> **Edit** icon next to the respective configuration component.
+    </Message>
+2. Click **Create cluster** to deploy your cluster. Once deployment is complete, the cluster appears in the clusters list.
diff --git a/containers/kubernetes/how-to/create-kosmos-cluster.mdx b/containers/kubernetes/how-to/create-kosmos-cluster.mdx
@@ -1,19 +1,20 @@
 ---
+
 meta:
   title: How to create a Kubernetes Kosmos cluster
   description: Learn how to create a Kubernetes Kosmos cluster with managed Scaleway Instances and external nodes from any cloud provider.
 content:
   h1: How to create a Kubernetes Kosmos cluster
   paragraph: Learn how to create a Kubernetes Kosmos cluster with managed Scaleway Instances and external nodes from any cloud provider.
-tags: kubernetes kosmos kosmos-cluster cluster
+tags: kubernetes, kosmos, kosmos-cluster, cluster
 dates:
-  validation: 2024-06-17
+  validation: 2024-09-30
   posted: 2021-05-31
 categories:
   - kubernetes
 ---
 
-Kubernetes Kosmos provides an alternative to a classic [Kubernetes Kapsule](/containers/kubernetes/concepts/#kubernetes-kapsule). With Kubernetes Kosmos, you can create a Kubernetes cluster comprising both managed Scaleway Instances (with autohealing and autoscaling), and external Instances and servers from any other cloud provider. Scaleway still ensures the high availability of your services globally, in different zones, regions, and providers. In addition to the Kubernetes Kapsule pricing, you are charged for the Kubernetes Kosmos control plane, and an additional fee for managed external nodes.
+Kubernetes Kosmos provides an alternative to a classic [Kubernetes Kapsule](/containers/kubernetes/concepts/#kubernetes-kapsule). With Kubernetes Kosmos, you can create a Kubernetes cluster comprising both managed Scaleway Instances (with autohealing and autoscaling) and external instances and servers from any other cloud provider. Scaleway ensures the high availability of your services globally, across different zones, regions, and providers. In addition to the Kubernetes Kapsule pricing, you are charged for the Kubernetes Kosmos control plane and an additional fee for managed external nodes.
 
 <Macro id="requirements" />
 
@@ -24,23 +25,64 @@ Kubernetes Kosmos provides an alternative to a classic [Kubernetes Kapsule](/con
   Be aware that autoscaling and autohealing features are unavailable on external providers’ nodes within Kosmos clusters. 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.
 </Message>
 
-1. Click **Kubernetes** in the **Containers** section of the [Scaleway console](https://console.scaleway.com) 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 attaching a compute Instance or dedicated server from any Cloud provider to a Scaleway Kubernetes control plane.
-      <Message type="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](/containers/kubernetes/how-to/create-cluster/).
-      </Message>
-    * 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](/containers/kubernetes/how-to/edit-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.
+## Cluster configuration
+
+1. Navigate to **Kubernetes** under the **Containers** section of the [Scaleway console](https://console.scaleway.com/) side menu. The Kubernetes dashboard displays.
+2. Click **Create cluster** to launch the cluster creation wizard.
+3. On the cluster configuration page, provide the following details:
+    * Check the Organization and Project for the new cluster.
+        <Message type="important">
+          You cannot move a cluster from one Organization or Project to another once created.
+        </Message>
+    * Select **Kubernetes Kosmos** as the cluster type.
+    * Choose the geographical **region** for the cluster.
+    * Select the control plane offer for your cluster. Options include shared or dedicated control planes.
+        <Message type="tip">
+          Need help deciding on a control plane offer? Learn more about our [Kubernetes control plane offers](/containers/kubernetes/reference-content/kubernetes-control-plane-offers/).
+        </Message>
+    * Specify the Kubernetes **version** for your cluster.
+4. Provide a **name** for the cluster. Optionally, you can add a description and tags for better organization.
+5. 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.
+    <Message type="important">
+      The Private Network cannot be detached, and the cluster cannot be moved to another Private Network post-creation.
+    </Message>
+6. 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.
+
+1. Choose the pool type. Available types are **Scaleway** or **multi-cloud**.
+2. Specify the following for each pool:
+  * For **Scaleway** pools:
+    * Choose the **Availability Zone** for the pool's nodes.
+    * Select the **node type** for the 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.
+        <Message type="tip">
+          Unsure about the autoheal feature? [Learn more about autoheal.](/containers/kubernetes/concepts/#autoheal)
+        </Message>
+    * Enable full isolation, if required.
+        <Message type="tip">
+          Need more information on full isolation? [Learn more about full isolation.](/containers/kubernetes/reference-content/secure-cluster-with-private-network/#what-is-the-difference-between-controlled-isolation-and-full-isolation)
+        </Message>
+  * For **multi-cloud** pools:
+    * Specify the external nodes to be added to the pool.
+    <Message type="important">
+      Note that autoscaling and autohealing are not available for multi-cloud pools.
+    </Message>
+2. Click **Add pool** to integrate the pool into the cluster.
+3. To add more pools, click **Expand** and repeat the steps above.
+    <Message type="tip">
+      You can add or remove pools as needed before finalizing your cluster configuration. To remove a pool, click **Remove** within the respective pool.
+    </Message>
+4. Once all pools are configured, click **Review** to finalize your cluster setup.
 
+## Review configuration
 
+1. Review the configuration details of your Kubernetes cluster and its pools.
+    <Message type="tip">
+      To modify any element, click the <Icon name="edit" /> **Edit** icon next to the respective configuration component.
+    </Message>
+2. Click **Create cluster** to deploy your cluster. Once deployment is complete, the cluster appears in the clusters list.
diff --git a/containers/kubernetes/quickstart.mdx b/containers/kubernetes/quickstart.mdx
