Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
80 changes: 47 additions & 33 deletions pages/kubernetes/how-to/connect-cluster-kubectl.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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 <cluster-id>
```
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.

<Message type="tip">
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`.
</Message>
<Tabs id="connect-cluster">
<TabsTab label="Using the Scaleway console">
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 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 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.
</TabsTab>
<TabsTab label="Using the Scaleway CLI">
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 <cluster-id>
```
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.

<Message type="tip">
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`.
</Message>
</TabsTab>
</Tabs>


## Revoking user access to the Kubernetes cluster
Expand Down