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:
- En el menú de navegación, haz clic en el enlace Harbor Container Registry de la sección CI/CD.
- Haz clic en Crear un proyecto de Harbor.
- Introduce el nombre del proyecto.
- 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.
- Haz clic en Crear.
- Aparecerá un mensaje de confirmación que indica que el proyecto se ha creado correctamente.
- 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.
Crea un recurso personalizado de
HarborInstanceProjecten el servidor de la API de gestión de zonas. No puedes cambiar el campocreatorSubjectni el campoautoScandespué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 EOFHaz 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
autoScanhabilita 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 valorfalse. Para obtener más información, consulta Buscar vulnerabilidades.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 PROJECTLa columna
PROJECTCREATEDSTATUSmuestraCreatedy la columnaPROJECTSUBJECTASSIGNEDSTATUSmuestraSubjectAssigned.Si la columna
PROJECTSUBJECTASSIGNEDSTATUSmuestraSubjectAssignError, comprueba el mensaje de condición:kubectl --kubeconfig MANAGEMENT_API_SERVER \ describe harborinstanceproject INSTANCE-HARBOR_PROJECT \ -n PROJECTUn mensaje
user ... not foundsignifica que el usuario especificado en el campocreatorSubjectaú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 aSubjectAssigneddespué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.
Comprueba si el recurso
HarborInstanceProjectafectado define el campospec.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 recursoHarborInstanceProject. Los recursos que crees desde la pestaña API de esta página se denominanINSTANCE-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.
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.creatorSubjectdespué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_USERNAMEpor 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.Verifica que el creador tenga asignado lo siguiente:
kubectl --kubeconfig MANAGEMENT_API_SERVER \ get harborinstanceproject HARBOR_INSTANCE_PROJECT \ -n PROJECTUna 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
PROJECTSUBJECTASSIGNEDSTATUSmostrará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: