Harbor概述

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

Harbor的特性

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

Harbor的构成

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

Harbor组件	说明
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个服务: 1）UI（harbor-ui）: 提供图形化界面，帮助用户管理 Registry 上的镜像（image）, 并对用户进行授权。 2）WebHook：为了及时获取Registry 上image 状态变化的情况，在Registry 上配置 Webhook，把状态变化传递给 UI 模块。 3）Token 服务：负责根据用户权限给每个 Docker push/pull 命令签发 Token。Docker 客户端向 Registry 服务发起的请求，如果不包含 Token，会被重定向到 Token 服务，获得 Token 后再重新向 Registry 进行请求。
Database（harbor-db）	为core services提供数据库服务，负责储存用户权限、审计日志、Docker 镜像分组信息等数据。
Job services	主要用于镜像复制，本地镜像可以被同步到远程 Harbor 实例上。
Log collector（harbor-log）	负责收集其他组件的日志到一个地方。

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

服务器	IP地址
Harbor服务器	192.168.20.20
client服务器 192.168.20.10

案例需求

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

实验准备

在服务端安装docker和docker-compose 客户端上安装docker 关闭防火墙修改主机名

实验步骤

1. 部署 Harbor 服务

Harbor 被部署为多个 Docker 容器，因此可以部署在任何支持 Docker 的 Linux 发行版上。服务端主机需要安装Docker 和 Docker Compose。安装Docker Compose如下

放入命令压缩包
cp -p docker-compose /usr/local/bin/
chmod +x /usr/local/bin/docker-compose

1）下载 Harbor 安装程序

Harbor：192.168.20.20

//在线下载
wget http:// harbor.orientsoft.cn/harbor-1.2.2/harbor-offline-installer-v1.2.2.tgz

//如果在先下载慢，可以使用上面的链接下载，在拖入
tar zxvf harbor-offline-installer-v1.2.2.tgz -C /usr/local/

2）配置 Harbor 参数文件

Harbor：192.168.20.20

vim /usr/local/harbor/harbor.cfg

//第5行
hostname = 192.168.163.143

3）启动 Harbor

Harbor：192.168.20.20

cd /usr/local/harbor/
./prepare
./install.sh

4）查看 Harbor 启动镜像和容器

Harbor：192.168.20.20

#查看镜像
docker images

#查看容器
docker ps -a

检查服务容器是否开启

cd /usr/local/harbor/
docker-compose ps

5）在UI界面创建项目

真机上图检查一切正常，此时可以打开浏览器访问 http://192.168.20.20 的管理页面，默认的管理员用户名和密码是 admin/Harbor12345。

如果打不开页面就打开路由转发功能

登录后的页面添加项目并且填写项目名称

6）在本地测试仓库功能

Harbor：192.168.20.20

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

1.登录

docker login -u admin -p Harbor12345 http://127.0.0.1

2.下载镜像进行测试

docker pull nginx

3.镜像打标签

docker tag nginx 127.0.0.1/myproject/nginx:v1

4.上传镜像到Harbor

docker push 127.0.0.1/myproject/nginx:v1

5.验证是否上传成功

7）在客户端上传镜像

client：192.168.20.10

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

docker login  -u admin -p Harbor12345 http://192.168.20.20
#-------------------输出内容------------------------------------------
WARNING! Using --password via the CLI is insecure. Use --password-stdin.
Error response from daemon: Get https://192.168.20.20/v2/: dial tcp 192.168.20.20:443: connect: connection refused

解决方法

vim /usr/lib/systemd/system/docker.service
#--------------------修改内容-----------------------------------
ExecStart=/usr/bin/dockerd -H fd:// --insecure-registry 192.168.20.20 --containerd=/run/containerd/containerd.sock
#---------------------------------------------------------------

//重启服务
systemctl daemon-reload 
systemctl restart docker

//再次登录
docker login  -u admin -p Harbor12345 http://192.168.20.20
#----------------------输出内容--------------------------------------------
WARNING! Using --password via the CLI is insecure. Use --password-stdin.
WARNING! Your password will be stored unencrypted in /root/.docker/config.json.
Configure a credential helper to remove this warning. See
https://docs.docker.com/engine/reference/commandline/login/#credentials-store

Login Succeeded
#--------------------------------------------------------------------

查看

docker pull tomcat

docker images

docker tag tomcat 192.168.20.20/myproject/tomcat:v2

docker push 192.168.20.20/myproject/tomcat:v2

维护管理Harbor

可以使用 docker-compose 来管理 Harbor。一些有用的命令如下所示，必须在与docker-compose.yml 相同的目录中运行。
修改 Harbor.cfg 配置文件所需选项的步骤要更改 Harbour 的配置文件时，请先停止现有的 Harbor 实例并更新 Harbor.cfg；然后运行 prepare 脚本来填充配置；最后重新创建并启动 Harbour 的实例。

1）停止现有的 Harbor 实例

cd /usr/local/harbor
docker-compose down -v

2）修改配置文件 Harbor.cfg

vim harbor.cfg

3）运行 prepare 脚本来填充配置

./prepare

4）重启服务

docker-compose up -d

创建 Harbor 用户

删除之前打标签的镜像, 在客户端上操作

docker rmi 192.168.20.20/myproject/tomcat:v2

测试创建的新用户能否使用

//注销登录
docker logout 192.168.20.20

//使用新创建的用户和密码登录私有仓库
docker login 192.168.20.20

//从私有仓库下载镜像
docker pull 192.168.20.20/myproject/nginx:v1

//查看镜像
docker images

移除 Harbor 服务容器以及全部数据

移除 Harbor 服务容器同时保留镜像数据/数据库 //在Harbor服务器上操作

docker-compose down -v

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

rm -rf /data/database/
rm -rf /data/registry/

Docker——harbor私有仓库部署

Harbor概述

Harbor的概念

Harbor的特性

Harbor的构成

Harbor部署

案例需求

实验准备

实验步骤

1. 部署 Harbor 服务

1）下载 Harbor 安装程序

2）配置 Harbor 参数文件

3）启动 Harbor

4）查看 Harbor 启动镜像和容器

5）在UI界面创建项目

6）在本地测试仓库功能

1.登录

2.下载镜像进行测试

3.镜像打标签

4.上传镜像到Harbor

5.验证是否上传成功

7）在客户端上传镜像

维护管理Harbor

1）停止现有的 Harbor 实例

2）修改配置文件 Harbor.cfg

3）运行 prepare 脚本来填充配置

4）重启服务

创建 Harbor 用户

移除 Harbor 服务容器以及全部数据