Jump toUpdate content

Quickstart

Reviewed on 26 May 2021Published on 26 May 2021

Scaleway Container Registry is a fully-managed mutualised 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 to 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.

Requirements:

How to create a Container Registry namespace

  1. Click Container Registry in the Tools 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 a namespace to launch the namespace creation wizard.

  3. Enter the following required information for your namespace:

    • The 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 a namespace to create the namespace.

How to connect your namespace to the Docker CLI

Requirements:
  1. Click Container Registry in the Tools 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 OK 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 Tools section ofthe 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.