文章目录
一、Harbor概述
- Harbor是VMware公司的开源级的企业级DockerRegistry(仓库)项目,项目地址为 https://github.com/vmware/harbor。
- Harbor的目标是帮助用户迅速搭建一个企业级的DockerRegistry服务。
- Harbor以docker公司开源的registry为基础,提供了管理UI,基于角色的访问控制(Role Based Access Control),AD/LDAP集成,以及审计日志(Auditlogging)等企业用户需求的功能,同时还原生支持中文。
- Harbor的每个组件都是以Docker容器的形式构建的,使用docker-compose来对它进行部署。用于部署Harbor的docker-compose模板位于/usr/local/bin/harbor/docker-compose.yml(自定义)。
二、Harbor主要功能
-
基于角色控制:
用户与Docker镜像仓库通过"项目"进行组织管理,一个用户可以对多个镜像仓库在统一命名空间(projec)里有不同的权限 -
图形化用户界面:
用户可以通过浏览器来浏览,检索当前Docker镜像仓库,管理项目和命名空间 -
审计管理:
所有这怒地镜像仓库的错都可以被记录追溯,用于审计管理 -
基于镜像的复制策略:
镜像可以在多个Harbor实例之间进行复制。 -
支持LDAP认证:
Harbor的用户授权可以使用已经存在的用户。 -
镜像删除和垃圾回收:
image可以被删除并且回收image占用的空间。 -
简单的部署功能:
harbor提供了online、offline安装,此外还提供了virtualappliance安装 -
harbor和docker registry的关系:
harbor实质上是对docker registry做了封装,扩展了自己的业务模板
三、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 环境准备
服务器 | IP地址 | 安装软件 |
---|---|---|
harbor | 20.0.0.50 | Docker-ce、docker-compose、Harbor |
client | 20.0.0.60 | Docker-ce |
4.2 安装compose 和 harbor
#网络下载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
#或有工具包的情况下
#配置使用compose命令
cp -p docker-compose /usr/local/bin
chmod +x /usr/local/bin/docker-compose
#在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@harbor ~]# cd /usr/local/harbor/
[root@harbor harbor]# ll
总用量 527664
drwxr-xr-x. 3 root root 23 12月 2 15:24 common
-rw-r--r--. 1 root root 1163 10月 20 2017 docker-compose.clair.yml
-rw-r--r--. 1 root root 1988 10月 20 2017 docker-compose.notary.yml
-rw-r--r--. 1 root root 3191 10月 20 2017 docker-compose.yml
-rw-r--r--. 1 root root 4304 10月 20 2017 harbor_1_1_0_template
-rw-r--r--. 1 root root 4345 10月 20 2017 harbor.cfg
-rw-r--r--. 1 root root 539885476 10月 20 2017 harbor.v1.2.2.tar.gz
-rwxr-xr-x. 1 root root 5332 10月 20 2017 install.sh
-rw-r--r--. 1 root root 371640 10月 20 2017 LICENSE
-rw-r--r--. 1 root root 482 10月 20 2017 NOTICE
-rwxr-xr-x. 1 root root 17592 10月 20 2017 prepare
-rwxr-xr-x. 1 root root 4550 10月 20 2017 upgrade
- 修改harbor的参数文件harbor.cfg,修改为harbor服务器IP地址,不能使用 localhost 或者127.0.0.1
- [root@harbor harbor]# vi harbor.cfg
- 启动harbor,install.sh会直接调用docker-compose.yml,进行编排容器服务
- sh install.sh
- harbor安装已经完成,可以查看Harbor启动的镜像和容器服务
docker images #查看镜像
docker ps -a #查看容器
- 可用docker-compose ps查看容器状态,但是需要在/usr/local/harbor目录下执行
- [root@harbor harbor]# docker-compose ps
4.3 harbor 图形化管理
- 在harbor.cfg文件里可以找到登录UI界面的默认用户、密码
- 打开浏览器输入harbor的IP地址登录UI界面
4.4 上传和下载镜像
-
新建项目
-
可设置项目为公开
-
本地上传
#登录
[root@harbor harbor]# docker login -u admin -p Harbor12345 http://127.0.0.1
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
#下载镜像进行测试
[root@harbor harbor]# docker pull nginx
#镜像必须加上标签
[root@harbor harbor]# docker tag nginx:latest 127.0.0.1/hyc-web/nginx:v1
#上传镜像
[root@harbor harbor]# docker push 127.0.0.1/hyc-web/nginx:v1
The push refers to repository [127.0.0.1/hyc-web/nginx]
7e914612e366: Pushed
f790aed835ee: Pushed
850c2400ea4d: Pushed
7ccabd267c9f: Pushed
f5600c6330da: Pushed
v1: digest: sha256:99d0a53e3718cef59443558607d1e100b325d6a2b678cd2a48b05e5e22ffeb49 size: 1362
# 删除镜像,重新下载
[root@harbor ~]# docker images
REPOSITORY TAG IMAGE ID CREATED SIZE
127.0.0.1/hyc-web/nginx v1 bc9a0695f571 7 days ago 133MB
nginx latest bc9a0695f571 7 days ago
[root@harbor ~]# docker rmi 127.0.0.1/hyc-web/nginx:v1
[root@harbor ~]# docker rmi nginx:latest
[root@harbor ~]# docker pull 127.0.0.1/hyc-web/nginx:v1
v1: Pulling from hyc-web/nginx
852e50cd189d: Pull complete
571d7e852307: Pull complete
addb10abd9cb: Pull complete
d20aa7ccdb77: Pull complete
8b03f1e11359: Pull complete
Digest: sha256:99d0a53e3718cef59443558607d1e100b325d6a2b678cd2a48b05e5e22ffeb49
Status: Downloaded newer image for 127.0.0.1/hyc-web/nginx:v1
127.0.0.1/hyc-web/nginx:v1
4.4 在客户端上操作Harbor
- 指明docker仓库地址
[root@client ~]# vi /usr/lib/systemd/system/docker.service
[root@client ~]# systemctl daemon-reload
[root@client ~]# systemctl restart docker
#登录并下载镜像
[root@client ~]# docker login -u admin -p Harbor12345 http://20.0.0.50
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
[root@client ~]# docker pull 20.0.0.50/hyc-web/nginx:v1
v1: Pulling from hyc-web/nginx
852e50cd189d: Pull complete
571d7e852307: Pull complete
addb10abd9cb: Pull complete
d20aa7ccdb77: Pull complete
8b03f1e11359: Pull complete
Digest: sha256:99d0a53e3718cef59443558607d1e100b325d6a2b678cd2a48b05e5e22ffeb49
Status: Downloaded newer image for 20.0.0.50/hyc-web/nginx:v1
20.0.0.50/hyc-web/nginx:v1
五、Harbor 管理维护
5.1 修改 Harbor.cfg 配置文件
- 修改harbor.cfg配置文件,先停止现有的Harbor实例并更新harbor.cfg中的配置,然后再运行prepare脚重新加载配置,最后重新创建并且启动harbor的实例。
#关闭所有容器
[root@harbor ~]# cd /usr/local/harbor/
[root@harbor harbor]# docker-compose down -v
Stopping harbor-jobservice ... done
Stopping nginx ... done
Stopping harbor-ui ... done
Stopping harbor-db ... done
Stopping harbor-adminserver ... done
Stopping registry ... done
Stopping harbor-log ... done
Removing harbor-jobservice ... done
Removing nginx ... done
Removing harbor-ui ... done
Removing harbor-db ... done
Removing harbor-adminserver ... done
Removing registry ... done
Removing harbor-log ... done
Removing network harbor_harbor
#根据需求修改
[root@harbor harbor]# vi harbor.cfg
#重新加载配置文件
[root@harbor harbor]# ./prepare
#重启服务
[root@harbor harbor]# systemctl restart docker
[root@harbor harbor]# docker-compose up -d
Creating network "harbor_harbor" with the default driver
Creating harbor-log ... done
Creating harbor-adminserver ... done
Creating registry ... done
Creating harbor-db ... done
Creating harbor-ui ... done
Creating nginx ... done
Creating harbor-jobservice ... done
5.2 UI 界面操作创建用户