Docker--harbor私有仓库

目录

一、什么是Harbor？

二、Harbor的特性

三、Harbor的构成

四、部署

五、维护管理Harbor

---

一、什么是Harbor？

Harbor 是 VMware 公司开源的企业级 Docker Registry 项目，其目标是帮助用户迅速搭建一个企业级的 Docker Registry 服务。

二、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做了封装，扩展了自己的业务模板。

三、Harbor的构成

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

1、Proxy: nginx反向代理。

2、Registry: 负责储存 Docker 镜像。
3、Core services: Harbor的核心功能，主要提供以下3个服务:
1）UI（harbor-ui）: 提供图形化界面。
2）WebHook：为了及时获取Registry上image 状态变化的情况，把状态变化传递给 UI 模块。
3）Token 服务：负责根据用户权限给每个 Docker push/pull 命令签发 Token。

4、Database（harbor-db）：为core services提供数据库服务，负责储存用户权限、审计日志、Docker 镜像分组信息等数据。

5、Job services: 主要用于镜像复制，与远程 Harbor 实例同步镜像。

6、Log collector（harbor-log）: 负责收集其他组件的日志到一个地方。

四、部署

环境：

Harbor服务器            192.168.246.10       docker-ce、docker-compose、harbor-offline-v1.2.2
client服务器               192.168.246.11       docker-ce1. 部署 Docker-Compose 服务
#下载或者上传 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
chmod +x /usr/local/bin/docker-compose
docker-compose --version

如果在下载过程中出现以下报错：

解决办法·：

vim /etc/hosts

在最后插入以下即可解决

 
2. 部署 Harbor 服务
（1）下载或上传 Harbor 安装程序

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安装的配置文件

vim /usr/local/harbor/harbor.cfg

第5行，修改设置为Harbor服务器的IP地址或者域名

hostname = 192.168.246.10

第59行指定管理员的初始密码

harbor_admin_password = Harbor12345

 

3. 启动 Harbor

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

在配置好了 harbor.cfg 之后，执行 ./prepare 命令，为 harbor 启动的容器生成一些必要的文件（环境）
再执行命令 ./install.sh 以 pull 镜像并启动容器

4. 查看 Harbor 启动镜像

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

 

5. 创建一个新项目
（1）浏览器访问：http://192.168.246.10 登录 Harbor WEB UI 界面，默认的管理员用户名和密码是 admin/Harbor12345

（2）输入用户名和密码登录界面后可以创建一个新项目。点击“+项目”按钮

（3）填写项目名称为“myproject-shh”，点击“确定”按钮，创建新项目

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

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

 这里我用的是自己的ip登录，方法不太一样

#下载镜像进行测试

docker pull nginx

#将镜像打标签
格式：docker tag 镜像:标签  仓库IP/项目名称/镜像名:标签

docker tag nginx:latest 127.0.0.1/myproject-shh/nginx:v1

#上传镜像到 Harbor

docker push 127.0.0.1/myproject-shh/nginx:v1

（5）在 Harbor 界面 myproject-kgc 目录下可看见此镜像及相关信息

五、维护管理Harbor

1. 通过 Harbor Web 创建项目
在 Harbor 仓库中，任何镜像在被 push 到 regsitry 之前都必须有一个自己所属的项目。
单击“+项目”，填写项目名称，项目级别若设置为"私有"，则不勾选。如果设置为公共仓库，则所有人对此项目下的镜像拥有读权限，命令行中不需要执行"Docker login"即可下载镜像，镜像操作与 Docker Hub 一致。

2. 创建 Harbor 用户
（1）创建用户并分配权限
在 Web 管理界面中单击系统管理 -> 用户管理 -> +用户，
填写用户名为“shh-zhangsan”，邮箱为“[email protected]”，全名为“zhangsan”，密码为“Abc123456”，注释为“管理员”（可省略）。
附：用户创建成功后，单击左侧“...”按钮可将上述创建的用户设置为管理员角色或进行删除操作，本例不作任何设置。

（2）添加项目成员
单击项目 -> myproject-shh-> 成员 -> + 成员，填写上述创建的用户 shh-zhangsan 并分配角色为“开发人员”。
附：此时单击左侧“...”按钮仍然可对成员角色进行变更或者删除操作

 

 

（3）在客户端上使用普通账户操作镜像
#删除上述打标签的本地镜像
docker rmi 192.168.246.10/myproject-shh/cirros:v2#先退出当前用户，然后使用上述创建的账户 shh-zhangsan 登录

docker logout 192.168.246.10
docker login 192.168.246.10
或者
docker login -u shh-zhangsan -p Abc123456 http://192.168.246.10

 

//下载和上传镜像进行测试

docker pull 192.168.246.10/myproject-shh/cirros:v2
docker tag cirros:latest 192.168.246.10/myproject-shh/cirros:v3
docker push 192.168.246.10/myproject-shh/cirros:v3

 

3. 查看日志
Web 界面日志，操作日志按时间顺序记录用户相关操作

4. 修改 Harbor.cfg 配置文件
要更改 Harbor的配置文件中的可选参数时，请先停止现有的 Harbor实例并更新 Harbor.cfg；然后运行 prepare 脚本来填充配置； 最后重新创建并启动 Harbor 的实例。使用 docker-compose 管理 Harbor 时，必须在与 docker-compose.yml 相同的目录中运行。

cd /usr/local/harbor
docker-compose down -v
vim harbor.cfg            #只能修改可选参数
./prepare
docker-compose up -d

#如果有以下报错，需要开启防火墙 firewalld 服务解决
Creating network "harbor_harbor" with the default driver
ERROR: Failed to Setup IP tables: Unable to enable SKIP DNAT rule:  (iptables failed: iptables --wait -t nat -I DOCKER -i br-b53c314f45e8 -j RETURN: iptables: No chain/target/match by that name.
 (exit status 1))

systemctl restart firewalld.service
docker-compose up -d

5. 移除 Harbor 服务容器同时保留镜像数据/数据库，并进行迁移
在Harbor服务器上操作
（1）移除 Harbor 服务容器

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

（2）把项目中的镜像数据进行打包
持久数据，如镜像，数据库等在宿主机的/data/目录下，日志在宿主机的/var/log/Harbor/目录下

ls /data/registry/docker/registry/v2/repositories/myproject-shh
cd /data/registry/docker/registry/v2/repositories/myproject-shh
tar zcvf kgc-registry.tar.gz ./*

6. 如需重新部署，需要移除 Harbor 服务容器全部数据

cd /usr/local/harbor
docker-compose down -v
rm -r /data/database
rm -r /data/registry