NavigationContentFooter
Jump toSuggest an edit

Container Registry - Quickstart

Reviewed on 08 January 2024Published on 26 May 2021

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.

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.

Requirements
  • You have an account and are logged into the Scaleway console

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

Requirements
  • You have installed Docker on your local computer
  • You have 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:

    docker login rg.fr-par.scw.cloud/mynamespace -u nologin -p [SCW_SECRET_KEY]
    Important

    Replace [SCW_SECRET_KEY] with your API secret key and mynamespace 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

Note

We use an Ubuntu image as an example here.

  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
Important

Replace mynamespace in the examples above with the name of your namespace.

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.
Note

The current configuration allows you up to 20 pulls/min per image.

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