【docker系列】私人仓库harbor安装|学习

原创已于 2022-04-22 14:45:12 修改 · 1.3k 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#docker

于 2022-04-01 23:47:09 首次发布

docker系列专栏收录该内容

6 篇文章

订阅专栏

Harbor是一款由VMware开源的企业级Docker Registry，提供访问控制、镜像复制、图形化界面、AD/LDAP集成等功能。本文详细介绍了Harbor的安装步骤，包括下载离线安装包、配置harbor.yml、执行安装脚本，并展示了如何推送镜像到私人仓库。此外，还提及了Harbor的组件架构和关键特性。

概述

简介

加粗样式

虽然Docker官方提供了公共的镜像仓库，但是从安全和效率等方面考虑，部署我们私有环境内的Registry也是非常必要的。
Harbor是由VMware公司开源的企业级的Docker Registry管理项目，相比docker官方拥有更丰富的权限权利和完善的架构设计，适用大规模docker集群部署提供仓库服务。
它主要提供 Dcoker Registry 管理界面UI，可基于角色访问控制,镜像复制， AD/LDAP 集成，日志审核等功能，完全的支持中文。

主要功能

基于角色的访问控制

用户与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

架构组件

架构组件图：

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，供日后进行分析

安装方式

方式一：下载安装包

前提：

1、确保docker和docker-compose安装

安装流程

1、创建文件夹

[root@localhost opt]# mkdir harbor

2、下载harbor离线安装包

wget https://storage.googleapis.com/harbor-releases/release-1.9.0/harbor-offline-installer-v1.9.0.tgz

3、解压

tar xvf harbor-offline-installer-v1.9.0.tgz

4、编辑harbor配置文件

# 切换到harbor
cd harbor/

# 编辑harbor.yml配置
vim harbor.yml

修改hostname，这里是不支持使用localhost和127.0.0.1的

默认的密码是这样子的，因为是演示，所以暂时便不修改它

如果要修改数据的话，可以参考这里,因为目前没有域名和https证书，所以这一块我们便不理会它

# hostname设置访问地址，可以使用ip、域名，不可以设置为127.0.0.1或localhost
hostname = 192.168.126.162

# 访问协议，默认是http，也可以设置https，如果设置https，则nginx ssl需要设置on
ui_url_protocol = http

# mysql数据库root用户默认密码root123，实际使用时修改下
db_password = 123456

max_job_workers = 3 

customize_crt = on

ssl_cert = /data/cert/server.crt
ssl_cert_key = /data/cert/server.key

secretkey_path = /data

admiral_url = NA
# 邮件设置，发送重置密码邮件时使用
email_identity = 

email_server = smtp.mydomain.com
email_server_port = 25
email_username = sample_admin@mydomain.com
email_password = abc
email_from = admin <sample_admin@mydomain.com>
email_ssl = false

# 启动Harbor后，管理员UI登录的密码，默认是Harbor12345
harbor_admin_password = 123456

# 认证方式，这里支持多种认证方式，如LADP、本次存储、数据库认证。默认是db_auth，mysql数据库认证
auth_mode = db_auth

# LDAP认证时配置项
ldap_url = ldaps://ldap.mydomain.com
#ldap_searchdn = uid=searchuser,ou=people,dc=mydomain,dc=com
#ldap_search_pwd = password
ldap_basedn = ou=people,dc=mydomain,dc=com
#ldap_filter = (objectClass=person)
ldap_uid = uid
ldap_scope = 3
ldap_timeout = 5

# 是否开启自注册
self_registration = on

# token有效时间，默认30分钟
token_expiration = 30

# 用户创建项目权限控制，默认是everyone（所有人），也可以设置为adminonly（只能管理员）
project_creation_restriction = everyone

verify_remote_cert = on

5、执行./install.sh

执行之后的结果，可以发现harbor依赖于不少的镜像

6、访问刚刚设置的host，登录

访问刚刚设置域名和端口
我的url是这个
http://192.168.56.10/
之后便显示这个了

7、登录

账号：admin
密码为刚刚harbor.yml设置的

登录进来之后便可以看到页面了

推送镜像到私人仓库

前提

安装好harbor

流程

1、设置daemon.json

{
  "registry-mirrors": ["https://mos5bnjx.mirror.aliyuncs.com"],   //我这里的是阿里云的镜像
  "insecure-registries":["192.168.56.10"]  //这边需要
}

2、重启docker和docker-compose

restart docker && docker-compose start

3、登录harbor

账号密码为yml中设置的，如果没有修改的话

[root@localhost harbor]# docker login 192.168.56.10
Username: admin
Password: 
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

4、查看镜像

docker images

可以查看到很多安装harbor的时候自己安装的镜像

现在以goharbor/nginx-photon 为例子，为其打一个标签

5、打标签

[root@localhost harbor]# docker tag goharbor/nginx-photon:v1.9.0 192.168.56.10/nginx/nginx:v1

打完标签生成新镜像之后查看一下
docker images

6、推送

[root@localhost harbor]# docker push 192.168.56.10/nginx/nginx:v1

之后在harbor中的nginx项目，就有一个镜像了

其他指令

#删除harbors的镜像保留数据库和镜像数据
docker-compose down -v
 
#删除harbor的数据库和数据，相当于重装
rm -r /data/database
rm -r /data/registry

功能模块

用户

创建用户

设置管理员

参考文章

harbor1.9.0 仓库的搭建
 https://www.cnblogs.com/tianzhendengni/p/14071523.html