Sidebar navigationMain contentFooter
Jump toContribute on Github

Getting started with kOps on Scaleway

Reviewed on 25 September 2023Published 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.


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)

To perform certain actions described below, you must either be the Owner of the Organization in which the actions will be performed, or an IAM user with the necessary permissions.

  • 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.$ # 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


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

    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.

Cloud Products & Resources
  • Scaleway Console
  • Compute
  • Storage
  • Network
  • IoT
  • AI
Dedicated Products & Resources
  • Dedibox Console
  • Dedibox Servers
  • Network
  • Web Hosting
  • Blog
  • Careers
  • Scaleway Learning
Scaleway Docs
Follow us
ContractsLegal NoticePrivacy PolicyCookie PolicyDocumentation license
© 1999-2024 – Scaleway SAS