Docker 私有仓库部署和管理（harbor）

时间：2024-10-22 18:27:32

Docker 私有仓库部署和管理

  • 一、Harbor概述
    • 1、Harbor的基本概述
    • 2、Docker私有仓库架构拓扑图
  • 二、Harbor构建Docker私有仓库
    • 环境部署
    • 案例需求
    • 1、harbor服务的基本操作
      • 1、下载harbor安装程序
      • 2、用普通账户镜像操作
    • 2、harbor的部署
      • 1、查看 Docker-Compose 版本判断安装是否成功
      • 2、部署harbor服务
        • (1)下载 Harbor 安装程序
        • (2) 配置 Harbor 参数文件
        • (3)启动 Harbor
        • (4)查看 Harbor 启动镜像
        • 测试
      • 3、创建Harbor用户

一、Harbor概述

1、Harbor的基本概述

  • harbor是VMware公司开源的企业级Docker Registry项目
  • Docker Harbor有可视化的web管理界面，可以方便管理Docker镜像，又提供了多个项目的镜像权限管理及控制功能
  • harbor的优势
    • 基于角色控制
    • 基于镜像的复制策略
    • 支持LDAP/AD
    • 图像删除和垃圾收集
    • 图形UI
    • 审计
    • RESTful API

2、Docker私有仓库架构拓扑图

mark

  • Proxy
    • 通过一个前置的反向代理统一接收浏览器、Docker客户端的请求，并将请求转发给后端不同的服务
  • Registry
    • 复制储存Docker镜像，并处理docker push/pull命令
  • Core services
    • Harbor的核心功能，包括UI、webhook、token服务
  • Database
    • 为core services提供数据库服务
  • Log collector
    • 负责收集其他的log，供日后进行分析

二、Harbor构建Docker私有仓库

环境部署

主机 操作系统 主机名/IP地址 主要软件及版本
服务器 Centos 7.3-x86_64 Habor/192.168.28.20 docker 19.03、docker-compose、harbor-offline-v1.1.2
客户端 Centos 7.3-x86_64 client/192.168.28.30 docker 19.03

案例需求

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

1、harbor服务的基本操作

1、下载harbor安装程序

wget /harbor-1.2.2/harbor-offline-installer-v1.2.

tar xvf harbor-offline-installer-v1.2. -C /usr/local/
  • 1
  • 2
  • 3

配置harbor参数文件

  • 参数位于文件/usr/lcoal/harbor/
  • harbor所需要的参数
    • hostname、ui_url_protocol、max_job_workers
    • db_password、customize_crt、ssl_cert、ssl_cert_key
    • secretkey_path

harbor可选参数

  • 电子邮件设置、harbour_admin_password、auth_mode
  • self_registration、token_expiration
  • project_creation_restriction、verify_remote_cert

2、用普通账户镜像操作

删除镜像

docker rmi 192.168.28.20/myproject-mxx/nginx:v1
  • 1

登录和登出

docker login 192.168.28.20 	#登录
docker logout 192.168.28.20 	#登出
  • 1
  • 2

下载镜像

docker pull 192.168.28.20/myproject-mxx/nginx:v1
  • 1

修改配置文件

docker-compose down -v		#先停止（移除）
vim 				#再编辑

./prepare					

docker-compose up -d		#启动
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6

移除harbor服务容器同时保留镜像数据/数据库

docker-compose down -v
  • 1

移除harbor服务容器全部数据

rm -r /data/daabase
rm -r /data/registry
  • 1
  • 2

2、harbor的部署

1、查看 Docker-Compose 版本判断安装是否成功

cp docker-compose /usr/local/bin/

docker-compose -v
  • 1
  • 2
  • 3

2、部署harbor服务

Harbor 被部署为多个 Docker 容器，因此可以部署在任何支持 Docker 的 Linux 发行版 上。

  • 服务端主机需要安装 Python、Docker 和 Docker Compose
(1)下载 Harbor 安装程序
wget http:// /harbor-1.2.2/harbor-offline-installer-v1.2.

 

tar zxvf harbor-offline-installer-v1.2. -C /usr/local/
  • 1
  • 2
  • 3
  • 4
  • 5
(2) 配置 Harbor 参数文件
vim /usr/local/harbor/

==修改第5行
hostname = 192.168.28.20
  • 1
  • 2
  • 3
  • 4

关于 配置文件中有两类参数：所需参数和可选参数

（1）所需参数 这些参数需要在配置文件 中设置。

如果用户更新它们并运行 脚本重新安装 Harbour，

参数将生效。具体参数如下：

hostname：用于访问用户界面和 register 服务。它应该是目标机器的 IP 地址或完全限 定的域名（FQDN）

例如 192.168.195.128 或 。不要使用 localhost 或 127.0.0.1 为主机名。

