Skip to content

Commit c558413

Browse files
SamyOubouaziznerda-codesbene2k1
authored
docs(srv): add registry migration procedure MTA-5186 (#3951)
* docs(srv): add registry migration procedure MTA-5186 * docs(srv): update * docs(srv): update * Apply suggestions from code review Co-authored-by: nerda-codes <[email protected]> Co-authored-by: Benedikt Rollik <[email protected]> --------- Co-authored-by: nerda-codes <[email protected]> Co-authored-by: Benedikt Rollik <[email protected]>
1 parent dee4d81 commit c558413

File tree

4 files changed

+145
-0
lines changed

4 files changed

+145
-0
lines changed

‎menu/navigation.json‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3860,6 +3860,10 @@
38603860
{
38613861
"label": "Create and deploy a container with the Scaleway CLI",
38623862
"slug": "deploy-container-cli"
3863+
},
3864+
{
3865+
"label": "Migrate images to the Scaleway Registry",
3866+
"slug": "migrate-external-image-to-scaleway-registry"
38633867
}
38643868
],
38653869
"label": "API/CLI",
@@ -3988,6 +3992,10 @@
39883992
{
39893993
"label": "Jobs API Reference",
39903994
"slug": "https://www.scaleway.com/en/developers/api/serverless-jobs/"
3995+
},
3996+
{
3997+
"label": "Migrate images to the Scaleway Registry",
3998+
"slug": "migrate-external-image-to-scaleway-registry"
39913999
}
39924000
],
39934001
"label": "API/CLI",

‎serverless/containers/api-cli/migrate-external-image-to-scaleway-registry.mdx‎

