Docker 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的特性

1.基于角色控制: 用户和仓库都是基于项目进行组织的,而用户在项目中可以拥有不同的权限
2.基于镜像的复制策略: 镜像可以在多个Harbor实例之间进行复制(同步)
3.支持LDAP/AD: Harbor 可以集成企业内部有的AD/LDAP (类似数据库的一-张表),用于对已经存在的用户认证和管理
4.镜像删除和垃圾回收: 镜像可以被删除,也可以回收镜像占用的空间
5.图形化用户界面: 用户可以通过浏览器来浏览,搜索镜像仓库以及对项目进行管理
6.审计管理: 所有针对镜像仓库的操作都可以被记录追溯,用于审计管理
7.支持RESTful API: RESTful API提供给管理员对于Harbor 更多的操控,使得与其它管理软件集成变得更容易
8.Harbor 和docker registry的 关系: Harbor实质 上是对docker registry做 了封装,扩展了自己的业务模板

3.Harbor的构成

Harbor在架构上主要有Proxy、 Registry、 Core services、 Database (Harbor-db) 、Log collector ( Harbor-log)、Job services六个组件

  • Proxy: 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) :负责收集其他组件的日志到一个地方

Docker Harbor(私有仓库)概述及构建过程_nginx

如上图所示:<br/>所有的请求都经过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部署

环境准备

1、环境配置

主机 操作系统 IP地址 软件
Harbor服务器 centos7.6 192.168.19.17 docker-ce、docker-compose、 harbor-offline-v1.2.2
client服务器 centos7.6 192.168.19.18 docker-ce

2、案例需求

通过Harbor创建Docker私有仓库
图形化管理Docker私有仓库镜像

3、部署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

Docker Harbor(私有仓库)概述及构建过程_nginx_02

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.19.18

Docker Harbor(私有仓库)概述及构建过程_nginx_03

Docker Harbor(私有仓库)概述及构建过程_nginx_04

sh /usr/local/harbor/install.sh

Docker Harbor(私有仓库)概述及构建过程_docker_05

Docker Harbor(私有仓库)概述及构建过程_nginx_06

docker ps
docker images

Docker Harbor(私有仓库)概述及构建过程_docker_07

Docker Harbor(私有仓库)概述及构建过程_ä¸Šä¼ _08

docker-compose ps

Docker Harbor(私有仓库)概述及构建过程_ä¸Šä¼ _09

1、此时可真机访问serverIP

192.168.19.17
用户名:admin
密码:Harbor12345

Docker Harbor(私有仓库)概述及构建过程_ä¸Šä¼ _10

Docker Harbor(私有仓库)概述及构建过程_ä¸Šä¼ _11

2、添加项目并填写项目名称

Docker Harbor(私有仓库)概述及构建过程_nginx_12

Docker Harbor(私有仓库)概述及构建过程_ä¸Šä¼ _13

此时可使用 Docker 命令在本地通过 127.0.0.1 来登录和推送镜像。默认情况下,
Register 服务器在端口 80 上侦听

#登陆
docker login -u admin -p Harbor12345 http://127.0.0.1

#下载镜像进行测试
docker pull tomcat

#镜像打标签
docker tag tomcat 127.0.0.1/myproject-lic/tomcat:v1

#上传镜像到Harbor
docker push 127.0.0.1/myproject-lic/tomcat:v1

Docker Harbor(私有仓库)概述及构建过程_docker_14

Docker Harbor(私有仓库)概述及构建过程_nginx_15

查看图形化界面

Docker Harbor(私有仓库)概述及构建过程_ä¸Šä¼ _16

Docker Harbor(私有仓库)概述及构建过程_nginx_17

以上操作都是在 Harbor 服务器本地操作。如果其他客户端上传镜像到 Harbor,就会报
如下错误。出现这问题的原因 Docker Registry 交互默认使用的是 HTTPS,但是搭建私有镜
像默认使用的是 HTTP 服务,所以与私有镜像交互时出现以下错误。

Docker Harbor(私有仓库)概述及构建过程_ä¸Šä¼ _18

解决方法:

vim /usr/lib/systemd/system/docker.service
添加  --insecure-registry serverIP

Docker Harbor(私有仓库)概述及构建过程_nginx_19

systemctl daemon-reload
systemctl restart docker

Docker Harbor(私有仓库)概述及构建过程_docker_20

docker pull nginx
docker tag nginx:latest 192.168.19.18/sweathart-jingjing/nginx:v1
docker push 192.168.19.18/sweathart-jingjing/nginx:v1

Docker Harbor(私有仓库)概述及构建过程_docker_21

.Docker Harbor(私有仓库)概述及构建过程_ä¸Šä¼ _22

图形界面查看

Docker Harbor(私有仓库)概述及构建过程_docker_23

4、维护管理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

5、创建Harbor用户

image.png
image.png

Docker Harbor(私有仓库)概述及构建过程_nginx_26

Docker Harbor(私有仓库)概述及构建过程_nginx_27

Docker Harbor(私有仓库)概述及构建过程_nginx_28

client操作

docker logout 192.168.19.18
docker login 192.168.19.18
jingjing
Harbor12345

docker images
docker rmi 192.168.19.18/sweetheat-jingjing/nginx:v1
docker pull 192.168.19.18/sweetheat-jingjing/nginx:v1

Docker Harbor(私有仓库)概述及构建过程_ä¸Šä¼ _29

图形化界面访问

Docker Harbor(私有仓库)概述及构建过程_docker_30

6、移除 Harbor 服务容器同时保留镜像数据/数据库

在server上进行操作

docker-compose down -v

#如果需要重新部署,需要移除Harbor服务容器全部数据
#持久数据,如镜像,数据库等在宿主机的/data目录下,日志在宿主机的/var/log/Harbor目录下
rm -rf /data/database

rm -rf /data/registry