Что такое Harbor и как настроить registry?

Что такое Harbor?

Harbor — это open source реестр контейнеров корпоративного уровня, который расширяет возможности Docker Registry дополнительными функциями безопасности, управления и соответствия требованиям. Harbor обеспечивает безопасное хранение и распространение контейнерных образов.

Основные возможности Harbor

Сканирование уязвимостей — автоматическое сканирование образов на уязвимости
Content trust — цифровые подписи образов для обеспечения целостности
RBAC — детальное управление доступом к проектам и ресурсам
Репликация — синхронизация образов между несколькими реестрами
Веб-интерфейс — удобное управление через браузер
REST API — программное управление ресурсами

Когда использовать Harbor

Harbor отлично подходит для:

Корпоративных сред с требованиями к безопасности
Управления образами в Kubernetes кластерах
Обеспечения соответствия compliance требованиям
Централизованного хранения приватных образов
Автоматизации процессов CI/CD с проверкой безопасности

Установка Harbor

Установка через Docker Compose:

# Скачивание Harbor
wget https://github.com/goharbor/harbor/releases/download/v2.8.0/harbor-offline-installer-v2.8.0.tgz
tar xvf harbor-offline-installer-v2.8.0.tgz
cd harbor

# Копирование конфигурации
cp harbor.yml.tmpl harbor.yml

# Редактирование harbor.yml
# hostname: your-harbor-domain.com
# https:
#   port: 443
#   certificate: /path/to/cert.crt
#   private_key: /path/to/cert.key

# Запуск установки
sudo ./install.sh

Установка в Kubernetes с Helm

# Добавление Helm репозитория
helm repo add harbor https://helm.goharbor.io
helm repo update

# Создание values.yaml
cat > values.yaml << EOF
expose:
  type: ingress
  ingress:
    hosts:
      core: harbor.example.com
externalURL: https://harbor.example.com
persistence:
  enabled: true
  persistentVolumeClaim:
    registry:
      size: 100Gi
    chartmuseum:
      size: 5Gi
    database:
      size: 1Gi
    redis:
      size: 1Gi
EOF

# Установка Harbor
helm install harbor harbor/harbor -f values.yaml

Работа с Harbor через Docker CLI

# Логин в Harbor
docker login harbor.example.com

# Тегирование образа
docker tag nginx:latest harbor.example.com/library/nginx:latest

# Push образа
docker push harbor.example.com/library/nginx:latest

# Pull образа
docker pull harbor.example.com/library/nginx:latest

Настройка сканирования уязвимостей

Harbor интегрируется с несколькими сканерами:

Trivy — встроенный сканер по умолчанию
Clair — альтернативный сканер уязвимостей

# Включение автоматического сканирования через API
curl -X PUT "https://harbor.example.com/api/v2.0/projects/1" \
     -H "Authorization: Basic $(echo -n admin:password | base64)" \
     -H "Content-Type: application/json" \
     -d '{
       "metadata": {
         "auto_scan": "true"
       }
     }'

Интеграция с Kubernetes

Создание Secret для доступа к приватному registry:

# Создание docker-registry secret
kubectl create secret docker-registry harbor-secret \
  --docker-server=harbor.example.com \
  --docker-username=admin \
  --docker-password=password \
  --docker-email=admin@example.com

# Использование в Pod
apiVersion: v1
kind: Pod
metadata:
  name: my-pod
spec:
  containers:
  - name: my-container
    image: harbor.example.com/library/nginx:latest
  imagePullSecrets:
  - name: harbor-secret

Настройка репликации

Для настройки репликации между Harbor инстансами:

# Создание replication endpoint через API
curl -X POST "https://harbor.example.com/api/v2.0/registries" \
     -H "Authorization: Basic $(echo -n admin:password | base64)" \
     -H "Content-Type: application/json" \
     -d '{
       "name": "target-harbor",
       "url": "https://target-harbor.example.com",
       "type": "harbor",
       "credential": {
         "access_key": "admin",
         "access_secret": "password"
       }
     }'

Мониторинг и метрики

Harbor предоставляет метрики для Prometheus:

# prometheus.yml
scrape_configs:
- job_name: 'harbor'
  static_configs:
  - targets: ['harbor.example.com:8080']
  metrics_path: '/api/v2.0/metrics'
  basic_auth:
    username: 'admin'
    password: 'password'

Best Practices

Включай автоматическое сканирование уязвимостей для всех проектов
Используй content trust для критически важных образов
Настраивай политики retention для управления дисковым пространством
Регулярно обновляй Harbor до последних версий
Мониторь использование ресурсов и производительность

FAQ

Подходит ли Harbor для продакшена?

Да, Harbor широко используется в production средах и является одним из самых популярных корпоративных Docker registry решений с поддержкой CNCF.

Какие требования к инфраструктуре?

Минимальные требования: 4 ГБ RAM, 2 CPU cores, 40 ГБ дискового пространства. Для production рекомендуется использовать внешние базы данных и хранилища.

Можно ли мигрировать с Docker Hub на Harbor?

Да, Harbor поддерживает импорт образов из других реестров через функцию репликации или можно использовать инструменты миграции.

Что такое Harbor и как настроить registry?

Open source реестр контейнеров с безопасностью и управлением для Docker и Kubernetes