> For the complete documentation index, see [llms.txt](https://docs.edgegap.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.edgegap.com/fr/learn/advanced-features/edgegap-container-registry.md).

# registre de conteneurs

Stockez les images de vos conteneurs de serveur de jeu dans le registre intégré gratuit d’Edgegap, prêtes à être déployées sur le réseau edge mondial.

Maintenant que vous savez utiliser notre plateforme, vous devez conteneuriser votre serveur de jeu. Vous aurez besoin d'un emplacement pour stocker vos images de conteneur afin qu'elles soient accessibles lors du déploiement de vos serveurs de jeu.

C'est pourquoi nous avons créé le registre de conteneurs Edgegap. Il s'agit d'un dépôt de conteneurs géré en privé qui fonctionne un peu comme les registres publics de conteneurs standard, mais avec l'avantage supplémentaire d'une sécurité renforcée, d'analyses de vulnérabilités et d'autres atouts ! Grâce à la haute disponibilité et à l'intégration au tableau de bord, vous passerez moins de temps à apprendre de nouveaux outils, et vos serveurs seront toujours prêts à l'emploi.

### Obtenir vos identifiants

Pour envoyer des images, vous devrez d'abord vous authentifier auprès de notre registre, et pour cela, vous avez besoin d'identifiants. Trouvez l' `Registre de conteneurs` onglet dans la `Service` section pour demander vos identifiants dans la barre latérale. À partir de là, vous pouvez demander l'accès à notre registre.

<figure><img src="https://3008966946-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2Fgit-blob-323308a355e5937e7bcd4dfdbf75cd0d4517ac86%2Frequest-access.png?alt=media" alt=""><figcaption></figcaption></figure>

Dans la boîte en bas de l'écran, vous trouverez tout ce dont vous avez besoin pour vous connecter au registre et envoyer vos images de conteneur.

<figure><img src="https://3008966946-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2Fgit-blob-ed6f68d538b2ea4944d14989c82351b09dc3914c%2Fregistry-project-info.png?alt=media" alt=""><figcaption></figcaption></figure>

| Champ             | Description                                                                                                |
| ----------------- | ---------------------------------------------------------------------------------------------------------- |
| URL               | L'URL de notre registre de conteneurs. Vous devrez l'utiliser lors de la connexion et de l'envoi d'images. |
| Projet            | Le nom de votre projet attribué. Vous devez l'inclure dans le chemin de votre dépôt d'images.              |
| Nom d'utilisateur | Le nom d'utilisateur à utiliser lors de la connexion au registre.                                          |
| Jeton             | Le mot de passe à utiliser lors de la connexion au registre.                                               |

Connectez-vous au registre avec Docker, en utilisant le nom de projet de votre registre, votre nom d'utilisateur et votre jeton :

{% tabs %}
{% tab title="Bash (Linux)" %}

```bash
project='<REGISTRY_PROJECT>';
username='robot$<REGISTRY_ORGANIZATION_ID>+client-push';
token='<REGISTRY_TOKEN>';

echo "$token" | docker login registry.edgegap.com -u "$username" --password-stdin 2>&1
```

{% endtab %}

{% tab title="PowerShell (Windows)" %}

```powershell
$project = '<REGISTRY_PROJECT>'
$username = 'robot$<REGISTRY_ORGANIZATION_ID>+client-push'
$token = '<REGISTRY_TOKEN>'

echo "$token" | docker login registry.edgegap.com -u "$username" --password-stdin 2>&1
```

{% endtab %}
{% endtabs %}

### Avertissement de connexion Docker

{% code collapsedlinecount="10" %}

```
AVERTISSEMENT ! Votre mot de passe sera stocké non chiffré dans /home/user/.docker/config.json.
```

{% endcode %}

Vous pouvez configurer le magasin d'identifiants en suivant [cette configuration](https://docs.docker.com/engine/reference/commandline/login/#credentials-store). N'oubliez pas que cet avertissement correspond au comportement normal de Docker.

C'est **important** de comprendre que le nom d'utilisateur de votre robot, ainsi que le jeton de votre dépôt privé, sont encodés en base64 sur votre machine à ce chemin `$HOME/.docker/config.json`. Toute personne ayant accès à ce fichier peut facilement déchiffrer le jeton de votre compte robot à l'aide d'un décodeur base64. Assurez-vous que l'environnement `docker login registry.edgegap.com` que vous utilisez est sûr et que les autorisations d'accès à ce fichier sont restreintes.

Pour supprimer vos identifiants de ce fichier, vous pouvez simplement utiliser `docker logout registry.edgegap.com` chaque fois que vous envoyez et récupérez vos images privées.

### Envoi d'une image au registre

Si vous avez besoin d'aide pour conteneuriser votre projet, consultez [notre documentation sur ce sujet](https://docs.edgegap.com/fr/docs/tools-and-integrations/docker.md) pour bien démarrer.

Tout d'abord, vous devez ajouter une étiquette à votre image correspondant au registre. Ensuite, puisque vous êtes connecté au registre, il vous suffit d'envoyer votre image vers l'URL et le projet indiqués sur la page :

{% code collapsedlinecount="10" %}

```bash
docker image tag <IMAGE_NAME>:<TAG> registry.edgegap.com/<PROJECT_NAME>/<IMAGE_NAME>:<TAG>
docker push registry.edgegap.com/<PROJECT_NAME>/<IMAGE_NAME>:<TAG>
```

{% endcode %}

Vous pouvez envoyer autant d'images que votre espace de stockage le permet et les répartir dans différents dépôts comme bon vous semble. Cependant, vous devriez lire la section « Modèles d'application » avant d'envoyer trop d'images !

Vous retrouverez ensuite vos dépôts sur la même page après l'avoir actualisée.

### Attribuer plusieurs fois des étiquettes au même artefact de build (envoyer un doublon d'image)

Si vous envoyez le même artefact de build deux fois, et que la valeur de l'étiquette est la même, aucun changement ne sera effectué.

Si vous envoyez le même artefact de build deux fois, avec deux valeurs d'étiquette différentes, aucun espace de stockage supplémentaire ne sera consommé et notre registre créera simplement la nouvelle étiquette pointant vers le même artefact de build.

### Gérer vos images

Vous pouvez voir vos dépôts en vous rendant sur la même page après avoir envoyé au moins une image.

En cliquant sur l'un de ces dépôts, vous pouvez voir les images qu'il contient, regroupées par artefact. Si vous avez étiqueté la même image avec deux étiquettes différentes et que vous les avez envoyées au registre, vous les verrez comme un seul et même artefact.

<figure><img src="https://3008966946-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2Fgit-blob-0a4a754f4b880aa351d7a77ff94cad5335a59831%2Fartifact-list.png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3008966946-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2Fgit-blob-7afcf8e2f1ef701a0b2dc7aa8d54b56529f7c6eb%2Fartifact-list-2.png?alt=media" alt=""><figcaption></figcaption></figure>

Les images étiquetées `1.0.1` et `1.0.2` dans l'image ci-dessus ont le même artefact. L'image étiquetée `1.0.3`, en revanche, a un artefact différent.

{% hint style="warning" %}
Si vous supprimez un artefact, vous supprimerez également les étiquettes qui y sont associées. La boîte de dialogue de confirmation listera toutes les étiquettes que cette action supprimerait afin de garantir que vous ne supprimiez pas accidentellement des ressources nécessaires.
{% endhint %}

### Supprimer des artefacts de build via l'API

Si l'interface du tableau de bord est trop lente pour vous, ou si vous avez besoin d'un pipeline d'intégration continue automatisé qui supprimerait automatiquement vos artefacts de build obsolètes afin de maintenir l'utilisation de votre registre dans les limites, envisagez d'utiliser notre API du registre de conteneurs. Notre [API du registre de conteneurs](https://docs.edgegap.com/fr/docs/api.md) permet de lister toutes les étiquettes d'une application (image) donnée, ainsi que de supprimer des étiquettes individuelles. Étant donné que chaque artefact d'image (build) peut avoir plusieurs étiquettes associées en même temps (comme `v1.1.0`, `dev`, `latest`, ou plus), vous devrez supprimer toutes les étiquettes associées à un artefact spécifique afin de libérer de l'espace dans votre registre de conteneurs Edgegap.

### Demander plus de stockage

Lorsque votre demande d'accès au registre aura été approuvée, un certain espace de stockage vous sera alloué dans le registre.

Vous pouvez demander de l'espace supplémentaire en cliquant sur le bouton « Demander plus de stockage » à côté de l'indicateur d'utilisation de l'espace.

<figure><img src="https://3008966946-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2Fgit-blob-81bdfd593994140a1a5a5f915b5e1242b32ef8fb%2Frequest-more-storage.png?alt=media" alt=""><figcaption></figcaption></figure>

Lorsqu'un membre du personnel aura approuvé votre demande, vous disposerez de plus d'espace pour envoyer vos images.

### Étapes suivantes

Apprenez à conteneuriser votre application grâce à notre guide : [Bien démarrer avec Docker](https://docs.edgegap.com/fr/docs/tools-and-integrations/docker.md).
