当前位置：首页 > news >正文

开源之夏openEuler社区：5步搭建私有Harbor镜像仓库终极指南 [特殊字符]

news 2026/7/13 9:12:08

开源之夏openEuler社区：5步搭建私有Harbor镜像仓库终极指南 🚀

【免费下载链接】open-source-summer开源之夏活动 openEuler 社区项目管理仓库项目地址: https://gitcode.com/openeuler/open-source-summer

前往项目官网免费下载：https://ar.openeuler.org/ar/

在开源之夏openEuler社区项目中，私有Harbor镜像仓库是企业级容器镜像管理的核心组件。通过5个简单步骤，您可以在Kubernetes环境中快速部署一个功能完整的私有镜像仓库，实现安全、高效的容器镜像管理。本文将为您提供完整的搭建教程，帮助您快速掌握Harbor私有镜像仓库的部署技巧。

为什么选择Harbor作为私有镜像仓库？ 🤔

Harbor是CNCF毕业的云原生镜像仓库项目，专为企业级环境设计。在openEuler社区的ResearchOps项目中，Harbor提供了以下关键功能：

安全扫描：集成Trivy进行镜像漏洞扫描
镜像复制：支持多仓库间镜像同步
权限管理：细粒度的RBAC权限控制
Helm图表管理：支持ChartMuseum存储Helm图表
内容信任：集成Notary实现镜像签名验证

准备工作：环境要求清单 📋

在开始部署之前，请确保您的环境满足以下要求：

Kubernetes集群（版本1.19+）
Helm 3已安装并配置
持久化存储（推荐使用StorageClass）
域名解析（用于Ingress访问）
SSL证书（生产环境必需）

第1步：克隆项目并准备配置文件 📂

首先从开源之夏openEuler社区项目获取Harbor配置文件：

git clone https://gitcode.com/openeuler/open-source-summer cd open-source-summer/ResearchOps/harbor

项目中的Harbor配置目录包含了完整的Helm Chart配置，您可以根据实际需求进行调整。

第2步：配置Harbor的核心参数 ⚙️

打开values.yaml文件，这是Harbor部署的核心配置文件。以下是最关键的配置项：

访问配置

expose: type: ingress tls: enabled: true certSource: secret ingress: hosts: core: harbor.yourdomain.com notary: notary.yourdomain.com externalURL: https://harbor.yourdomain.com

管理员密码

harborAdminPassword: "YourSecurePassword123"

存储配置

persistence: enabled: true persistentVolumeClaim: registry: storageClass: "standard" size: 20Gi chartmuseum: size: 5Gi jobservice: size: 1Gi

第3步：配置数据库和缓存 🗄️

Harbor支持外部数据库和Redis，这在生产环境中是推荐配置：

PostgreSQL数据库配置

database: type: external external: host: "postgresql.postgresql.svc.cluster.local" port: "5432" username: "postgres" password: "your-db-password" coreDatabase: "registry" notaryServerDatabase: "notary_server" notarySignerDatabase: "notary_signer"

Redis缓存配置

redis: type: internal # 或使用外部Redis # external: # addr: "redis-master.redis.svc.cluster.local:6379" # password: "your-redis-password"

第4步：启用安全扫描功能 🔒

Trivy安全扫描是Harbor的重要功能，可以自动检测镜像中的漏洞：

trivy: enabled: true debugMode: false vulnType: "os,library" severity: "UNKNOWN,LOW,MEDIUM,HIGH,CRITICAL" ignoreUnfixed: false timeout: 5m0s

图：Harbor提供企业级安全扫描功能

第5步：部署Harbor并验证安装 🚀

使用Helm进行部署

# 添加Harbor Chart仓库 helm repo add harbor https://helm.goharbor.io # 更新仓库 helm repo update # 部署Harbor helm install harbor harbor/harbor -f values.yaml -n harbor --create-namespace

验证部署状态

# 查看Pod状态 kubectl get pods -n harbor # 查看服务状态 kubectl get svc -n harbor # 查看Ingress配置 kubectl get ingress -n harbor

图：Harbor私有镜像仓库部署成功界面

快速开始使用您的Harbor仓库 🎯

1. 登录Harbor控制台

访问https://harbor.yourdomain.com，使用默认管理员账户：

用户名：admin
密码：配置文件中设置的密码

2. 配置Docker客户端

# 信任私有仓库证书 sudo mkdir -p /etc/docker/certs.d/harbor.yourdomain.com sudo cp ca.crt /etc/docker/certs.d/harbor.yourdomain.com/ # 登录到Harbor docker login harbor.yourdomain.com

3. 推送第一个镜像

# 标记镜像 docker tag nginx:latest harbor.yourdomain.com/library/nginx:latest # 推送镜像 docker push harbor.yourdomain.com/library/nginx:latest

4. 拉取镜像

docker pull harbor.yourdomain.com/library/nginx:latest

高级配置技巧 💡

配置镜像复制策略

Harbor支持跨多个仓库的镜像复制，确保镜像的高可用性：

在Harbor控制台创建复制规则
配置源仓库和目标仓库
设置触发条件（立即、定时、手动）
启用过滤器（按标签、仓库名等）

集成CI/CD流水线

将Harbor集成到您的CI/CD流程中：

# Jenkins Pipeline示例 pipeline { agent any stages { stage('Build') { steps { sh 'docker build -t harbor.yourdomain.com/myapp:$BUILD_NUMBER .' } } stage('Push') { steps { withCredentials([string(credentialsId: 'harbor-creds', variable: 'HARBOR_PASS')]) { sh ''' docker login -u admin -p $HARBOR_PASS harbor.yourdomain.com docker push harbor.yourdomain.com/myapp:$BUILD_NUMBER ''' } } } } }