Docker harbor私有库
文章目录
- 一、Harbor概述
-
- 1、什么是Harbor
- 2、Harbor的特性
- 3、Harbor的构成
- 二、Harbor部署
-
- 1、部署 Harbor 服务
- 2、真机访问
- 3、在本地测试仓库功能
- 4、在客户端上传镜像
- 5、维护管理Harbor
- 6、创建 Harbor 用户
- 7、移除 Harbor 服务容器以及全部数据
一、Harbor概述
1、什么是Harbor
Harbor 是 VMware 公司开源的企业级 Docker Registry 项目，其目标是帮助用户迅速搭建一个企业级的 Docker Registry 服务。
Harbor以 Docker 公司开源的 Registry 为基础，提供了图形管理 UI 、基于角色的访问控制(Role Based AccessControl) 、AD/LDAP 集成、以及审计日志(Auditlogging) 等企业用户需求的功能，同时还原生支持中文。
Harbor 的每个组件都是以 Docker 容器的形式构建的，使用 docker-compose 来对它进行部署。用于部署 Harbor 的 docker-compose 模板位于 harbor/docker-compose.yml。
2、Harbor的特性
- 基于角色控制：用户和仓库都是基于项目进行组织的，而用户在项目中可以拥有不同的权限。
- 基于镜像的复制策略：镜像可以在多个Harbor实例之间进行复制（同步）。
- 支持 LDAP/AD：Harbor 可以集成企业内部已有的 AD/LDAP（类似数据库的一张表），用于对已经存在的用户认证和管理。(通过VPN连接域使用)
- 镜像删除和垃圾回收：镜像可以被删除，也可以回收镜像占用的空间。
- 图形化用户界面：用户可以通过浏览器来浏览，搜索镜像仓库以及对项目进行管理。
- 审计管理：所有针对镜像仓库的操作都可以被记录追溯，用于审计管理。(此功能使用较少，一般企业中用ELK收集、分析日志)
- 支持 RESTful API：RESTful API 提供给管理员对于 Harbor 更多的操控, 使得与其它管理软件集成变得更容易。
- Harbor和docker registry的关系：Harbor实质上是对docker registry做了封装，扩展了自己的业务模板。
3、Harbor的构成
Harbor 在架构上主要有 Proxy、Registry、Core services、Database（Harbor-db）、Log collector（Harbor-log）、Job services 六个组件。
- Proxy：是一个 nginx 的前端代理，Harbor 的 Registry、UI、Token 服务等组件，都处在 nginx 反向代理后边。 该代理将来自浏览器、docker clients 的请求转发到后端不同的服务上。
- Registry：负责储存 Docker 镜像，并处理 Docker push/pull 命令。由于要对用户进行访问控制，即不同用户对 Docker 镜像 有不同的读写权限，Registry 会指向一个 Token 服务，强制用户的每次 Docker pull/push 请求都要携带一个合法的 Token， Registry 会通过公钥对 Token 进行解密验证。
- Core services：Harbor的核心功能，主要提供以下3个服务:
-
- UI（harbor-ui）：提供图形化界面，帮助用户管理 Registry 上的镜像（image）, 并对用户进行授权。
-
- WebHook：为了及时获取Registry 上image 状态变化的情况，在Registry 上配置 Webhook，把状态变化传递给 UI 模块。
-
- Token 服务：负责根据用户权限给每个 Docker push/pull 命令签发 Token。Docker 客户端向 Registry 服务发起的请求， 如果不包含 Token，会被重定向到 Token 服务，获得 Token 后再重新向 Registry 进行请求。
- ==Database（harbor-db）==：为core services提供数据库服务，负责储存用户权限、审计日志、Docker 镜像分组信息等数据。
- Job services：主要用于镜像复制，本地镜像可以被同步到远程 Harbor 实例上。
- ==Log collector（harbor-log）==：负责收集其他组件的日志到一个地方。
如上图所示：
所有的请求都经过proxy代理，proxy代理转发给Core services和Registry，其中Core services包括UI界面、token令牌和webhook网页服务功能，Registry主要提供镜像存储功能。如果要进行下载上传镜像，要经过token令牌验证然后从Registry获取或上传镜像，每一次下载或上传都会生成日志记录，会记入Log collector，而用户身份权限及一些镜像语言信息会被存储在Database中。
Harbor的每个组件都是以Docker 容器的形式构建的，因此，使用Docker Compose 来对它进行部署。
总共分为7个容器运行，通过在docker-compose.yml所在目录中执行docker-compose ps命令来查看，
名称分别为: nginx、 harbor-jobservice、 harbor-ui、 harbor-db、harbor-adminserver、registry、 harbor-log.
其中harbor-adminserver主要是作为一个后端的配置数据管理，并没有太多的其他功能。harbor-ui所要操作的所有数据都通过harbor-adminserver这样一个数据配置管理中心来完成。
二、Harbor部署
Harbor服务器 192.168.190.2
client服务器 192.168.190.3
1、部署 Harbor 服务
Harbor 被部署为多个 Docker 容器，因此可以部署在任何支持 Docker 的 Linux 发行版 上。
服务端主机需要安装 Python、Docker 和 Docker Compose。
安装包：harbor-offline-installer-v1.2.2.tgz、docker-compose
cd /usr/local
rz docker-compose
chmod +x docker-compose
mv docker-compose /usr/bin
rz harbor-offline-installer-v1.2.2.tgz
tar zxvf harbor-offline-installer-v1.2.2.tgz -C /usr/local/
==配置Harbor参数文件==
vim /usr/local/harbor/harbor.cfg
==第5行修改==
hostname = 192.168.190.2
sh /usr/local/harbor/install.sh
docker ps
docker images
检查服务容器是否开启
cd /usr/local/harbor/
docker-compose ps
2、真机访问
浏览器访问 http://192.168.190.2 的管理页面，默认的管理员用户名和密码是 admin/Harbor12345。
添加项目并且填写项目名称
3、在本地测试仓库功能
Harbor服务器 192.168.190.2
此时可使用 Docker 命令在本地通过 127.0.0.1 来登录和推送镜像。默认情况下，
Register 服务器在端口 80 上侦听。
#登陆
docker login -u admin -p Harbor12345 http://127.0.0.1
#下载镜像进行测试
docker pull nginx
#镜像打标签
docker tag nginx 127.0.0.1/myproject-gc/tomcat:v1
#上传镜像到Harbor
docker push 127.0.0.1/myproject-gc/tomcat:v1
验证是否上传成功
4、在客户端上传镜像
以上操作都是在 Harbor 服务器本地操作。如果其他客户端上传镜像到 Harbor，就会报如下错误。
出现这问题的原因 Docker Registry 交互默认使用的是 HTTPS，但是搭建私有镜像默认使用的是 HTTP 服务，所以与私有镜像交互时出现以下错误。
client服务器 192.168.190.3
docker login -u admin -p Harbor12345 http://192.168.190.2
解决方法
vim /usr/lib/systemd/system/docker.service
添加 --insecure-registry serverIP
ExecStart=/usr/bin/dockerd -H fd:// --insecure-registry 192.168.190.2 --containerd=/run/containerd/containerd.sock
systemctl daemon-reload
systemctl restart docker
docker pull nginx
docker tag nginx:latest 192.168.190.2/myproject-gc/nginx2:v2
docker push 192.168.190.2/myproject-gc/nginx2:v2
图形界面查看
5、维护管理Harbor
可以使用 docker-compose 来管理 Harbor。一些有用的命令如下所示，必须在与
docker-compose.yml 相同的目录中运行。
修改 Harbor.cfg 配置文件
要更改 Harbour 的配置文件时，请先停止现有的 Harbour 实例并更新 Harbor.cfg；然
后运行 prepare 脚本来填充配置；最后重新创建并启动 Harbour 的实例。
#卸载
docker-compose down -v
#编辑配置文件
vim harbor.cfg
#填充配置
./prepare
#启动Harbor
docker-compose up -d
#如果报错
解决思路
关闭防火墙、重启docker
systemctl stop firewalld
setenfore 0
systemctl restart docker
停止现有的 Harbor 实例
修改配置文件 Harbor.cfg
运行 prepare 脚本来填充配置
重启服务
6、创建 Harbor 用户
client操作192.168.190.3
docker logout 192.168.190.2
docker login 192.168.190.2
gc
Harbor12345
docker images
docker rmi 192.168.190.2/myproject-gc/nginx2:v2
docker pull 192.168.190.2/myproject-gc/nginx2:v2
图形化界面访问
7、移除 Harbor 服务容器以及全部数据
移除 Harbor 服务容器同时保留镜像数据/数据库
在Harbor服务器192.168.190.2上操作
docker-compose down -v
#如果需要重新部署，需要移除Harbor服务容器全部数据
#持久数据，如镜像，数据库等在宿主机的/data目录下，日志在宿主机的/var/log/Harbor目录下
rm -rf /data/database
rm -rf /data/registry
