Harbor在OpenShift环境中的Ingress与Routes配置问题解析

问题背景

在OpenShift 4.14环境中部署Harbor时，许多用户会遇到登录和镜像推送的问题。这些问题通常与Ingress和Routes的配置不当有关，特别是在使用OpenShift默认的Ingress控制器时。

关键配置问题

1. Ingress路径配置

在OpenShift环境中，Harbor的/v2路径需要特别注意。默认配置中，该路径的后端服务端口设置为80，但这会导致登录功能失效。正确的做法是将端口修改为8080或5000：

- backend:
    service:
      name: harbor-core
      port:
        number: 8080  # 或5000
  path: /v2/
  pathType: Prefix

2. 镜像推送失败

即使解决了登录问题，用户仍可能遇到镜像推送失败的情况。错误信息通常显示为405 Method Not Allowed，这表明虽然认证通过，但API请求未被正确处理。

解决方案

1. 检查externalURL格式

一个常见但容易被忽视的问题是externalURL的缩进格式。在YAML配置中，externalURL必须正确缩进：

错误配置：

    externalURL: https://harbor-registry-harbor.apps.<cluster-domain>

正确配置：

externalURL: https://harbor-registry-harbor.apps.<cluster-domain>

2. OpenShift Ingress控制器特性

OpenShift的Ingress控制器与标准Kubernetes有所不同，它会自动将Ingress资源转换为Routes。用户需要了解：

1. OpenShift默认使用名为"openshift-default"的IngressClass
2. 控制器类型为"openshift.io/ingress-to-route"
3. 默认会使用openshift-wildcard-certificate作为证书

3. 调试技巧

当遇到问题时，可以：

1. 检查生成的Route资源：oc get routes -n <harbor-namespace>
2. 查看Ingress控制器的日志
3. 使用oc describe命令检查资源状态
4. 尝试直接访问API端点进行测试

最佳实践

1. 在OpenShift环境中部署Harbor时，建议使用Helm chart的最新稳定版本
2. 仔细检查所有YAML格式，特别是缩进问题
3. 考虑使用OpenShift的Routes资源直接暴露服务，而不是依赖Ingress转换
4. 对于生产环境，建议配置自定义证书而非使用默认的wildcard证书

通过理解OpenShift特有的网络配置方式，并注意这些细节问题，可以成功地在OpenShift环境中部署和使用Harbor容器镜像仓库。