目录
- 一、Harbor简介
- 二、Harbor 的主要功能
- 三、Harbor 架构组件
- 四、Harbor 部署
- 4.1、环境准备
- 4.2、安装compose 和 harbor
- 4.3、harbor 图形化管理
- 4.4、客户端远程访问管理 harbor
- 4.5、客户端下载、上传镜像到私有仓库
- 4.6、总结
- 五、Harbor 管理维护
- 5.1、修改 Harbor.cfg 配置文件
- 5.2、UI 界面操作
一、Harbor简介
- 虽然Docker官方提供了公共的镜像仓库，但是从安全和效率等方面考虑，部署我们私有环境内的Registry也是非常必要的。
- Harbor是由VMware公司开源的企业级的Docker Registry管理项目，相比docker官方拥有更丰富的权限权利和完善的架构设计，适用大规模docker集群部署提供仓库服务。
- 它主要提供 Dcoker Registry 管理界面UI，可基于角色访问控制,镜像复制， AD/LDAP 集成，日志审核等功能，完全的支持中文。
二、Harbor 的主要功能
- 基于角色的访问控制
用户与Docker镜像仓库通过“项目”进行组织管理，一个用户可以对多个镜像仓库在同一命名空间（project）里有不同的权限。 - 基于镜像的复制策略
镜像可以在多个Registry实例中复制（可以将仓库中的镜像同步到远程的Harbor，类似于MySQL主从同步功能），尤其适合于负载均衡，高可用，混合云和多云的场景。 - 图形化用户界面
用户可以通过浏览器来浏览，检索当前Docker镜像仓库，管理项目和命名空间。 - 支持 AD/LDAP
Harbor可以集成企业内部已有的AD/LDAP，用于鉴权认证管理。 - 镜像删除和垃圾回收
Harbor支持在Web删除镜像，回收无用的镜像，释放磁盘空间。image可以被删除并且回收image占用的空间。 - 审计管理
所有针对镜像仓库的操作都可以被记录追溯，用于审计管理。 - RESTful API
RESTful API 提供给管理员对于Harbor更多的操控, 使得与其它管理软件集成变得更容易。 - 部署简单
提供在线和离线两种安装工具， 也可以安装到vSphere平台(OVA方式)虚拟设备。
Harbor 的所有组件都在 Docker 中部署，所以 Harbor 可使用 Docker Compose 快速部署。
注意： 由于 Harbor 是基于 Docker Registry V2 版本，所以 docker 版本必须 > = 1.10.0 docker-compose >= 1.6.0
三、Harbor 架构组件
1、Proxy：反向代理工具
2、Registry：负责存储docker镜像，处理上传/下载命令。对用户进行访问控制，它指向一个token服务，强制用户的每次docker pull/push请求都要携带一个合法的token，registry会通过公钥对token进行解密验证。
3、Core service：Harbor的核心功能：
- UI：图形界面
- Webhook：及时获取registry上image状态变化情况，在registry上配置 webhook，把状态变化传递给UI模块。
- Token服务：复杂根据用户权限给每个docker push/p/ull命令签发token。Docker客户端向registry服务发起的请求，如果不包含token，会被重定向到这里，获得token后再重新向registry进行请求。
4、Database：提供数据库服务，存储用户权限，审计日志，docker image分组信息等数据
5、Log collector：为了帮助监控harbor运行，复责收集其他组件的log，供日后进行分析
四、Harbor 部署
4.1、环境准备
- harbor (harbor服务端，用于搭建私有仓库)
10.0.0.30 docker-ce、docker-compose（必须安装）、Harbor - client（客户端，用于远程访问私有仓库） 10.0.0.40 docker-ce
4.2、安装compose 和 harbor
#在线下载docker-compose包
curl -L https://github.com/docker/compose/releases/download/1.21.1/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-compose
cp -p docker-compose /usr/local/bin/
#在harbor服务器上，在线下载harbor安装包
wget http://harbor.orientsoft.cn/harbor-1.2.2/harbor-offline-installer-v1.2.2.tgz
#解压到/usr/local中
tar zxvf harbor-offline-installer-v1.2.2.tgz -C /usr/local/
[root@localhost bin]# cd /usr/local/harbor/ #在下图中可以看到install.sh脚本，还有.yml结尾的编排文件
#修改harbor的参数文件harbor.cfg
vi harbor.cfg
hostname = 10.0.0.30 ## 第5行修改为harbor服务器IP地址，不能使用 localhost 或者127.0.0.1
#启动harbor，install.sh会直接调用docker-compose.yml，进行编排容器服务
sh /usr/local/harbor/install.sh
#到这里，harbor安装已经完成，可以查看Harbor启动的镜像和容器服务
docker images #查看镜像
docker ps -a #查看容器
也可用docker-compose ps查看容器状态，但是需要在/usr/local/harbor目录下执行
[root@harbor harbor]# pwd
/usr/local/harbor
[root@harbor harbor]# docker-compose ps #可以看到安装了7个容器
4.3、harbor 图形化管理
在harbor.cfg文件里可以找到登录UI界面的默认用户、密码。
打开浏览器输入harbor的IP地址10.0.0.30登录UI界面。
在网页harbor上新建一个私有项目project ，用来测试上传、下载镜像
#登录harbor的字符界面
docker login -u admin -p Harbor12345 http://127.0.0.1/
#先从官方公有仓库下载一个镜像
docker pull nginx
#修改特定的标签，这个标签不能改，127.0.0.1代表本地地址，project指定项目，nginx:v1指定具体镜像名称和版本
docker tag nginx:latest 127.0.0.1/project/nginx:v1
#上传镜像到私有仓库
docker push 127.0.0.1/project/nginx:v1
#注意：在harbor服务器上登录、定制tag、上传镜像都需要使用127.0.0.1,而不可以使用10.0.0.30,否则会出现错误
4.4、客户端远程访问管理 harbor
#必须要先指定私有仓库的地址
vi /usr/lib/systemd/system/docker.service
#添加
ExecStart=/usr/bin/dockerd -H fd:// --insecure-registry 10.0.0.30 --containerd=/run/containerd/containerd.sock
#重启服务
[root@client ~]# systemctl daemon-reload
[root@client ~]# systemctl restart docker.service
#登录
[root@client ~]# docker login -u admin -p Harbor12345 http://10.0.0.30
4.5、客户端下载、上传镜像到私有仓库
1、下载私有仓库的镜像
[root@client ~]# docker pull 10.0.0.30/project/nginx:v1
2、上传镜像到私有仓库
#先从官方仓库下载nginx镜像
[root@localhost system]# docker pull nginx
#给nginx镜像打标签
[root@localhost system]# docker tag nginx:latest 10.0.0.30/project/nginx:v2
[root@localhost system]# docker images
#上传镜像到私有仓库
[root@localhost ~]# docker push 10.0.0.30/project/nginx:v2
The push refers to repository [10.0.0.30/project/nginx]
7e914612e366: Layer already exists
f790aed835ee: Layer already exists
850c2400ea4d: Layer already exists
7ccabd267c9f: Layer already exists
f5600c6330da: Layer already exists
v2: digest: sha256:99d0a53e3718cef59443558607d1e100b325d6a2b678cd2a48b05e5e22ffeb49 size: 1362我们在 harbor 界面验证镜像是否上传到私有仓库。
4.6、总结
在搭建过程中，要注意客户端远程登录私有仓库时，必须先在docker.service文件里指明仓库地址，然后加载并重启docker，之后才能登录。
否则出现下图中的报错。
vi /usr/lib/systemd/system/docker.service
#添加
ExecStart=/usr/bin/dockerd -H fd:// --insecure-registry 10.0.0.30 --containerd=/run/containerd/containerd.sock
#重启服务
[root@client ~]# systemctl daemon-reload
[root@client ~]# systemctl restart docker.service五、Harbor 管理维护
5.1、修改 Harbor.cfg 配置文件
- 修改harbor.cfg配置文件，先停止现有的Harbor实例并更新harbor.cfg中的配置，然后再运行prepare脚重新加载配置，最后重新创建并且启动harbor的实例。
详细步骤如下：
1、关闭所有容器
[root@harbor harbor]# pwd
/usr/local/harbor
[root@harbor harbor]# docker-compose down -v
2、修改参数文件
[root@harbor harbor]# pwd
/usr/local/harbor
[root@harbor harbor]# vi harbor.cfg ##修改配置参看实际需求
[root@localhost harbor]# ls #目录下有prepare脚本，下一步执行
common docker-compose.yml harbor.v1.2.2.tar.gz NOTICE
docker-compose.clair.yml harbor_1_1_0_template install.sh prepare
docker-compose.notary.yml harbor.cfg LICENSE upgrade
3、重新加载配置文件，重启服务
[root@harbor harbor]# ./prepare
[root@server3 harbor]# systemctl daemon-reload
[root@harbor harbor]# systemctl restart docker ##重启docker服务
[root@harbor harbor]# docker-compose up -d ##启动容器服务
Creating network "harbor_harbor" with the default driver
Creating harbor-log ... done
Creating harbor-db ... done
Creating registry ... done
Creating harbor-adminserver ... done
Creating harbor-ui ... done
Creating nginx ... done
Creating harbor-jobservice ... done5.2、UI 界面操作
创建新用户 test-tom，记住创建的密码，稍后使用 。
在项目里添加新的用户成员。
在client上，使用新用户远程登录harbor，来进行下载和上传镜像
#首先退出已登陆的账号
[root@localhost ~]# docker logout http://10.0.0.30
Removing login credentials for 10.0.0.30
#使用新的账户登录
[root@client ~]# docker login http://10.0.0.30
下载 harbor 仓库内的镜像
上传镜像
1、改成私有仓库的专有标签
[root@localhost ~]# docker tag 10.0.0.30/project/nginx:v1 10.0.0.30/project/nginx:v3
2、上传镜像到私有仓库
[root@localhost ~]# docker push 10.0.0.30/project/nginx:v3
查看UI界面显示上传成功！
本文章为转载内容，我们尊重原作者对文章享有的著作权。如有内容错误或侵权问题，欢迎原作者联系我们进行内容更正或删除文章。