ui_url_protocol：（http 或 https，默认为 http）用于访问 UI 和令牌/通知服务的协议。如果公证处于启用状态，则此参数必须为 https。

max_job_workers：镜像复制作业线程。

db_password：用于db_auth 的MySQL数据库root 用户的密码。

customize_crt：该属性可设置为打开或关闭，默认打开。打开此属性时，准备脚本创建私钥和根证书，用于生成/验证注册表令牌。

当由外部来源提供密钥和根证书时，将此属性设置为 off。

ssl_cert：SSL 证书的路径，仅当协议设置为 https 时才应用。

ssl_cert_key：SSL 密钥的路径，仅当协议设置为 https 时才应用。

secretkey_path：用于在复制策略中加密或解密远程 register 密码的密钥路径。

（2）可选参数

这些参数对于更新是可选的，即用户可以将其保留为默认值，并在启动 Harbor 后在 Web UI 上进行更新。

如果进入 ，只会在第一次启动 Harbor 时生效，随后对这些参数 的更新， 将被忽略。

注意：如果选择通过UI设置这些参数，请确保在启动Harbour后立即执行此操作。具体来说，必须在注册或在 Harbor 中创建任何新用户之前设置所需的

auth_mode。当系统中有用户时（除了默认的 admin 用户），auth_mode 不能被修改。具体参数如下：

Email：Harbor需要该参数才能向用户发送“密码重置”电子邮件，并且只有在需要该功能时才需要。

请注意，在默认情况下SSL连接时没有启用。如果SMTP服务器需要SSL，但不支持STARTTLS，那么应该通过设置启用SSL email_ssl = TRUE。

harbour_admin_password：管理员的初始密码，只在Harbour第一次启动时生效。之后，此设置将被忽略，并且应 UI中设置管理员的密码。

请注意，默认的用户名/密码是 admin/Harbor12345。

auth_mode：使用的认证类型，默认情况下，它是 db_auth，即凭据存储在数据库中。对于LDAP身份验证，请将其设置为 ldap_auth。

self_registration：启用/禁用用户注册功能。禁用时，新用户只能由 Admin 用户创建，只有管理员用户可以在 Harbour中创建新用户。

注意：当 auth_mode 设置为 ldap_auth 时，自注册功能将始终处于禁用状态，并且该标志被忽略。

Token_expiration：由令牌服务创建的令牌的到期时间（分钟），默认为 30 分钟。

project_creation_restriction：用于控制哪些用户有权创建项目的标志。默认情况下， 每个人都可以创建一个项目。

如果将其值设置为“adminonly”，那么只有 admin 可以创建项目。

verify_remote_cert：打开或关闭，默认打开。此标志决定了当Harbor与远程 register 实例通信时是否验证 SSL/TLS 证书。

将此属性设置为 off 将绕过 SSL/TLS 验证，这在远程实例具有自签名或不可信证书时经常使用。

另外，默认情况下，Harbour 将镜像存储在本地文件系统上。在生产环境中，可以考虑 使用其他存储后端而不是本地文件系统，

如 S3、Openstack Swif、Ceph 等。但需要更新 common/templates/registry/ 文件。

(3)启动 Harbor
sh /usr/local/harbor/
  • 1
(4)查看 Harbor 启动镜像
docker images
docker ps -a


cd /usr/local/harbor/
docker-compose ps
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6

mark

mark

测试

如果一切都正常，应该可以打开浏览器访问 http://192.168.28.20 的管理页面，默认 的管理员用户名和密码是 admin/Harbor12345。

mark

//添加项目并且填写项目名称

mark

此时可使用 Docker 命令在本地通过 127.0.0.1 来登录和推送镜像。默认情况下，

Register 服务器在端口 80 上侦听。

//登录

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

mark

//下载镜像进行测试

docker pull cirros
  • 1

//镜像打标签

docker tag cirros 127.0.0.1/myproject-mxx/cirros:v1
  • 1

//上传镜像到Harbor

docker push 127.0.0.1/myproject-mxx/cirros:v1
  • 1

mark

以上操作都是在 Harbor 服务器本地操作。

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

[root@client ~]# docker login  -u admin -p Harbor12345 http://192.168.28.20

WARNING! Using --password via the CLI is insecure. Use --password-stdin.

Error response from daemon: Get https://192.168.28.20/v2/: EOF
  • 1
  • 2
  • 3
  • 4
  • 5

//解决：

1:编辑/usr/lib/systemd/system/

在ExecStart一行中添加--insecure-registry 192.168.28.20

[root@client ~]# vim /usr/lib/systemd/system/
ExecStart=/usr/bin/dockerd -H fd:// --insecure-registry 192.168.28.20 --containerd=/run/containerd/
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
2:重启docker

[root@client ~]# systemctl daemon-reload 

