Harbor简单搭建以及异常排查的过程与思路

Harbor简单搭建以及异常排查的过程与思路

---

前言

我发现我总是能够遇到别人遇不到的问题.
本来搭建十分钟就可以搭建完成
结果我硬生生的搭建了四十分钟.
为了保证下次不再浪费时间.
这里加单总结一下遇到的问题

---

系统准备

这次使用的是UOS V20 1050E x86的操作系统.
简单起见: yum 安装docker
yum install docker -y
发现自带安装的是 18.09的版本.
复制一个docker-compose 到/usr/bin 目录下.
systemctl enable docker
systemctl restart docker

---

介质准备

从github 上面下载最新版本 harbor
2022.11. 能够下载的版本是 2.6.1
将tar包放到/harbor 目录下 并且解压缩
scp harbor.yml.tmpl  harbor.yml

注意进行修改:
修改域名, 建议直接还是用https 避免不必要的麻烦.
DNS设置IP地址和域名的映射.
然后下载证书放到指定的目录
修改 harbor admin的密码
修改 数据库的密码
执行 ./prepare 的脚本进行创建启动脚本

---

安装

执行 ./install.sh 执行安装即可.
速度很快.
安装完之后 进行查询
docker ps |grep -v healthy
如果查不到没有不健康的 容器.
说明搭建完成正常.

---

排错的过程

需要注意几个目录:
harbor的日志存放路径为:
/var/log/harbor
harbor的存储的默认文件是
/data

所以排查问题的思路是
通过/var/log/harbor/里面的日志来分析.

---

排错记录1

第一次遇到一个问题是 nginx 和registry启动失败
一开始不知道具体原因
通过查看日志发现是文件权限的问题
错误记录为:

"/etc/nginx/nginx.conf" failed (13: Permission denied)

被逼无奈修改了 /harbor/common/config/proxy 以及 registry
内的文件权限, 修改为 777 的权限,服务就可以正常启动了.

---

排错记录2

Registry 发现总是无法启动, 错误信息是数据库登录失败
后来想到第一次 install和第二次install 导致的data差异
应该是 harbor 防止多次安装导致数据丢失, 所以没有强制清理
第一次install的数据库密码已经生成
第二次修改了密码再次install就导致配置文件与数据库不一致了.
所以必须按照严格说明进行处理, 先修改好固定住, 再进行处理.