Gérer les images

Cette page explique comment gérer les images de conteneurs dans un dépôt Docker. La gestion des images comprend l'établissement de la liste des images dans un dépôt, l'ajout de tags, la suppression de tags, la copie d'images dans un nouveau dépôt et la suppression d'images.

Pour en savoir plus sur le transfert et l'extraction d'images, consultez Transférer et extraire des images.

Avant de commencer

1. Si le dépôt cible n'existe pas, créez un dépôt.
2. Vérifiez que vous disposez des autorisations requises pour le dépôt.
3. (Facultatif) Configurez des valeurs par défaut pour les commandes gcloud.

Rôles requis

Pour obtenir les autorisations nécessaires pour gérer les images, demandez à votre administrateur de vous accorder les rôles IAM suivants sur le dépôt :

• Afficher les images, les fichiers dans les images et les tags : Lecteur Artifact Registry (roles/artifactregistry.reader)
• Taguer des images ou modifier des tags à l'aide d'Artifact Registry : Rédacteur Artifact Registry (roles/artifactregistry.writer)
• Supprimer des images ou des tags : Administrateur de dépôts Artifact Registry (roles/artifactregistry.repoAdmin)

Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.

Répertorier des images

Modes de dépôt : standard, distant

Vous pouvez lister les images à l'aide de Google Cloud console ou de gcloud CLI.

gcloud artifacts docker images list

gcloud artifacts docker images list LOCATION-docker.pkg.dev/PROJECT/REPOSITORY

gcloud artifacts docker images list LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE \
--include-tags

us-west1-docker.pkg.dev/my-project/my-repo

us-west1-docker.pkg.dev/my-project/my-repo/my-image

Lister les fichiers

Modes de dépôt : standard, distant

Vous pouvez lister les fichiers d'un dépôt, les fichiers de toutes les versions d'une image de conteneur spécifiée ou les fichiers d'une version spécifique d'une image.

Pour toutes les commandes suivantes, vous pouvez définir un nombre maximal de fichiers à renvoyer en ajoutant l'option --limit à la commande.

Pour répertorier tous les fichiers dans le projet, le dépôt et l'emplacement par défaut lorsque les valeurs par défaut sont configurées :

gcloud artifacts files list

Pour lister les fichiers d'un projet, d'un dépôt et d'un emplacement spécifiques, exécutez la commande suivante :

gcloud artifacts files list \
    --project=PROJECT \
    --repository=REPOSITORY \
    --location=LOCATION

Pour lister les fichiers de toutes les versions d'une image de conteneur spécifique :

gcloud artifacts files list \
    --project=PROJECT \
    --repository=REPOSITORY \
    --location=LOCATION \
    --package=PACKAGE

Pour lister les fichiers d'une version spécifique d'image de conteneur :

gcloud artifacts files list \
    --project=PROJECT \
    --repository=REPOSITORY \
    --location=LOCATION \
    --package=PACKAGE \
    --version=VERSION

gcloud artifacts files list \
    --project=PROJECT \
    --repository=REPOSITORY \
    --location=LOCATION \
    --package=PACKAGE \
    --tag=TAG

Remplacez les valeurs suivantes :

• LOCATION : emplacement régional ou multirégional du dépôt.
• PROJECT : ID de votre projet Google Cloud . Si l'ID du projet contient le signe deux-points (:), consultez la section Projets à l'échelle du domaine.
• REPOSITORY : nom du dépôt où l'image est stockée.
• PACKAGE : nom de l'image.
• VERSION : condensé de l'image, chaîne commençant par sha256:.
• TAG : tag associé à l'image du conteneur.

Exemples

Prenons l'exemple des informations suivantes sur une image :

• Projet : my-project
• Dépôt : my-repo
• Emplacement du dépôt : us-west1
• Image : my-app

La commande suivante liste tous les fichiers du dépôt my-repo à l'emplacement us-west1 dans le projet par défaut :

gcloud artifacts files list \
    --location=us-west1 \
    --repository=my-repo

gcloud artifacts files list \
    --project=my-project \
    --location=us-west1 \
    --repository=my-repo \
    --package=my-app \
    --version=sha256:88b205d7995332e10e836514fbfd59ecaf8976fc15060cd66e85cdcebe7fb356

gcloud artifacts files list \
    --project=my-project \
    --location=us-west1 \
    --repository=my-repo \
    --package=my-app \
    --tag=1.0-dev

Ajouter des tags à des images

Vous pouvez ajouter des tags aux images existantes dans un dépôt Artifact Registry ou avant de les transférer vers un dépôt.

Ajouter des tags aux images d'un dépôt

Modes de dépôt : standard

Vous pouvez ajouter un tag à une image dans un dépôt Artifact Registry à l'aide deGoogle Cloud console ou de la ligne de commande. Dans un dépôt, les tags sont uniques à une version d'une image. Par conséquent, si vous avez plusieurs versions d'une image, chaque tag ne s'appliquera qu'à une seule version. Si vous ajoutez à une image un tag déjà utilisé, celui-ci est déplacé de la version originale vers la version nouvellement taguée.

gcloud artifacts docker tags add IMAGE-VERSION TAG

gcloud artifacts docker tags add \
us-west1-docker.pkg.dev/my-project/my-repo/my-image:iteration6-final \
us-west1-docker.pkg.dev/my-project/my-repo/my-image:release-candidate

Ajouter des tags à des images locales

Pour transférer une image locale vers Artifact Registry, vous devez d'abord lui ajouter un tag correspondant à son nom de dépôt, puis transférer l'image. Pour obtenir des instructions, consultez la page Tranféfer et extraire.

Supprimer des tags d'images

Modes de dépôt : standard

Vous pouvez supprimer un tag d'une image dans Artifact Registry à l'aide deGoogle Cloud console ou de la ligne de commande.

 gcloud artifacts docker tags delete LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE:TAG

Supprimer des images

Modes de dépôt : standard, distant

Vous pouvez supprimer une image de conteneur entière ou une version d'image spécifique associée à un tag ou à un condensé.

• La suppression d'une image est irréversible.
• La suppression d'images n'entraîne pas la suppression immédiate des calques référencés. Les calques non référencés sont supprimés tous les jours.
• Pour les dépôts distants, la copie mise en cache de l'image est supprimée. L'image reste disponible à partir de la source en amont. Si le dépôt distant reçoit une nouvelle demande pour la même image, il la télécharge et la met à nouveau en cache.

D'autres outils sont à votre disposition pour vous aider à gérer les images inutilisées. Par exemple, l'outil gcr-cleaner recherche et supprime les anciennes images en fonction de différents critères. La suppression d'images inutilisées peut vous aider à réduire les coûts de stockage. L'outil gcr-cleaner n'est pas un produit Google officiel.

Pour supprimer des images à partir de la console Google Cloud ou de la gcloud CLI :

gcloud artifacts docker images delete LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE --delete-tags

gcloud artifacts docker images delete LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE:TAG [--delete-tags]

gcloud artifacts docker images delete LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE@IMAGE-DIGEST [--delete-tags]

Étapes suivantes

• Téléchargez des fichiers individuels stockés dans une image sans utiliser les commandes Docker. Cela peut être utile pour inspecter rapidement les fichiers manifestes.