From bdda0b1746f6e387c3def427b24962a3cf838d92 Mon Sep 17 00:00:00 2001 From: Benedikt Rollik Date: Mon, 6 Oct 2025 13:57:42 +0200 Subject: [PATCH 1/4] docs(k8s): add instructions for kubeconfig download from console --- .../how-to/connect-cluster-kubectl.mdx | 80 +++++++++++-------- 1 file changed, 47 insertions(+), 33 deletions(-) diff --git a/pages/kubernetes/how-to/connect-cluster-kubectl.mdx b/pages/kubernetes/how-to/connect-cluster-kubectl.mdx index c9e27a4f2c..c84b6339fb 100644 --- a/pages/kubernetes/how-to/connect-cluster-kubectl.mdx +++ b/pages/kubernetes/how-to/connect-cluster-kubectl.mdx @@ -36,39 +36,53 @@ For detailed information about the configuration of IAM policies for your Kubern ## Accessing the cluster -You can use the Scaleway CLI to automatically retrieve (and merge) your `kubeconfig` file, then interact with your Kubernetes cluster. - -### Install and configure the Scaleway CLI - -If you have not set up the Scaleway CLI yet: - -1. Follow our [installation guide](/scaleway-cli/quickstart) for platform-specific instructions using Homebrew, Chocolatey, or manual methods. -2. Run the following command and follow the prompts to set up your CLI with your Scaleway API keys: - ```bash - scw init - ``` - You will need your [API Key](/iam/how-to/create-api-keys/) (access key and secret key). - - -### Retrieve and install the kubeconfig using scw - -1. Run the following command to install the `kubeconfig` file for your cluster: - ```bash - scw k8s kubeconfig install - ``` - This command will: - - Download the `kubeconfig` for the specified cluster. - - Merge it into your existing `kubeconfig` file (default location: `~/.kube/config`). - -2. Verify the installation: - ```bash - kubectl get nodes - ``` - A list of nodes from your Kapsule cluster should appear. - - - Refer to our complete [Documentation for `scw k8s`](https://github.com/scaleway/scaleway-cli/blob/master/docs/commands/k8s.md) to learn more about all available commands to manage your Kubernetes cluster using `scw`. - + + + 1. Click **Kubernetes** in the **Containers** section of the [Scaleway console](https://console.scaleway.com) side menu. The Kubernetes Kapsule overview displays. + 2. From the drop-down menu, select the geographical region you want to manage. + 3. Click the name of the cluster you want to access. The cluster overview page displays. This page provides several pieces of information about your cluster. + 4. In the **Getting Started** section of the page click **2 Download kubeconfig**, then click **Generate kubeconfig**. + 5. Enter your existing Scaleway API key or click **Generate API key** to generate a new one. + 6. (Optional) Enter API key specifics by select the API key bearer, enter a description and expiration date for the key. Then click **Generate API key**. + 7. The secret key of your API key displays. **Copy and store it** in a secure location. It will only be shown once. + 8. Click **Dowload kubeconfig** and run the command shown to export the path to the configuration file on your local machine. + + + You can use the Scaleway CLI to automatically retrieve (and merge) your `kubeconfig` file, then interact with your Kubernetes cluster. + + ### Install and configure the Scaleway CLI + + If you have not set up the Scaleway CLI yet: + + 1. Follow our [installation guide](/scaleway-cli/quickstart) for platform-specific instructions using Homebrew, Chocolatey, or manual methods. + 2. Run the following command and follow the prompts to set up your CLI with your Scaleway API keys: + ```bash + scw init + ``` + You will need your [API Key](/iam/how-to/create-api-keys/) (access key and secret key). + + + ### Retrieve and install the kubeconfig using scw + + 1. Run the following command to install the `kubeconfig` file for your cluster: + ```bash + scw k8s kubeconfig install + ``` + This command will: + - Download the `kubeconfig` for the specified cluster. + - Merge it into your existing `kubeconfig` file (default location: `~/.kube/config`). + + 2. Verify the installation: + ```bash + kubectl get nodes + ``` + A list of nodes from your Kapsule cluster should appear. + + + Refer to our complete [Documentation for `scw k8s`](https://github.com/scaleway/scaleway-cli/blob/master/docs/commands/k8s.md) to learn more about all available commands to manage your Kubernetes cluster using `scw`. + + + ## Revoking user access to the Kubernetes cluster From e77bd3c6080cb63235ce2e916b3dd002d203ed8a Mon Sep 17 00:00:00 2001 From: Benedikt Rollik Date: Tue, 7 Oct 2025 09:58:45 +0200 Subject: [PATCH 2/4] Apply suggestions from code review Co-authored-by: Rowena Jones <36301604+RoRoJ@users.noreply.github.com> --- pages/kubernetes/how-to/connect-cluster-kubectl.mdx | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/pages/kubernetes/how-to/connect-cluster-kubectl.mdx b/pages/kubernetes/how-to/connect-cluster-kubectl.mdx index c84b6339fb..307564ed51 100644 --- a/pages/kubernetes/how-to/connect-cluster-kubectl.mdx +++ b/pages/kubernetes/how-to/connect-cluster-kubectl.mdx @@ -40,10 +40,10 @@ For detailed information about the configuration of IAM policies for your Kubern 1. Click **Kubernetes** in the **Containers** section of the [Scaleway console](https://console.scaleway.com) side menu. The Kubernetes Kapsule overview displays. 2. From the drop-down menu, select the geographical region you want to manage. - 3. Click the name of the cluster you want to access. The cluster overview page displays. This page provides several pieces of information about your cluster. - 4. In the **Getting Started** section of the page click **2 Download kubeconfig**, then click **Generate kubeconfig**. + 3. Click the name of the cluster you want to access. The cluster overview page displays. This page provides information about your cluster. + 4. In the **Getting Started** section of the page, click **2 Download kubeconfig**, then **Generate kubeconfig**. 5. Enter your existing Scaleway API key or click **Generate API key** to generate a new one. - 6. (Optional) Enter API key specifics by select the API key bearer, enter a description and expiration date for the key. Then click **Generate API key**. + 6. (Optional) Enter API key specifics by selecting the API key bearer, and entering a description and expiration date for the key. Then click **Generate API key**. 7. The secret key of your API key displays. **Copy and store it** in a secure location. It will only be shown once. 8. Click **Dowload kubeconfig** and run the command shown to export the path to the configuration file on your local machine. From 803917953d7291d87a7d9b7c0c0530c6ad1b1c81 Mon Sep 17 00:00:00 2001 From: Benedikt Rollik Date: Tue, 14 Oct 2025 14:44:52 +0200 Subject: [PATCH 3/4] Apply suggestions from code review --- pages/kubernetes/how-to/connect-cluster-kubectl.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/kubernetes/how-to/connect-cluster-kubectl.mdx b/pages/kubernetes/how-to/connect-cluster-kubectl.mdx index 307564ed51..04c8e69a27 100644 --- a/pages/kubernetes/how-to/connect-cluster-kubectl.mdx +++ b/pages/kubernetes/how-to/connect-cluster-kubectl.mdx @@ -81,7 +81,7 @@ For detailed information about the configuration of IAM policies for your Kubern Refer to our complete [Documentation for `scw k8s`](https://github.com/scaleway/scaleway-cli/blob/master/docs/commands/k8s.md) to learn more about all available commands to manage your Kubernetes cluster using `scw`. - + From b6333808c23b291da067d3c0b7983b4381caf0e1 Mon Sep 17 00:00:00 2001 From: Benedikt Rollik Date: Tue, 14 Oct 2025 14:56:23 +0200 Subject: [PATCH 4/4] docs(k8s): fix anchors --- pages/kubernetes/how-to/connect-cluster-kubectl.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/pages/kubernetes/how-to/connect-cluster-kubectl.mdx b/pages/kubernetes/how-to/connect-cluster-kubectl.mdx index 04c8e69a27..50edc78bba 100644 --- a/pages/kubernetes/how-to/connect-cluster-kubectl.mdx +++ b/pages/kubernetes/how-to/connect-cluster-kubectl.mdx @@ -50,7 +50,7 @@ For detailed information about the configuration of IAM policies for your Kubern You can use the Scaleway CLI to automatically retrieve (and merge) your `kubeconfig` file, then interact with your Kubernetes cluster. - ### Install and configure the Scaleway CLI + #### Install and configure the Scaleway CLI If you have not set up the Scaleway CLI yet: @@ -62,7 +62,7 @@ For detailed information about the configuration of IAM policies for your Kubern You will need your [API Key](/iam/how-to/create-api-keys/) (access key and secret key). - ### Retrieve and install the kubeconfig using scw + #### Retrieve and install the kubeconfig using scw 1. Run the following command to install the `kubeconfig` file for your cluster: ```bash