Crear proyectos de Harbor

En Harbor, un proyecto es una unidad lógica para organizar y gestionar una colección de imágenes de contenedor. Ofrece una forma de agrupar artefactos relacionados y aplicar políticas, controles de acceso y reglas de replicación específicos a toda la colección. No se pueden enviar ni extraer imágenes de Harbor antes de crear un proyecto.

Antes de empezar

Antes de empezar, debes inicializar tu identidad con el registro de Harbor iniciando sesión en la interfaz de usuario de Harbor al menos una vez.

Rol de gestión de identidades y accesos necesario

Para crear proyectos de Harbor y gestionar espacios de nombres de imágenes, ponte en contacto con el administrador de proyectos de gestión de identidades y accesos para solicitar el rol Creador de proyectos de Harbor (harbor-project-creator), que te permite crear, obtener y ver proyectos de Harbor en el espacio de nombres del proyecto. Este rol incluye los permisos necesarios para definir nuevos espacios de nombres de imágenes, de modo que puedas establecer límites de seguridad para tus aplicaciones en contenedores.

Crear un proyecto de Harbor

Crea un proyecto de Harbor con la consola de GDC, la CLI gdcloud o la API.

Consola

En la consola de GDC, sigue estos pasos:

  1. En el menú de navegación, haz clic en el enlace Harbor Container Registry de la sección CI/CD.
  2. Haz clic en Crear un proyecto de Harbor.
  3. Introduce el nombre del proyecto.
  4. Opcional: El análisis de vulnerabilidades está habilitado de forma predeterminada. Para inhabilitar el análisis de vulnerabilidades automático en proyectos de Harbor, haz clic en el interruptor Habilitar el análisis de vulnerabilidades en el proyecto. Para obtener más información, consulta Buscar vulnerabilidades.
  5. Haz clic en Crear.
  6. Aparecerá un mensaje de confirmación que indica que el proyecto se ha creado correctamente.
  7. Una vez que se haya creado tu proyecto de Harbor, inicia sesión en la interfaz de usuario de Harbor para confirmar que puedes ver el proyecto.

gdcloud

Crea el proyecto de Harbor:

  gdcloud harbor harbor-projects create HARBOR_PROJECT \
    --project=PROJECT \
    --instance=INSTANCE

Haz los cambios siguientes:

  • HARBOR_PROJECT: el nombre del proyecto de Harbor que se va a crear.
  • PROJECT: el nombre del proyecto de GDC.
  • INSTANCE: el nombre de la instancia.

API

La consola de GDC y la CLI gdcloud definen el creador del proyecto de Harbor como tu cuenta de usuario. Si usas la API, debes definir el campo spec.creatorSubject manualmente.

  1. Crea un recurso personalizado de HarborInstanceProject en el servidor de la API de gestión de zonas. No puedes cambiar el campo creatorSubject ni el campo autoScan después de crear el recurso, así que comprueba ambos valores antes de crearlo.

    kubectl --kubeconfig MANAGEMENT_API_SERVER create -f - <<EOF
    apiVersion: artifactregistry.gdc.goog/v1
    kind: HarborInstanceProject
    metadata:
      name: INSTANCE-HARBOR_PROJECT
      namespace: PROJECT
    spec:
      projectName: HARBOR_PROJECT
      harborInstanceRef:
        name: INSTANCE
      creatorSubject:
        apiGroup: rbac.authorization.k8s.io
        kind: User
        name: HARBOR_USERNAME
      autoScan: true
    EOF
    

    Haz los cambios siguientes:

    • MANAGEMENT_API_SERVER: la ruta al archivo kubeconfig del servidor de la API de gestión de zonas. Para obtener más información, consulta Cambiar a un contexto de zona.
    • INSTANCE: el nombre de la instancia de registro de Harbor.
    • HARBOR_PROJECT: el nombre del proyecto de Harbor que se va a crear.
    • PROJECT: el nombre del proyecto de GDC que contiene la instancia de registro de Harbor.
    • HARBOR_USERNAME: tu nombre de usuario de Harbor, tal como se muestra en el menú de usuario de la interfaz de Harbor después de iniciar sesión. Este usuario se convierte en el administrador del proyecto de Harbor. Usa el nombre de usuario de una persona, no una cuenta de servicio. Para obtener más información, consulta la sección Antes de empezar.

    El campo autoScan habilita el análisis de vulnerabilidades automático de las imágenes que se envían al proyecto. Para inhabilitar el análisis automático, asígnale el valor false. Para obtener más información, consulta Buscar vulnerabilidades.

  2. Comprueba que se haya creado el proyecto de Harbor y que se haya asignado el creador:

    kubectl --kubeconfig MANAGEMENT_API_SERVER \
      get harborinstanceproject INSTANCE-HARBOR_PROJECT \
      -n PROJECT
    

    La columna PROJECTCREATEDSTATUS muestra Created y la columna PROJECTSUBJECTASSIGNEDSTATUS muestra SubjectAssigned.

    Si la columna PROJECTSUBJECTASSIGNEDSTATUS muestra SubjectAssignError, comprueba el mensaje de condición:

    kubectl --kubeconfig MANAGEMENT_API_SERVER \
      describe harborinstanceproject INSTANCE-HARBOR_PROJECT \
      -n PROJECT
    

    Un mensaje user ... not found significa que el usuario especificado en el campo creatorSubject aún no ha iniciado sesión en la interfaz de usuario de Harbor. El servicio Harbor lo vuelve a intentar cada 30 segundos, por lo que el estado cambia a SubjectAssigned después de que el usuario inicie sesión.

