getting started with kops on scaleway

Getting started with kOps on Scaleway

Reviewed on 23 March 2023 • Published on 23 March 2023

kops
kubernetes
k8s
cluster

kOps is a tool that helps you set up and manage Kubernetes clusters for production use. It is like a version of kubectl specifically designed for managing clusters. With kOps, you can easily create, upgrade, and maintain highly available clusters. The tool also takes care of setting up the required cloud infrastructure.

Important:

Scaleway support on kOps is currently in alpha, which means that it is in the early stages of development and subject to change. Use it with caution.

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

Requirements:

You have an account and are logged into the Scaleway console
You have configured your SSH Key
You have installed kOps version >= 1.26 on your local computer
You have installedkubectl on your local computer
You have created an S3 bucket and have its credentials

Configuring environment variables

Before working on the tutorial, it is important to set the following environment variables on your local computer.

export SCW_ACCESS_KEY="my-access-key"
export SCW_SECRET_KEY="my-secret-key"
export SCW_DEFAULT_PROJECT_ID="my-project-id"
# Configure the bucket name to store kops state
export KOPS_STATE_STORE=scw://<bucket-name> # where <bucket-name> is the name of the bucket you set earlier
# Scaleway Object Storage is S3 compatible so we just override some S3 configurations to talk to our bucket
export S3_REGION=fr-par                     # or another scaleway region providing Object Storage
export S3_ENDPOINT=s3.$S3_REGION.scw.cloud  # define provider endpoint
export S3_ACCESS_KEY_ID="my-access-key"     # where <my-access-key> is the S3 API Access Key for your bucket
export S3_SECRET_ACCESS_KEY="my-secret-key" # where <my-secret-key> is the S3 API Secret Key for your bucket
# this is required since Scaleway support is currently in alpha so it is feature gated
export KOPS_FEATURE_FLAGS="Scaleway"

Creating a single master cluster using kOps

Note:

Currently you can only create a kOps cluster in a single Availability Zone (fr-par-1, fr-par-2, fr-par-3, nl-ams-1, nl-ams-2, pl-waw-1, pl-waw-2).

Create a cluster in the fr-par-1 Availability Zone, by running the following command:
```
kops create cluster --cloud=scaleway --name=mycluster.k8s.local --zones=fr-par-1 --yes
```
Note:
The default cluster uses Ubuntu images on DEV1-M machines with cilium as Container Network Interface.

Editing a cluster using kOps

Update a cluster

Run the following command to update your cluster using kOps:
```
kops update cluster mycluster.k8s.local --yes
```

Delete a cluster

Run the following command to delete your cluster using kOps:
```
kops delete cluster mycluster.k8s.local --yes
```

Going further

Now that you have a working kops cluster, read through the recommendations for production setups guide to learn more about how to configure kOps for production workloads.

For more information about kOps, refer to the official kOps documentation.