[root@client ~]# systemctl restart docker
  • 1
  • 2
  • 3
  • 4
  • 5
3：尝试登录，结果显示登录成功

[root@client ~]# docker login -u admin -p Harbor12345 http://192.168.28.20
WARNING! Using --password via the CLI is insecure. Use --password-stdin.
WARNING! Your password will be stored unencrypted in /root/.docker/.
Configure a credential helper to remove this warning. See
/engine/reference/commandline/login/#credentials-store
Login Succeeded
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8

这样上述错误就解决了！！

登录完成后，在客户端上尝试传镜像到 Harbor！！！

4：尝试下载镜像cirros
[root@client ~]# docker pull cirros
Using default tag: latest
latest: Pulling from library/cirros
3d6427f49fe3: Pull complete 
1915bfe8159b: Pull complete 
d0ec9ef25b96: Pull complete 
Digest: sha256:8654d33ecbcdc8fd65c80325c3ec3b1bc938dfad9f20d1a2e3cf21e521ab70e6
Status: Downloaded newer image for cirros:latest
/library/cirros:latest
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
5:查看镜像

[root@client ~]# docker images
REPOSITORY      TAG         IMAGE ID       CREATED       SIZE
cirros        latest        bc94bceaae77     11 months ago    10.3MB
  • 1
  • 2
  • 3
  • 4
  • 5
6:给镜像打标签

[root@client ~]# docker tag cirros 192.168.28.20/myproject-mxx/cirros:v2
  • 1
  • 2
  • 3
7:上传镜像

[root@client ~]# docker push 192.168.28.20/myproject-mxx/cirros:v2
The push refers to repository [192.168.195.128/myproject-kgc/cirros]
abbd6d6ac643: Layer already exists 
75b99987219d: Layer already exists 
0cc237193a30: Layer already exists 
v2: digest: sha256:96137d51e0e46006243fa2403723eb47f67818802d1175b5cde7eaa7f19446bd size: 943
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8

mark

3、创建Harbor用户

mark

mark

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-ylYOgmZx-1617007379400)(C:\Users\15670\AppData\Roaming\Typora\typora-user-images\)]

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-R8ieCiWA-1617007379401)(C:\Users\15670\AppData\Roaming\Typora\typora-user-images\)]

mark

//在客户端上操作

[root@client ~]# docker rmi 192.168.28.20/myproject-mxx/cirros:v2

Untagged: 192.168.28.20/myproject-mxx/cirros:v2

Untagged: 192.168.28.20/myproject-kgc/cirros@sha256:96137d51e0e46006243fa2403723eb47f67818802d1175b5cde7eaa7f19446bd
  • 1
  • 2
  • 3
  • 4
  • 5
//注销登录

[root@client ~]# docker logout 192.168.28.20
Removing login credentials for 192.168.28.20
  • 1
  • 2
  • 3
  • 4
//用创建用户登录

[root@client ~]# docker login 192.168.28.20
Username: mxx-zhangsan
Password:   //填写Harbor12345
WARNING! Your password will be stored unencrypted in /root/.docker/.
Configure a credential helper to remove this warning. See
/engine/reference/commandline/login/#credentials-store

Login Succeeded
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
//上传镜像

[root@client ~]# docker pull 192.168.28.20/myproject-mxx/cirros:v1
v1: Pulling from myproject-mxx/cirros
Digest: sha256:96137d51e0e46006243fa2403723eb47f67818802d1175b5cde7eaa7f19446bd
Status: Downloaded newer image for 192.168.28.20/myproject-mxx/cirros:v1
192.168.28.20/myproject-mxx/cirros:v1

//查看镜像
[root@client ~]# docker images
REPOSITORY               TAG         IMAGE ID       CREATED       SIZE
192.168.28.20/myproject-mxx/cirros  v1          bc94bceaae77     11 months ago    10.3MB
cirros                 latest        bc94bceaae77     11 months ago    10.3MB
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13

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

//在Harbor服务器上操作

[root@client ~]# docker-compose down -v
Stopping nginx        ... done
Stopping harbor-jobservice  ... done
Stopping harbor-ui      ... done
Stopping registry      ... done
Stopping harbor-db      ... done
Stopping harbor-adminserver ... done
Stopping harbor-log     ... done
Removing nginx        ... done
Removing harbor-jobservice  ... done
Removing harbor-ui      ... done
Removing registry      ... done
Removing harbor-db      ... done
Removing harbor-adminserver ... done
Removing harbor-log     ... done
Removing network harbor_harbor
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18

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

持久数据，如镜像，数据库等在宿主机的/data/目录下,日志在宿主机的 /var/log/Harbor/目录下。

cd /var/log/Harbor/
rm -rf /data/database/
rm -rf /data/registry/
  • 1
  • 2
  • 3
  • 4
  • 5

相关文章