运维文档

# 工具部署Harbor

工具类型: 安装程序

文档更新: 2025-02-22 16:43:06

适用场景: 非云化产品的的私有化部署(自建环境)

# 相关下载

安装工具: https://pan.baidu.com/s/1theykQLmCroq4t4EKdi8SQ?pwd=2024

# 工具部署步骤

# 环境准备要求

Harbor工具部署原理是：[Linux运维机（最普通配置）] ---SSH远程部署---> [Harbor单机]

故，如果是多台机器部署中间件，需要指定一台机器作为运维机，并且能SSH远程到别的服务器进行部署。 如果是单机部署，也可以直接把当前服务器当作运维机，自己SSH自己。

# 准备全量包

全量包包含了Harbor程序和工具脚本，根据Harbor最终部署的服务器选择使用哪个全量包：

  • multi-deploy-harbor-amd64.tgz ： Harbor最终服务器全部是X86架构则选择此包
  • multi-deploy-harbor-arm64.tgz ： Harbor最终服务器全部是ARM架构则选择此包
  • multi-deploy-harbor-full.tgz ： Harbor（集群场景）最终服务器一部分X86、一部分ARM则选择此包
  • 犹豫不决，就选择multi-deploy-harbor-full.tgz万精油包

确定全量包后，将其上传到运维机上任意目录，比如 /seeyon/scripts/clickhouse 。随后在该目录下解压全量包，示例命令如： tar -xf multi-deploy-harbor-full.tgz ：

1756272736428.png

# 运维机配置工具参数

在上一步运维机解压全量包目录，配置工具参数：

vim multi-deploy-harbor.sh

默认配置也可以安装，如果部署的目录、部署规则需要精细化调整，详细参数可通过云盘安装工具里面的视频学习。

1756273962314.png

# 运维机配置SSH参数

同样在运维机解压全量包目录，执行运维机SSH远程harbor服务器的参数，即配置将harbor部署在哪一台服务器（也可以配置成当前自己这台机器）：

vim cfg/docker/harbor.hosts

1756274041865.png

# 运维机执行工具安装

1、在运维机解压全量包目录，执行 bash multi-deploy-harbor.sh 不带任何命令，能看到工具的特性、使用方法及常用命令信息：

1756274146388.png

2、使用如下命令启动harbor的部署：

bash multi-deploy-harbor.sh i

部署初期会进行环境、配置检查，如存在异常，需要根据工具的提示消除问题，再继续。

Harbor会基于Docker容器运行，工具会自动安装Docker，随后再加载Harbor。

如果当前服务器已经安装了Docker，则需要在安装前修改配置 skipInstDocker="1" 跳过docker安装。

3、安装部署成功效果图：

注：首次部署需要手动启动Harbor systemctl start harbor，重启系统会自启动。

1756274671593.png

# 日常维护

Harbor服务的日常维护：

systemctl start harbor
systemctl stop harbor
systemctl status harbor

Harbor工具安装后的访问地址、端口、帐号、初始化密码见工具下的 doc/apps-deployment-summary.txt 文件：

1757415690651.png

# 异常处置

问题：命令检查: zip on v8-harbor 未通过

解决方案：安装zip依赖，比如 sudo yum install zip

4/4 命令检查: zip on v8-harbor 未通过
{
  "hostname": "v8-harbor",
  "level": "ERROR",
  "msg": "failed",
  "output": "",
  "status": "FAILED",
  "time": "2025-09-08 10:12:56.214348"
}
{
  "level": "INFO",
  "msg": "success count: 0, failed count: 1, elapsed: 0.09s",
  "time": "2025-09-08 10:12:56.214393"
}
编撰人：yangfc、het、admin

快速跳转

← 手动部署Harbor →