Container Registry - Quickstart

Scaleway Container Registry is a fully-managed mutualized container registry, designed to facilitate the storage, management, and deployment of container images. The service simplifies the development-to-production workflow, as there is no need to operate your own Container Registry or worry about the underlying infrastructure. You can create your Container Registry namespace, connect it to the Docker CLI, then use Docker to push and pull images to and from your registry. When you no longer need an image, you can delete it from your Container Registry.

Before you start

To complete the actions presented below, you must have:

• A Scaleway account logged into the console
• Owner status or IAM permissions allowing you to perform actions in the intended Organization

How to create a Container Registry namespace

1. Click Container Registry in the Containers section of the Scaleway console side menu. If you do not have a Registry already created, the product creation page is displayed.

2. Click Create namespace to launch the namespace creation wizard.

3. Enter the following required information for your namespace:

   • A Name for the namespace
   • A Description of the namespace
   • The geographical Region of the namespace
   • The namespace’s Privacy Policies
   Note

   A namespace can either be public or private. Anyone will be able to pull container images from a public namespace. Privacy policies may be set at image level.

4. Click Create namespace to create the namespace.

How to connect your namespace to the Docker CLI

Before you start

To complete the actions presented below, you must have:

• Installed Docker on your local computer
• Generated your API key

1. Click Container Registry in the Containers section of the Scaleway console side menu. The Container Registry namespaces dashboard displays.

2. Click «See more Icon», then Push instructions next to the namespace you want to push to. A pop-up displays.

3. Copy the push instructions. Then click X to close the pop-up.

4. Open a terminal window on your local computer. Then log into the namespace by running the following command from the terminal:

   echo <SCW_SECRET_KEY> | docker login rg.fr-par.scw.cloud/<NAMESPACE> -u nologin --password-stdin
   

   Important

   Replace <SCW_SECRET_KEY> with your API secret key and <NAMESPACE> with the name of your namespace.

   Once logged in, a confirmation is displayed:

   Login Succeeded
   

You are now logged in and ready to push and pull images to and from your Container Registry with Docker.

How to push an image to your Container Registry namespace

1. Open a terminal window on your local computer.
2. Pull the latest release of the Ubuntu docker image:

   docker pull ubuntu:latest
   

3. Tag the image:

   docker tag ubuntu:latest rg.fr-par.scw.cloud/mynamespace/ubuntu:latest
   

4. Push the image to your Container Registry namespace using docker:

   docker push rg.fr-par.scw.cloud/mynamespace/ubuntu:latest
   

How to pull an image from your Container Registry namespace

1. Click Container Registry in the Containers section of the side menu. A list of your namespaces displays.
2. Click the namespace you want to pull an image from.
3. Click «See more Icon», then Pull Instructions next to the image you want to pull. A pop-up displays.
4. Copy the command line instructions to pull the image with Docker. Then click OK to close the pop-up.
5. Open a terminal window and paste the instructions into it to pull the image.