Container Registry API completes the docker command line to allow you to fully manage your namespaces, images and tags.
A Registry is a service which stores docker images. Container Registry proposes one registry per region (currently nl-ams and fr-par)
Please note that examples below are using nl-ams
for creating namespace in Amsterdam region , but you may also use Paris region fr-par
or pl-waw
by replacing it in the curl. Export the value for SCALEWAY_TOKEN
and SCALEWAY_ORG
in the environment variable with your corresponding value accordingly.
For docker registry, change the hostname from rg.nl-ams.scw.cloud
to rg.fr-par.scw.cloud
or rg.pl-waw.scw.cloud
.
Create a namespace:
Push an image:
A namespace is for images what a folder is for files
To use our services, the first step is to create a namespace.
A namespace is for images what a folder is for files. Every push or pull must mention the namespace :
docker pull rg.nl-ams.scw.cloud/<namespace_name>/<image_name>:<tag_name>
Note that a namespace name is unique on a region. Thus, if another client already has created "test", you can't have it as a namespace
A namespace can be either public or private (default), which determines who can pull images.
20
.created_at_asc
, created_at_desc
, description_asc
, description_desc
, name_asc
and name_desc
. The default value is created_at_asc
.organization_id
and project_id
may be set.organization_id
and project_id
may be set.unknown
, ready
, deleting
, error
and locked
. The default value is unknown
.Get the namespace associated with the given id.
unknown
, ready
, deleting
, error
and locked
. The default value is unknown
.Update the namespace associated with the given id.
unknown
, ready
, deleting
, error
and locked
. The default value is unknown
.Delete the namespace associated with the given id.
unknown
, ready
, deleting
, error
and locked
. The default value is unknown
.An image represents a container image.
The visibility of an image can be public (everyone can pull it), private (only your organization can pull it) or inherit from the namespace visibility (default) It can be changed with an update on the image via the registry API.
20
.created_at_asc
, created_at_desc
, name_asc
and name_desc
. The default value is created_at_asc
.Get the image associated with the given id.
unknown
, ready
, deleting
, error
and locked
. The default value is unknown
.visibility_unknown
, inherit
, public
and private
. The default value is visibility_unknown
.Update the image associated with the given id.
unknown
, ready
, deleting
, error
and locked
. The default value is unknown
.visibility_unknown
, inherit
, public
and private
. The default value is visibility_unknown
.Delete the image associated with the given id.
unknown
, ready
, deleting
, error
and locked
. The default value is unknown
.visibility_unknown
, inherit
, public
and private
. The default value is visibility_unknown
.A tag represents a container tag of an image.
20
.created_at_asc
, created_at_desc
, name_asc
and name_desc
. The default value is created_at_asc
.Get the tag associated with the given id.
unknown
, ready
, deleting
, error
and locked
. The default value is unknown
.Delete the tag associated with the given id.
unknown
, ready
, deleting
, error
and locked
. The default value is unknown
.