Artifact Registry est un service universel de gestion de packages compatible avec les conteneurs et d'autres formats. Découvrez comment effectuer une transition depuis Container Registry pour plus de flexibilité et de contrôle sur vos artefacts.

Guide de démarrage rapide pour Container Registry

Container Registry est un registre privé d'images de conteneurs qui s'exécute sur Google Cloud.

Ce guide de démarrage rapide vous montre comment :

  • Configurer l'authentification
  • Stocker une image dans le registre Container Registry de votre projet
  • sortir l'image du registre Container Registry de votre projet.

Pour les commandes de ce guide de démarrage rapide, vous pouvez vous servir de Cloud Shell ou de n'importe quel environnement dans lequel le SDK Cloud est installé. Cloud Shell inclut une version stable récente de Docker.

Avant de commencer

  1. Connectez-vous à votre compte Google.

    Si vous n'en possédez pas déjà un, vous devez en créer un.

  2. Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.

    Accéder à la page de sélection du projet

  3. Assurez-vous que la facturation est activée pour votre projet Cloud. Découvrez comment vérifier que la facturation est activée pour votre projet.

  4. Activez l'API Container Registry.

    Activer l'API

  5. Installez et initialisez le SDK Cloud.
  6. Si vous n'utilisez pas Cloud Shell pour ce guide de démarrage rapide, installez Docker.

    Si vous utilisez un système d'exploitation Linux, tel qu'Ubuntu ou Debian, ajoutez votre nom d'utilisateur au groupe docker afin de pouvoir exécuter Docker sans utiliser sudo :

    sudo usermod -a -G docker ${USER}

    Déconnectez-vous et reconnectez-vous pour que les modifications apportées à la liste des membres du groupe soient appliquées. Si vous utilisez une machine virtuelle, vous devrez peut-être la redémarrer pour que ces modifications prennent effet.

  7. Ouvrez Docker. Pour vérifier que Docker est en cours d'exécution, utilisez la commande Docker suivante, qui renvoie la date et l'heure actuelles :
  8. docker run busybox date

Configurer l'authentification

Avant de pouvoir stocker ou extraire des images, vous devez configurer Docker afin qu'il se serve de l'outil de ligne de commande gcloud pour authentifier les requêtes envoyées à Container Registry. Pour ce faire, exécutez la commande suivante (vous n'avez besoin de l'exécuter qu'une seule fois) :

gcloud auth configure-docker

Obtenir une image à stocker

Pour ce guide de démarrage rapide, vous allez stocker un exemple d'image nommée hello-app.

  1. Définissez le répertoire dans lequel vous souhaitez enregistrer l'image.
  2. Exécutez la commande suivante pour extraire la version 1.0 de l'image.

    docker pull gcr.io/google-samples/hello-app:1.0
    

Ajouter l'image dans Container Registry

Ajouter un tag de nom de registre à l'image

Avant de stocker l'image Docker dans Container Registry, vous devez lui ajouter un tag correspondant à son nom de registre. Cette action permet de configurer la commande docker push grâce à laquelle vous pouvez stocker l'image dans un emplacement précis. L'emplacement d'hôte utilisé dans ce guide de démarrage rapide est gcr.io.

Exécutez la commande suivante pour ajouter des tags à l'image en tant que quickstart-image:tag1 :

docker tag gcr.io/google-samples/hello-app:1.0 gcr.io/PROJECT_ID/quickstart-image:tag1

Remplacez l'élément suivant :

  • PROJECT-ID est l'ID du projet dans Google Cloud Console, que vous devez ajouter à la commande. Si l'ID du projet contient le signe deux-points (:), consultez la section Projets à l'échelle du domaine.
  • gcr.io correspond au nom d'hôte.
  • quickstart-image est le nom de l'image Docker.
  • tag1 est un tag que vous ajoutez à l'image Docker. Si vous ne spécifiez pas de tag, Docker applique le tag par défaut latest.

Vous êtes maintenant prêt à stocker votre image dans Container Registry.

Stocker l'image dans Container Registry

Une fois que vous avez configuré l'authentification et tagué l'image locale, vous pouvez stocker l'image dans le dépôt que vous avez créé.

Pour stocker l'image Docker, exécutez la commande suivante :

docker push gcr.io/PROJECT_ID/quickstart-image:tag1

PROJECT_ID est l'ID du projet dans Google Cloud Console. Si l'ID du projet contient le signe deux-points (:), consultez la section Projets à l'échelle du domaine.

Lorsque vous stockez une image dans un nouvel emplacement hôte, le service crée un bucket de stockage sous-jacent unique pour votre projet. Vous pouvez afficher les images hébergées par Container Registry en accédant à Cloud Console ou en saisissant le nom du registre de l'image dans votre navigateur Web : http://gcr.io/PROJECT_ID/quickstart-image.

Extraire l'image de Container Registry

Pour extraire l'image de Container Registry vers votre ordinateur local, exécutez la commande suivante :

docker pull gcr.io/PROJECT_ID/quickstart-image:tag1

Remplacez PROJECT_ID par l'ID de votre projet Google Cloud Console. Si l'ID du projet contient le signe deux-points (:), consultez la section Projets à l'échelle du domaine.

Le résultat doit être semblable à ceci :

latest: Pulling from my-project/quickstart-image:tag1
Digest: sha256:70c42...
Status: Image is up to date for gcr.io/my-project/quickstart-image:tag1

Effectuer un nettoyage

Afin d'éviter que des frais ne soient facturées sur votre compte Google Cloud pour les ressources utilisées dans ce guide de démarrage rapide :

Exécutez la commande suivante pour supprimer l'image Docker de Container Registry.

gcloud container images delete gcr.io/PROJECT_ID/quickstart-image:tag1 --force-delete-tags

Remplacez PROJECT_ID par l'ID de votre projet Google Cloud Console. Si l'ID du projet contient le signe deux-points (:), consultez la section Projets à l'échelle du domaine.

Étapes suivantes