Cómo extraer una imagen con Docker

Extrae una imagen de un proyecto de Harbor en el cliente de Docker para descargar la imagen de contenedor especificada de tu registro de Harbor a tu máquina local. Esto te permite ejecutar la aplicación alojada en contenedores de forma local o usarla como imagen base para compilar otras imágenes.

Antes de comenzar

Para extraer una imagen con Docker, debes configurar tu entorno con los recursos y permisos necesarios, incluido un proyecto de Harbor existente con la imagen de contenedor que deseas extraer. Para obtener más información, consulta Crea proyectos de Harbor.

Roles de IAM obligatorios

Para extraer imágenes de las instancias de registro de Harbor, comunícate con el administrador de proyectos de IAM y solicita el rol de visualizador de instancias de Harbor (harbor-instance-viewer), que te permite obtener, enumerar y supervisar las instancias de Harbor en el espacio de nombres del proyecto. Este rol incluye los permisos necesarios para ver los detalles de las instancias de Harbor existentes, de modo que puedas recuperar las URLs de registro necesarias para extraer imágenes.

Roles de RBAC de Harbor obligatorios

A diferencia de los roles de IAM de GDC, extraer imágenes requiere permisos específicos dentro del sistema de control de acceso basado en roles (RBAC) interno de Harbor. Solicita los permisos necesarios a tu administrador. Aplica el acceso con privilegio mínimo solicitando solo los roles necesarios para tus tareas específicas.

Extrae una imagen

Sigue estos pasos para extraer una imagen de un proyecto de Harbor en el cliente de Docker:

  1. Asegúrate de estar autenticado en la instancia de Harbor.

  2. Extrae la imagen de un proyecto de Harbor:

    docker pull INSTANCE_URL/HARBOR_PROJECT_NAME/IMAGE:TAG

    o

    docker pull INSTANCE_URL/HARBOR_PROJECT_NAME/IMAGE@IMAGE_DIGEST

Reemplaza los siguientes valores:

  • INSTANCE_URL: Es la URL de la instancia de Harbor. Por ejemplo, harbor-1.org-1.zone1.google.gdc.test. Puedes obtener la URL de la instancia de Harbor con la consola de GDC o la CLI de gdcloud.
  • HARBOR_PROJECT_NAME: Es el nombre del proyecto de Harbor. Por ejemplo, my-project.
  • IMAGE: Es el nombre de la imagen. Por ejemplo, nginx
  • TAG: Es la etiqueta de la versión de la imagen que deseas extraer. Por ejemplo, staging.
  • IMAGE_DIGEST: Es el valor de hash SHA256 del contenido de la imagen. Cada versión de una imagen tiene un resumen de imagen único. En la IU de la instancia de Harbor, haz clic en la imagen específica para ver su resumen. Para obtener más información, consulta Visualiza las instancias de registro de Harbor.

¿Qué sigue?

Después de confirmar la conexión extrayendo una imagen, puedes usar tus artefactos para iniciar la aplicación en tu entorno: