Harbor构建docker私有仓库

一、Harbor简介

Harbor 是VMware公司开源的云本地 registry 仓库，有可视化的Web管理界面，可以方便的管理和储存 Docker 镜像。Harbor 支持在多个仓库直接进行复制镜像，提供用户管理和访问控制和活动审计。
Harbor是构建企业级私有docker镜像的仓库的开源解决方案，它是Docker Registry的更高级封装， 它除了提供友好的Web UI界面，角色和用户权限管理，用户操作审计等功能外，它还整合了K8s的插件 (Add-ons)仓库，即Helm通过chart方式下载，管理，安装K8s插件，而chartmuseum可以提供存储chart数据的仓库【注:helm就相当于k8s的yum】。

二、Harbor优势

• 基于角色控制
• 基于镜像的复制策略
• 支持LDAP/AD域，通过VPN连接域使用
• 图像删除和垃圾收集
• 图像UI，方便
• 审计，此功能使用较少，一般企业中用ELK收集、分析日志
• RESTful API

三、Harbor架构

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

过程：所有的请求都经过proxy代理，proxy代理转发给Core services和Registry，其中Core services包括UI界面、token令牌和webhook网页服务功能，Registry主要提供镜像存储功能。如果要进行下载上传镜像，要经过token令牌验证然后从Registry获取或上传镜像，每一次下载或上传都会生成日志记录，会记入Log collector，而用户身份权限及一些镜像语言信息会被存储在Database中。

四、Harbor 配置文件以及相关参数

Harbor的配置文件是：/usr/local/harbor/harbor.cfg
关于 Harbor.cfg 配置文件中有两类参数：所需参数和可选参数

（1）所需参数

修改此参数后，需要运行 install.sh脚本重新安装 Harbour，参数才会生效。

hostname
	用于访问用户界面和 register 服务。
	它应该是目标机器的 IP 地址或完全限定的域名（FQDN）
	例如 192.168.163.100 或test.com。
	不要使用 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 时才应用。
secretkey_path
	用于在复制策略中加密或解密远程 register 密码的密钥路径。
	不建议配置，有很大的安全隐患

（2）可选参数

这些参数对于更新是可选的，即用户可以将其保留为默认值，并在启动 Harbor 后在 Web UI 上进行更新。
如果进入 Harbor.cfg，只会在第一次启动 Harbor 时生效，随后对这些参数 的更新，Harbor.cfg 将被忽略。
注意：如果选择通过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 分钟。
	即登录–退出后，30分钟内可以不输入用户名和密码登录，30分钟后需要再次验证。
project_creation_restriction
	用于控制哪些用户有权创建项目的标志，表示哪些用户可以创建项目。
	默认情况下， 每个人都可以创建一个项目。
	如果将其值设置为“adminonly”，那么只有 admin 可以创建项目。
verify_remote_cert
	打开或关闭，默认打开。
	此标志决定了当Harbor与远程 register 实例通信时是否验证 SSL/TLS 证书。
	将此属性设置为 off 将绕过 SSL/TLS 验证，这在远程实例具有自签名或不可信证书时经常使用。

另外，默认情况下，Harbour 将镜像存储在本地文件系统上。在生产环境中，可以考虑 使用其他存储后端而不是本地文件系统，如 S3、Openstack Swif、Ceph 等。但需要更新common/templates/registry/config.yml 文件。