Lines changed: 64 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,64 @@
1+
---
2+
meta:
3+
title: Migrating an external image to the Scaleway Container Registry
4+
description: Methods to migrate or import an image from an external public container registry to the Scaleway Container Registry.
5+
content:
6+
h1: Migrating an external image to the Scaleway Container Registry
7+
paragraph: Methods to migrate or import an image from an external public container registry to the Scaleway Container Registry.
8+
tags: serverless containers registry import copy migrate skopeo docker
9+
dates:
10+
validation: 2024-11-06
11+
posted: 2021-11-06
12+
categories:
13+
- serverless
14+
---
15+
16+
Serverless Containers rely on images that can be stored in the Scaleway Container Registry, or in external public registries.
17+
18+
<Macro id="container-registry-note" />
19+
20+
This page explains how to migrate images from public external container registries (such as Docker hub, Amazon container registries, GitHub Container registry, etc.) to the [Scaleway Container registry](/containers/container-registry/#container-registry).
21+
22+
<Macro id="requirements" />
23+
24+
- A Scaleway account logged into the [console](https://console.scaleway.com)
25+
- [Owner](/identity-and-access-management/iam/concepts/#owner) status or [IAM permissions](/identity-and-access-management/iam/concepts/#permission) allowing you to perform actions in the intended Organization
26+
- A valid [API key](/identity-and-access-management/iam/how-to/create-api-keys/)
27+
- Created a [Container Registry namespace](/containers/container-registry/how-to/create-namespace/)
28+
29+
## Import images using Docker
30+
31+
1. Install the Docker Engine by following the [official documentation](https://docs.docker.com/engine/install/).
32+
33+
2. Login to your Scaleway Container Registry namespace with the Docker CLI by following [this procedure](/containers/container-registry/how-to/connect-docker-cli/).
34+
35+
3. Run the command below to pull, tag, then push the public image to your Scaleway Registry namespace. Make sure to replace the namespace name, and the image name by the appropriate values:
36+
```
37+
docker pull alpine:latest
38+
docker tag alpine:latest rg.fr-par.scw.cloud/my-namespace/alpine:latest
39+
docker push rg.fr-par.scw.cloud/my-namespace/alpine:latest
40+
```
41+
42+
4. Your image now appears in the [Container Registry section](https://console.scaleway.com/registry/namespaces) of the Scaleway console, in the namespace specified above.
43+
44+
## Import images using Skopeo
45+
46+
[Skopeo](https://github.com/containers/skopeo) is a command line utility that allows you to perform various operations on container images and registries, such as image copy, inspection, deletion, etc.
47+
48+
1. Install Skopeo by referring to the [official documentation](https://github.com/containers/skopeo/blob/main/install.md).
49+
50+
2. Run the command below to log in to the Scaleway Container Registry. Make sure to specify the desired region:
51+
52+
```
53+
skopeo login rg.fr-par.scw.cloud -u nologin -p $SCW_SECRET_KEY
54+
```
55+
56+
3. Run the command below to copy an image from an external registry to the Scaleway Registry. Make sure to replace the registry, namespace and image names by the appropriate values:
57+
58+
```
59+
skopeo copy --override-os \
60+
linux docker://docker.io/alpine:latest \
61+
docker://rg.fr-par.scw.cloud/my-namespace/alpine:latest
62+
```
63+
64+
4. Your image now appears in the [Container Registry section](https://console.scaleway.com/registry/namespaces) of the Scaleway console, in the namespace specified above.

‎serverless/jobs/api-cli/index.mdx‎

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
---
2+
meta:
3+
title: Serverless Jobs - API/CLI Documentation
4+
description: API and CLI reference for Scaleway Serverless Jobs.
5+
content:
6+
h1: Serverless Jobs API/CLI Documentation
7+
paragraph: API and CLI reference for Scaleway Serverless Jobs.
8+
---
9+

‎serverless/jobs/api-cli/migrate-external-image-to-scaleway-registry.mdx‎

Lines changed: 64 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,64 @@
1+
---
2+
meta:
3+
title: Migrating an external image to the Scaleway Container Registry
4+
description: Methods to migrate or import an image from an external public container registry to the Scaleway Container Registry.
5+
content:
6+
h1: Migrating an external image to the Scaleway Container Registry
7+
paragraph: Methods to migrate or import an image from an external public container registry to the Scaleway Container Registry.
8+
tags: serverless jobs registry import copy migrate skopeo docker
9+
dates:
10+
validation: 2024-11-06
11+
posted: 2021-11-06
12+
categories:
13+
- serverless
14+
---
15+
16+
Serverless Jobs rely on container images. These images can be stored in the Scaleway Container Registry, or in external public registries.
17+
18+
<Macro id="container-registry-note" />
19+
20+
This page explains how to migrate images from public external container registries (such as Docker hub, Amazon container registries, GitHub Container registry, etc.) to the [Scaleway Container registry](/containers/container-registry/#container-registry).
21+
22+
<Macro id="requirements" />
23+
24+
- A Scaleway account logged into the [console](https://console.scaleway.com)
25+
- [Owner](/identity-and-access-management/iam/concepts/#owner) status or [IAM permissions](/identity-and-access-management/iam/concepts/#permission) allowing you to perform actions in the intended Organization
26+
- A valid [API key](/identity-and-access-management/iam/how-to/create-api-keys/)
27+
- Created a [Container Registry namespace](/containers/container-registry/how-to/create-namespace/)
28+
29+
## Import images using Docker
30+
31+
1. Install the Docker Engine by following the [official documentation](https://docs.docker.com/engine/install/).
32+
33+
2. Login to your Scaleway Container Registry namespace with the Docker CLI by following [this procedure](/containers/container-registry/how-to/connect-docker-cli/).
34+
35+
3. Run the command below to pull, tag, then push the public image to your Scaleway Registry namespace. Make sure to replace the namespace name, and the image name by the appropriate values:
36+
```
37+
docker pull alpine:latest
38+
docker tag alpine:latest rg.fr-par.scw.cloud/my-namespace/alpine:latest
39+
docker push rg.fr-par.scw.cloud/my-namespace/alpine:latest
40+
```
41+
42+
4. Your image now appears in the [Container Registry section](https://console.scaleway.com/registry/namespaces) of the Scaleway console, in the namespace specified above.
43+
44+
## Import images using Skopeo
45+
46+
[Skopeo](https://github.com/containers/skopeo) is a command line utility that allows you to perform various operations on container images and registries, such as image copy, inspection, deletion, etc.
47+
48+
1. Install Skopeo by referring to the [official documentation](https://github.com/containers/skopeo/blob/main/install.md).
49+
50+
2. Run the command below to log in to the Scaleway Container Registry. Make sure to specify the desired region:
51+
52+
```
53+
skopeo login rg.fr-par.scw.cloud -u nologin -p $SCW_SECRET_KEY
54+
```
55+
56+
3. Run the command below to copy an image from an external registry to the Scaleway Registry. Make sure to replace the registry, namespace and image names by the appropriate values:
57+
58+
```
59+
skopeo copy --override-os \
60+
linux docker://docker.io/alpine:latest \
61+
docker://rg.fr-par.scw.cloud/my-namespace/alpine:latest
62+
```
63+
64+
4. Your image now appears in the [Container Registry section](https://console.scaleway.com/registry/namespaces) of the Scaleway console, in the namespace specified above.

0 commit comments

Comments
 (0)