Scaleway Elements Container Registry

Scaleway Elements Container Registry Overview

Scaleway Elements Container Registry is a fully-managed mutualized container registry, designed to facilitate storing, managing and deploying container images. The service simplifies the development to production workflow as there is no need to operate an own container registry or to worry about the underlying infrastructure. A container image consists of several bundled files, which encapsulate an application. An image can be build on one machine, then uploaded to the container registry. The same application is distributed and can be deployed on multiple hosts.

Requirements

Core Concept

Registry: A Registry is a service which stores container images.

Namespace: Namespaces allow managing repositories in a simple, clear and human-readable way. A namespace is a collection of container images having a unique identifier (each Namespace can only exist one time). A namespace belongs to a user, responsible for configuring the push and pull permissions.

Image: Container images are files that include all the requirements and instructions of a complete and executable version of an application. When running an image, it becomes one or multiple instances of that application. You can pull the image instructions, edit its settings, view its versions or delete it.

Creating a Namespace

In the Tools section of the side menu, click Container Registry. If you do not have a Registry already created, the product presentation is displayed.

Click on Create a namespace to configure a new namespace.

Naming and Tagging the Namespace

Edit the following information about the namespace:

  • The Namespaces name
  • A description for the Namespace (optional)

Choosing a Region

You can choose a region in which your namespace will be deployed geographically. Currently we provide the following locations:

  • FR-PAR: Paris, France
  • NL-AMS: Amsterdam, The Netherlands

Configuring Namespace Privacy Policies

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

Deploying the Namespace

Click the Create a namespace button. This action launches the namespace creation.

Connecting Docker CLI to the Namespace

To use the namespace, make sure Docker is installed on the local computer.

1 . Retrieve the push instructions for the namespace by clicking on > Push instructions:

2 . Log into the Namespace by running the following command from the command line:

docker login rg.fr-par.scw.cloud/mynamespace -u nologin -p TOKEN

Important: Replace TOKEN with the Secret Key of an API token and mynamespace with the name of your Namespace.

3 . Once logged in, a confirmation is displayed:

Login Succeeded

Pushing a first Image

1 . Pull the latest release of the Ubuntu docker image:

docker pull ubuntu:latest

2 . Tag the image:

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

3 . Push the image to the registry using docker:

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

Important: Replace mynamespace in the examples abouve with the name of your namespace.

Listing Images

1 . Click on the identifier of the namespace to list its images:

2 . The list of images stored within the namespace displays:

Pulling Images

1 . Click on > Pull instructions to display pull instructions for an image:

2 . A popup displays the command line instructions to pull the image with docker:

3 . Copy the instructions and paste them into a terminal window to pull the image.

Displaying Image Versions

Scaleway Elements Container Registry supports versioning of files so you can distribute several releases of an image.

1 . Click on > Versions to display a list of available versions of the image:

2 . A list of all available versions of the image is displayed:

3 . To view pull instructions for a specific version, click on next to the version, then Pull instructions.

If a specific version is no longer required, click on > Delete next to the identifier to delete it.

Managing Images Privacy Settings

The image privacy policies specify whether everyone is granted to pull a container image or not.

To update this policies, click on * next to the container image name, then on Privacy Policies.

The setting can either be Public, Private or Inherance from namespace policy.

Click on Update privacy policies to modify the policies.

Deleting Images

To delete an image, click on next to the image name, then on Delete.

Confirm the deletion of the image in the pop-up. This action is irreversible and all your data stored in the image will be deleted.

Managing Namespace Security Policies

The Namespace privacy policies specify whether everyone is granted to pull a container image or not. Everyone will be able to pull container images from a public namespace.

To update the Namespace privacy policies, click on the Namespace Settings tab, then configure the policy by clicking on Public or Private.

Important: Each container image may have its own privacy policies.

Deleting the Namespace

It is possible to delete a namespace from the Namespaces list, by clicking on > Delete.

A namespace can also be deleted from the Namespace Settings tab, by clicking on the Delete namespace Button.

This action is irreversible and all your data associated with this namespace will be deleted.

Going Further?

For more information, you may refer to the official API documentation and the product FAQ.

Discover a New Cloud Experience

Deploy SSD Cloud Servers in seconds.