Harbor

Registry privado de contenedores cloud-native con escaneo de vulnerabilidades, firma de contenido y control de acceso por roles (RBAC).

Versión:

2.14.2

Volver a Marketplace

⚠️ Nota: Harbor es una aplicación pesada con múltiples componentes. El arranque inicial puede tomar entre 8–15 minutos.

Requisitos de VM

Recurso Mínimo
CPU 2 vCPU
RAM 4 GB
Disco 100 GB
Sistema Operativo Ubuntu 22.04 / 24.04

⚠️ El disco de 100 GB es el requerimiento real de Harbor para almacenar imágenes, base de datos y caché. No usar el estándar de 40 GB.

Puerto de acceso

Puerto Protocolo Uso
443 HTTPS Interfaz web y API del registry

Cómo acceder

Con SSL habilitado (recomendado)

https://<IP-CON-GUIONES>.sslip.io/

Ejemplo: si tu VM tiene la IP 200.25.101.125:

https://200-25-101-125.sslip.io/

Credenciales de acceso

Campo Valor
Usuario admin
Contraseña La configurada en HARBOR_ADMIN_PASSWORD o búscala en los outputs del deployment

Usar el Registry

Configurar cliente Docker

# Con SSL (sslip.io)
docker login https://<IP-CON-GUIONES>.sslip.io -u admin -p <PASSWORD>

Push de una imagen

# Etiquetar
docker tag <imagen>:<tag> <IP-CON-GUIONES>.sslip.io/<proyecto>/<imagen>:<tag>

# Subir
docker push <IP-CON-GUIONES>.sslip.io/<proyecto>/<imagen>:<tag>

Pull de una imagen

docker pull <IP-CON-GUIONES>.sslip.io/<proyecto>/<imagen>:<tag>

ℹ️ Harbor organiza las imágenes en proyectos. El proyecto por defecto es library. Crea proyectos adicionales desde la UI en Projects → New Project.

Validar que Harbor Está Activo

Harbor despliega varios pods. Todos deben estar en Running antes de acceder a la UI.

# Ver todos los pods de Harbor
kubectl get pods -A | grep harbor

# Ver log de instalación
tail -f /var/log/cuemby/bootstrap.log

Pods principales esperados:

NAMESPACE  NAME                              READY   STATUS
harbor     harbor-core-xxxxxxxxx             1/1     Running   ✓
harbor     harbor-portal-xxxxxxxxx           1/1     Running   ✓
harbor     harbor-registry-xxxxxxxxx         1/1     Running   ✓
harbor     harbor-jobservice-xxxxxxxxx       1/1     Running   ✓
harbor     harbor-database-0                 1/1     Running   ✓
harbor     harbor-valkey-0                   1/1     Running   ✓

ℹ️ Si algunos pods muestran Init o Pending, espera unos minutos. Es parte del arranque normal.

Parámetros de configuración

Credentials

Parámetro Default Descripción
HARBOR_ADMIN_PASSWORD ⚠️ auto-generado Contraseña del usuario admin para la UI y el registry.
HARBOR_DB_PASSWORD ⚠️ auto-generado Contraseña de la base de datos PostgreSQL interna.
HARBOR_SECRET_KEY ⚠️ auto-generado Clave de encriptación para datos sensibles internos.
HARBOR_VALKEY_PASSWORD ⚠️ auto-generado Contraseña de Valkey (caché y colas internas).

Optionals

Parámetro Default Descripcion
HARBOR_REGISTRY_DATA_SIZE 50Gi Tamaño del volumen para almacenar imágenes.
HARBOR_DB_DATA_SIZE 20Gi Tamaño del volumen para PostgreSQL.
HARBOR_SSL_ENABLED true Habilita HTTPS con certificado automático vía sslip.io.
HARBOR_HOSTNAME auto (sslip.io) Hostname personalizado. Si se deja vacío, se usa la URL generada por Cuemby.

ℹ️ Todas las credenciales se generan automáticamente si se dejan vacías. Encuéntralas en los outputs del deployment en el portal de Cuemby.

Primeros pasos (inicio rápido)

  1. Abre la URL e inicia sesión con admin y tu contraseña.
  2. Crea un proyecto desde Projects → New Project (público o privado).
  3. Haz login con Docker y sube tu primera imagen al proyecto creado.
  4. Activa el escaneo de vulnerabilidades en Projects → <proyecto> → Configuration → Automatically scan images.

💡 Tip: Harbor incluye Trivy para escaneo de vulnerabilidades. Puedes configurar políticas que bloqueen el pull de imágenes con vulnerabilidades críticas desde Projects → <proyecto> → Configuration → Prevent vulnerable images from running.

Solución rápida de problemas

Problema Causa probable Solución
UI no carga Pods aún iniciando Espera 8–15 min. Revisa kubectl get pods -A | grep harbor.
unauthorized en docker push/pull No has hecho login Ejecuta docker login con tus credenciales antes de operar.
denied: requested access to the resource is denied Proyecto no existe o sin permisos Crea el proyecto en la UI y verifica los permisos del usuario.
Pods en Pending RAM o disco insuficiente Verifica que la VM tiene al menos 8 GB de RAM y 100 GB de disco.
Pod en CrashLoopBackOff Dependencia no lista Revisa con kubectl describe pod -n .

Cuemby Cloud

IaaS

Acerca de Cuemby Cloud

Cuemby Cloud es una infraestructura de nube de nivel empresarial gestionada desde una única consola, diseñada para ofrecer una seguridad más sólida, operaciones predecibles y una fácil escalabilidad en todas las regiones.

Regiones de centros de datos disponibles en Colombia, Ecuador y Chile

Respaldado por ubicaciones de centros de datos de nivel III y nivel IV

Tarifas de entrada y salida de red cero

Soporte de expertos locales 24/7

¿listo para modernizar tu empresa?

Los desafíos del futuro exigen soluciones preparadas para el futuro. ¡Empecemos!

© Derechos de autor | Cuemby® 2025