Extraire une image avec Docker

Extrayez une image d'un projet Harbor dans le client Docker pour télécharger l'image de conteneur spécifiée depuis votre registre Harbor vers votre ordinateur local. Cela vous permet d'exécuter l'application conteneurisée localement ou de l'utiliser comme image de base pour créer d'autres images.

Avant de commencer

Pour extraire une image avec Docker, vous devez configurer votre environnement avec les ressources et les autorisations nécessaires, y compris un projet Harbor existant avec l'image de conteneur que vous souhaitez extraire. Pour en savoir plus, consultez Créer des projets Harbor.

Rôles IAM requis

Pour extraire des images d'instances de registre Harbor, contactez l'administrateur de votre projet IAM pour demander le rôle Lecteur d'instances Harbor (harbor-instance-viewer), qui vous permet d'obtenir, de lister et de surveiller les instances Harbor dans l'espace de noms du projet. Ce rôle inclut les autorisations requises pour afficher les détails des instances Harbor existantes afin de pouvoir récupérer les URL de registre requises pour extraire des images.

Rôles RBAC Harbor requis

Contrairement aux rôles IAM GDC, l'extraction d'images nécessite des autorisations spécifiques dans le système de contrôle des accès basé sur les rôles (RBAC) interne de Harbor. Demandez les autorisations nécessaires à votre administrateur. Appliquez le principe du moindre privilège en ne demandant que les rôles requis pour vos tâches spécifiques.

Récupérer une image

Pour extraire une image d'un projet Harbor dans le client Docker, procédez comme suit :

  1. Assurez-vous d'être authentifié auprès de l'instance Harbor.

  2. Extrayez l'image d'un projet Harbor :

    docker pull INSTANCE_URL/HARBOR_PROJECT_NAME/IMAGE:TAG

    ou

    docker pull INSTANCE_URL/HARBOR_PROJECT_NAME/IMAGE@IMAGE_DIGEST

Remplacez les valeurs suivantes :

  • INSTANCE_URL : URL de l'instance Harbor. Par exemple, harbor-1.org-1.zone1.google.gdc.test.. Vous pouvez obtenir l'URL de l'instance Harbor à l'aide de la console GDC ou de la CLI gdcloud.
  • HARBOR_PROJECT_NAME : nom du projet Harbor. Exemple : my-project.
  • IMAGE : nom de l'image. Exemple :nginx
  • TAG : tag de la version de l'image que vous souhaitez extraire. Exemple : staging.
  • IMAGE_DIGEST : valeur de hachage sha256 du contenu de l'image. Chaque version d'une image possède un condensé d'image unique. Dans l'interface utilisateur de l'instance Harbor, cliquez sur l'image spécifique pour afficher son condensé. Pour en savoir plus, consultez Afficher les instances de registre Harbor.

Étapes suivantes

Après avoir confirmé la connexion en extrayant une image, vous pouvez utiliser vos artefacts pour lancer l'application dans votre environnement :