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 en contenedor de forma local o usarla como una 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 Cómo crear proyectos de Harbor.

Roles de IAM obligatorios

Para extraer imágenes de instancias de registro de Harbor, comunícate con tu administrador de IAM del proyecto para solicitar el rol Visualizador de instancias de Harbor (harbor-instance-viewer), que te permite obtener, enumerar y observar 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 del registro necesarias para extraer imágenes.

Roles de RBAC de Harbor obligatorios

A diferencia de los roles de IAM de GDC, la extracción de imágenes requiere permisos específicos dentro del sistema interno de control de acceso basado en roles (RBAC) de Harbor. Solicita los permisos necesarios a tu administrador. Aplica el acceso de 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 Cómo ver instancias de registro de Harbor.

¿Qué sigue?

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