Crea proyectos de Harbor

En este documento, se orienta a los desarrolladores y administradores sobre cómo crear y verificar proyectos de Harbor con la consola de GDC o la CLI de gdcloud.

Puedes almacenar, proteger y distribuir tus imágenes de contenedor en el dispositivo aislado de Google Distributed Cloud (GDC) organizándolas en proyectos de Harbor dentro de la instancia tear-harbor preconfigurada. En Harbor, un proyecto funciona como una unidad lógica para agrupar artefactos relacionados, administrar tus imágenes y aplicar políticas, controles de acceso y reglas de replicación específicos.

El proyecto del sistema tear proporciona tear-harbor como la única instancia de Harbor disponible (un solo registro preconfigurado para todo tu dispositivo), por lo que no necesitas aprovisionar, actualizar ni mantener instancias separadas de Harbor para cada proyecto del cliente. Esta arquitectura centralizada elimina la sobrecarga de infraestructura y te permite administrar los espacios de nombres de imágenes, los controles de acceso y el análisis de vulnerabilidades desde un registro compartido. Para usar este registro compartido para cargas de trabajo en cualquier proyecto del cliente, debes crear tus roles de Harbor en el proyecto tear y crear tus proyectos de Harbor directamente en el proyecto tear.

Antes de comenzar

Antes de comenzar, asegúrate de cumplir con los siguientes requisitos:

  • Conocimientos recomendados: Asegúrate de conocer los conceptos y la arquitectura que se abordan en la Descripción general del servicio de Harbor administrado. Es fundamental comprender que Harbor es un recurso compartido alojado en el proyecto tear, ya que todas las asignaciones de roles de Harbor y las tareas de creación de proyectos deben dirigirse al proyecto tear.

  • Inicializa tu identidad de Harbor: Debes acceder a la IU de Harbor al menos una vez antes de intentar crear proyectos en la consola. El acceso inicial inicializa tu identidad con el registro de Harbor. Para obtener más información, consulta Obtén la URL de la instancia de Harbor y Inicializa tu identidad de Harbor.

Rol de IAM requerido

Para crear un proyecto de Harbor, incluido un proyecto de Harbor que planeas usar en un proyecto del cliente, debes tener el rol de Identity and Access Management (IAM) de Creador de proyectos de Harbor (harbor-project-creator) creado y otorgado en el proyecto de tear para acceder a la instancia de tear-harbor. Este rol proporciona permisos de creación, obtención y observación para los recursos personalizados del proyecto de Harbor dentro de la instancia de tear-harbor en el proyecto de tear, lo que te permite definir nuevos espacios de nombres de imágenes y establecer límites de seguridad para tus aplicaciones en contenedores.

Para solicitar acceso al proyecto tear, comunícate con el administrador de IAM del proyecto.

Obtén la URL de la instancia de Harbor

Para acceder a la IU de Harbor o usar la CLI de gcloud para administrar imágenes, necesitas la URL del extremo externo de la instancia del registro:

  1. Con la CLI de gdcloud, obtén la URL de la instancia de Harbor:

    gdcloud harbor instances describe tear-harbor --project=tear

    El resultado es similar al siguiente, que suele contener el campo externalEndpoint:

    externalEndpoint: https://harbor.tear.example.com

  2. Copia la URL de externalEndpoint para acceder a la IU de Harbor a través de tu navegador y establecer la autenticación de confianza del cliente.

Si no tienes acceso a la CLI de gdcloud, comunícate con tu operador de infraestructura (IO) para obtener ayuda.

Inicializa tu identidad de Harbor

Accede a la IU de Harbor al menos una vez para sincronizar tu identidad. Este acceso inicial registra tu perfil de usuario en la base de datos de Harbor para que el sistema reconozca tus permisos:

  1. En un navegador, navega a la URL del registro.
  2. Accede con tus credenciales de GDC.

Crea un proyecto de Harbor

Dado que tear-harbor en el proyecto tear es la única instancia de Harbor disponible y funciona como el registro compartido para todo el dispositivo, debes crear todos los proyectos de Harbor en el proyecto tear, incluidos los proyectos de Harbor que almacenan imágenes para cargas de trabajo en otros proyectos del cliente. Crea un proyecto de Harbor con la consola de GDC o la CLI de gdcloud.

Console

En la consola de GDC, sigue estos pasos en el proyecto tear:

  1. Selecciona el proyecto tear.
  2. Haz clic en el vínculo Harbor Container Registry en la sección CI/CD del menú de navegación.
  3. Haz clic en Crear un proyecto de Harbor.
  4. Ingresa el nombre del proyecto de Harbor.
  5. Opcional: El análisis de vulnerabilidades está habilitado de forma predeterminada. Para inhabilitar el análisis de vulnerabilidades automático para los proyectos de Harbor, haz clic en el botón de activación Habilitar el análisis de vulnerabilidades para el proyecto. Para obtener más información, consulta Cómo analizar en busca de vulnerabilidades.
  6. Haz clic en Crear. Aparecerá un mensaje de confirmación que indica que se creó tu proyecto.
  7. Accede a la IU de Harbor para confirmar que puedes ver el proyecto de Harbor.

gdcloud

Crea el proyecto de Harbor en el proyecto tear:

gdcloud harbor harbor-projects create HARBOR_PROJECT \
  --project=tear \
  --instance=tear-harbor

Reemplaza HARBOR_PROJECT por el nombre del proyecto de Harbor que deseas crear.