一、Harbor高可用架构设计

1.1 核心组件分布

Harbor高可用架构采用”控制平面+数据平面”分离设计，核心组件包括：

Core Services：API服务、配置管理、权限控制
Registry：存储镜像元数据
ChartMuseum：Helm Chart存储
Database：PostgreSQL集群（主从+流复制）
Redis集群：用于会话管理和任务队列
对象存储：MinIO/S3兼容存储（推荐3节点以上）

建议采用StatefulSet部署数据库和存储组件，确保数据持久性。对于生产环境，推荐配置3个Harbor Core实例，通过Ingress实现负载均衡。

1.2 网络拓扑优化

关键网络配置要点：

内部服务通信使用ClusterIP Service
外部访问通过Ingress Controller（推荐Nginx或Traefik）
存储网络与业务网络物理隔离
启用mTLS双向认证（使用cert-manager自动管理证书）

示例Ingress配置：

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: harbor-ingress
  annotations:
    nginx.ingress.kubernetes.io/rewrite-target: /
    nginx.ingress.kubernetes.io/ssl-redirect: "true"
spec:
  tls:
  - hosts:
    - harbor.example.com
    secretName: harbor-tls
  rules:
  - host: harbor.example.com
    http:
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: harbor-core
            port:
              number: 80

二、Kubernetes资源规划

2.1 节点资源分配

推荐资源分配方案：
| 组件类型 | CPU请求 | CPU限制 | 内存请求 | 内存限制 | 存储类型 |
|————————|————-|————-|—————|—————|————————|
| Harbor Core | 500m | 2 | 1Gi | 4Gi | SSD（100Gi） |
| PostgreSQL | 1 | 4 | 4Gi | 8Gi | 高端SSD（500Gi）|
| Redis集群 | 250m | 1 | 512Mi | 2Gi | 普通SSD（100Gi）|
| MinIO存储 | 500m | 2 | 2Gi | 4Gi | 分布式存储 |

2.2 存储卷配置

存储类配置建议：

apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: harbor-ssd
provisioner: kubernetes.io/aws-ebs # 或相应云提供商
parameters:
  type: gp3
  fsType: xfs
  iopsPerGB: "10"
reclaimPolicy: Retain
volumeBindingMode: WaitForFirstConsumer

对于本地存储方案，推荐使用OpenEBS或Rook-Ceph构建分布式存储层。

三、高可用部署实施

3.1 Harbor Operator部署

使用官方Harbor Operator简化部署流程：

# 安装Cert-Manager
kubectl apply -f https://github.com/cert-manager/cert-manager/releases/download/v1.11.0/cert-manager.yaml
# 部署Harbor Operator
kubectl create namespace harbor-operator
helm repo add harbor https://helm.goharbor.io
helm install harbor-operator harbor/harbor-operator -n harbor-operator

3.2 自定义资源定义示例

apiVersion: goharbor.io/v2
kind: Harbor
metadata:
  name: harbor-cluster
spec:
  version: v2.7.0
  expose:
    type: ingress
    tls:
      enabled: true
      certSource: secret
      secret:
        secretName: harbor-tls
    ingress:
      hosts:
        - core: harbor.example.com
          notary: notary.example.com
  database:
    internal:
      password: "Base64EncodedPassword"
      storageClassName: "harbor-ssd"
  storage:
    s3:
      accesskey: "minio"
      secretkey: "minio123"
      region: us-east-1
      bucket: harbor-registry
      endpoint: "http://minio.minio-ns.svc.cluster.local:9000"
      secure: false

3.3 监控集成方案

推荐监控组件配置：

Prometheus Operator收集指标
Grafana Dashboard模板（ID: 13539）
AlertManager告警规则示例：
```yaml
groups:
name: harbor.rules
rules:
- alert: HarborCoreDown
  expr: up{job=”harbor-core”} == 0
  for: 5m
  labels:
  severity: critical
  annotations:
  summary: “Harbor Core {{ $labels.instance }} is down”
```

四、运维优化实践

4.1 备份恢复策略

实施3-2-1备份原则：

每日全量备份（使用Velero）
保留最近30天备份
异地存储备份数据

备份脚本示例：

#!/bin/bash
BACKUP_NAME="harbor-backup-$(date +%Y%m%d)"
kubectl exec -n harbor-ns postgres-0 -- \
  pg_dump -U postgres -h localhost harbor > /tmp/${BACKUP_NAME}.sql
kubectl cp -n harbor-ns /tmp/${BACKUP_NAME}.sql \
  postgres-0:/backup/

4.2 性能调优参数

关键调优项：

PostgreSQL配置：

shared_buffers = 4GB
work_mem = 16MB
maintenance_work_mem = 1GB

Redis配置：

maxmemory 2gb
maxmemory-policy allkeys-lru

Harbor Core JVM参数：
```
-Xms2g -Xmx4g -XX:+UseG1GC
```

4.3 升级策略

推荐升级流程：

在测试环境验证新版本

执行预检查：

kubectl exec -n harbor-ns harbor-core-0 -- \
  /harbor/harbor_preupgrade

逐步升级组件顺序：
- 数据库迁移
- Redis集群升级
- Core服务滚动更新
- UI组件更新

五、故障排查指南

5.1 常见问题处理

现象	可能原因	解决方案
502错误	Ingress配置错误	检查证书和后端服务状态
镜像拉取慢	存储性能瓶颈	增加MinIO节点或优化存储类
登录失败	OAuth配置错误	检查Dex或OIDC提供方配置
任务卡住	Redis连接问题	检查网络策略和资源限制

5.2 日志分析技巧

关键日志路径：

Core服务：/var/log/harbor/core.log
数据库：/var/log/postgresql/postgresql-*.log
存储：/var/log/minio/server.log

使用EFK栈集中管理日志，示例查询：

{
  "query": {
    "bool": {
      "must": [
        { "match": { "log": "error" } },
        { "range": { "@timestamp": { "gte": "now-1h" } } }
      ]
    }
  }
}

通过以上架构设计和实施策略，企业可在Kubernetes环境中构建具备99.95%可用性的Harbor镜像仓库，满足金融、电信等行业对容器镜像管理的严苛要求。实际部署中需根据具体业务场景调整参数配置，并建立完善的监控告警体系确保系统稳定运行。

在Kubernetes中构建企业级镜像中枢：Harbor高可用部署实战指南