Corregir un proyecto de Harbor creado sin un creador

Si un recurso de HarborInstanceProject de cualquier proyecto de tu organización no define el campo spec.creatorSubject, el servicio Harbor dejará de procesar los cambios en los recursos de Harbor de tu organización. Entre los síntomas se incluyen instancias de Harbor que no se preparan, nuevos proyectos de Harbor que se quedan sin estado y extracciones de imágenes que fallan con errores x509: certificate signed by unknown authority.

Para solucionar este problema, necesitas el rol Administrador de instancias de Harbor (harbor-instance-admin) en el proyecto que contiene el recurso afectado. Si no tienes este rol, pide a un usuario que lo tenga que complete estos pasos. Si no sabes qué recurso se ha visto afectado, ponte en contacto con tu operador de infraestructura (IO), que puede encontrarlo en los registros del servicio Harbor.

  1. Comprueba si el recurso HarborInstanceProject afectado define el campo spec.creatorSubject:

    kubectl --kubeconfig MANAGEMENT_API_SERVER \
      get harborinstanceproject HARBOR_INSTANCE_PROJECT \
      -n PROJECT -o jsonpath='{.spec.creatorSubject}'
    

    Haz los cambios siguientes:

    • MANAGEMENT_API_SERVER: la ruta al archivo kubeconfig del servidor de la API de gestión de zonas. Para obtener más información, consulta Cambiar a un contexto de zona.
    • HARBOR_INSTANCE_PROJECT: el nombre del recurso HarborInstanceProject. Los recursos que crees desde la pestaña API de esta página se denominan INSTANCE-HARBOR_PROJECT.
    • PROJECT: el nombre del proyecto de GDC que contiene el recurso.

    Si el resultado está vacío, significa que el campo no está definido.

  2. Confirma con el propietario del proyecto de GDC el nombre de usuario de Harbor que se asignará como administrador del proyecto de Harbor. Como no puedes cambiar el campo spec.creatorSubject después de definirlo, verifica el nombre de usuario antes de añadir el campo a cada recurso afectado:

    kubectl --kubeconfig MANAGEMENT_API_SERVER \
      patch harborinstanceproject HARBOR_INSTANCE_PROJECT \
      -n PROJECT --type merge \
      -p '{"spec":{"creatorSubject":{"apiGroup":"rbac.authorization.k8s.io","kind":"User","name":"HARBOR_USERNAME"}}}'
    

    Sustituye HARBOR_USERNAME por el nombre de usuario de Harbor del usuario que quieras asignar como administrador de proyectos de Harbor. Este rol puede eliminar imágenes y gestionar miembros del proyecto. El usuario debe haber iniciado sesión en la interfaz de Harbor al menos una vez, y el nombre de usuario debe coincidir exactamente con el nombre que se muestra en el menú de usuario de la interfaz de Harbor.

  3. Verifica que el creador tenga asignado lo siguiente:

    kubectl --kubeconfig MANAGEMENT_API_SERVER \
      get harborinstanceproject HARBOR_INSTANCE_PROJECT \
      -n PROJECT
    

    Una vez que se hayan corregido todos los recursos afectados, el servicio Harbor se reiniciará y reanudará el procesamiento de los cambios en unos 10 minutos, y la columna PROJECTSUBJECTASSIGNEDSTATUS mostrará SubjectAssigned. Si las imágenes siguen sin extraerse de Harbor después de 15 minutos, ponte en contacto con tu IO. Proporciona al IO los nombres y los proyectos de los recursos que has corregido para que pueda comprobar si hay otros recursos afectados y reiniciar el servicio Harbor si es necesario.

Siguientes pasos

Después de crear un proyecto de Harbor, configura tus clientes de Docker y Helm para que se conecten a tu registro de Harbor: