摘要:Docker
,Harbor
Harbor简介
Harbor是一个用于存储和分发Docker镜像的企业级Registry服务器,虽然Docker官方也提供了公共的镜像仓库,但是从安全和效率等方面考虑,部署企业内部的私有环境Registry是非常必要的,Harbor和docker中央仓库的关系,就类似于nexus和Maven中央仓库的关系,Harbor除了存储和分发镜像外还具有用户管理,项目管理,配置管理和日志查询,高可用部署等主要功能
Harbor搭建
在本地搭建一个Harbor服务,其他在同一局域网的机器可以使用Harbor进行镜像提交和拉取,搭建前需要本地安装docker服务和docker-compose,docker-compose可以直接使用pip安装
pip install docker-compose
下载Harbor离线安装包harbor-offline-installer-v2.1.0.tgz
,在github官网https://github.com/goharbor/harbor/releases
或者其他资源链接下载,下载后解压
tar -zxvf harbor-offline-installer-v2.1.0.tgz
解压完成后在当前目录生成harbor目录,复制和修改harbor目录下的harbor.yml
cp harbor.yml.tmpl harbor.yml
注释掉https的配置内容,配置http相关的参数,主要是hostname,port,其他都可以不用动
# vim harbor.yml
hostname: 10.3.10.55
# http related config
http:
# port for http, default is 80. If https enabled, this port will redirect to https port
port: 8081
进行本地安装
bash prepare
bash install.sh
安装完成后在本地生成docker-compose.yml
文件,此时可以启动harbor服务
docker-compose up -d
打开在harbor.yml中噢诶之的host和port,10.3.10.55:8081
初始的默认用户是admin
,密码是Harbor12345
,登录成功
下一步使用docker login到私服,需要将私服的http地址配置到docker的不安全register中
# vim /etc/docker/daemon.json
{
"insecure-registries": ["10.3.10.55:8081"]
}
重启docker服务后可以正常login进docker私服
systemctl daemon-reload && systemctl restart docker
docker login 10.3.10.55:8081
user:admin
password:
Login Succeeded
Harbor Web客户端基础使用
左侧功能栏分为三大块,项目,日志和系统管理
(1)修改admin登录密码
修改admin登录密码,点击右上角用户名->修改密码
(2)新增用户
点击左侧系统管理->用户管理->创建用户
可以进一步设置为管理员
(3)新增项目和设置项目成员权限
镜像都需要根据项目名做分类索引进行存放,新建一个项目,点击项目->新建项目
将项目设置为公开,所有用户都可以读取,如果设置了私有项目,只有登陆了相关用户才可以操作,默认是私有项目
点击进行新建的项目,创建项目成员
添加用户xiaogp,角色是开发者,管理员对项目拥有所有操作权限,push/pull/delete/复制策略等操作,开发人员只能push/pull,访客只能pull
添加完成后项目拥有两个项目成员,分别是管理员admin和开发者xiaogp,可以点击其他操作修改成员的权限或者移除成员
Harbor上传和拉取镜像
上传镜像需要在docker主机进行操作,对于私有项目必须登录Harbor私服才能进行pull和push操作,push到Harbor的镜像的命名必须按照如下规则
{Harbor地址}:{端口}/{Harbor项目名}/{自定义镜像名}:{自定义tag}
由于harbor采用的是http服务,而docker仓库默认采用https,如果对私服采用docker login、pull、push等命令操作非https的docker regsitry的时就会报错,所以需要在docker的配置文件中将harbor私服地址配置到insecure-registry
作为不安全的地址运行访问
# touch /etc/docker/daemon.json
# vim /etc/docker/daemon.json
{
"insecure-registries": ["192.168.1.28:80"]
}
重启docker,查看docker info是否配置私服地址成功
systemctl daemon-reload && systemctl restart docker
# docker info
Insecure Registries:
192.168.1.28:80 # 已经配置成功
127.0.0.0/8
下一步测试登录私服,登录成功
root@ubuntu:~# docker login 192.168.1.28:80 -u xiaogp
Password:
WARNING! Your password will be stored unencrypted in /home/xiaogp/.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本机的镜像上传push到harbor,先使用docker tag
创建一个新的镜像并且重命名为harbor指定的ip:host/项目名
格式,然后直接push
root@ubuntu:~# docker tag xiaogp/my_image_test:v1 192.168.1.28:80/test_public/my_image_test:v1
root@ubuntu:~# docker push 192.168.1.28:80/test_public/my_image_test:v1
The push refers to repository [192.168.1.28:80/test_public/my_image_test]
bc6c5868a244: Pushed
52cec1fdc1f3: Pushed
6b24a3d04a66: Pushed
d5f992479e0c: Pushed
5adaa6cddd5f: Pushed
9f5b4cdea532: Pushed
cd702377e4e5: Pushed
aa7af8a465c6: Pushed
ef9a7b8862f4: Pushed
a1f2f42922b1: Pushed
4762552ad7d8: Pushed
v1: digest: sha256:567000120e42943f598efe5084006ffa5f307f4ffbd8871003602351876aba1b size: 2640
在harbot web客户端查看镜像,在test_public下已经可以查看到镜像
近一步点进去可以查看镜像的标签信息,点击操作可以对镜像进行添加标签,删除等操作,当前界面是以xiaogp用户(开发者)进行登录的,因此没有删除权限,也没有左侧的系统管理栏
在harbor的主机的/data/registry/docker/registry/v2/
目录下可以查到到镜像的存储位置
root@ubuntu:/data/registry/docker/registry/v2/repositories# ll
total 12
drwxr-xr-x 3 10000 10000 4096 7月 17 17:25 ./
drwxr-xr-x 4 10000 10000 4096 7月 17 17:25 ../
drwxr-xr-x 3 10000 10000 4096 7月 17 17:25 test_public/
下一步在另一台docker机器从私服拉去镜像,确保这台机器和私服ip互通,并且将私服地址添加到docker的不安全仓库地址配置文件中,直接使用docker pull
命令拉取私服镜像
root@cloudera01:~# docker pull 192.168.1.28:80/test_public/my_image_test:v1
对于公开项目不需要login就可以被能够访问到私服的用户拉取和上传,但是对于私有项目需要login才能进行操作,先创建一个私有仓库test_private
然后进行tag和push,报错未授权访问存储库
root@ubuntu:~# docker tag xiaogp/my_image_test:v1 192.168.1.28:80/test_private/my_image_test:v1
root@aubuntu:~# docker push 192.168.1.28:80/test_private/my_image_test:v1
The push refers to repository [192.168.1.28:80/test_private/my_image_test]
bc6c5868a244: Preparing
52cec1fdc1f3: Preparing
6b24a3d04a66: Preparing
d5f992479e0c: Preparing
5adaa6cddd5f: Preparing
9f5b4cdea532: Waiting
cd702377e4e5: Waiting
aa7af8a465c6: Waiting
ef9a7b8862f4: Waiting
a1f2f42922b1: Waiting
4762552ad7d8: Waiting
unauthorized: unauthorized to access repository: test_private/my_image_test, action: push: unauthorized to access repository: test_private/my_image_test, action: push
测试使用admin项目管理员权限登录私服在上传,成功
root@ubuntu:~# docker login 192.168.1.28:80 -uadmin
Password:
WARNING! Your password will be stored unencrypted in /home/xiaogp/.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@ubuntu:~# docker push 192.168.1.28:80/test_private/my_image_test:v1
The push refers to repository [192.168.1.28:80/test_private/my_image_test]
bc6c5868a244: Pushed
52cec1fdc1f3: Pushed
6b24a3d04a66: Pushed
d5f992479e0c: Pushed
5adaa6cddd5f: Pushed
9f5b4cdea532: Pushed
cd702377e4e5: Pushed
aa7af8a465c6: Pushed
ef9a7b8862f4: Pushed
a1f2f42922b1: Pushed
4762552ad7d8: Pushed
v1: digest: sha256:567000120e42943f598efe5084006ffa5f307f4ffbd8871003602351876aba1b size: 2640
如果以普通账号(xiaogo访客权限)登录,报错未授权访问存储库,访客权限不能push镜像
root@ubuntu:~# docker login 192.168.1.28:80 -uxiaogp
Password:
WARNING! Your password will be stored unencrypted in /home/xiaogp/.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@ubuntu:~# docker push 192.168.1.28:80/test_private/my_image_test:v1
The push refers to repository [192.168.1.28:80/test_private/my_image_test]
bc6c5868a244: Layer already exists
52cec1fdc1f3: Layer already exists
6b24a3d04a66: Layer already exists
d5f992479e0c: Layer already exists
5adaa6cddd5f: Layer already exists
9f5b4cdea532: Layer already exists
cd702377e4e5: Layer already exists
aa7af8a465c6: Layer already exists
ef9a7b8862f4: Layer already exists
a1f2f42922b1: Layer already exists
4762552ad7d8: Layer already exists
unauthorized: unauthorized to access repository: test_private/my_image_test, action: push: unauthorized to access repository: test_private/my_image_test, action: push
对于已经在harbor上存在的镜像,如果修改了原镜像层,指定同样的tag再次上传,则会用新上传的镜像更新旧的到最新,以最新上传的镜像作为指定的tag,之前的镜像依旧存在但是tag置位空
可以在垃圾清理栏中勾选回收无tag的镜像进行清理删除
执行完毕后在test_private下已经没有旧的被更新的镜像,在删除日志中也可以查到删除的镜像名