手把手教你搭建docker-hub

目录

• 前言
  • 为什么要搭建docker-hub
• 1. 什么是harbor
• 2. harbor特征
• 3. harbor的安装
  • 3.1 目标环境的要求
    • 3.1.1 硬件
    • 3.1.2 软件
    • 3.1.3 网络端口
  • 3.2 安装步骤
    • 3.2.1 下载安装文件
    • 3.2.2 配置harbor.yml
    • 3.2.3 执行安装并启动
    • 3.2.4 管理Harbor的生命周期
• 4. harbor的使用
  • 4.1 创建项目
  • 4.2 拉取/推送镜像

前言

为什么要搭建docker-hub

第一，由于众所周知的原因，我们从docker下载镜像的时候，速度慢，而我们自己搭建docker-hub速度则很快。
第二，官方的镜像有的时候无法满足我们的业务需求，我们需要进行定制开发，在完成之后，上传到公司内部的docker-hub中，方便其他人进行下载。

基于以上的原因，我们就需要搭建自己的docker-hub了。

经过上面的需求分析，我们选择了harbor来搭建我们的docker-hub。

harbor

1. 什么是harbor

Harbor正是一个用于存储Docker镜像的企业级Registry服务。是一个开源的可信云本机注册表项目，用于存储，签名和扫描内容。

2. harbor特征

• 云本机注册表：Harbour 支持容器映像和Helm图表，可作为容器运行时和业务流程平台等云本机环境的注册表。
• 基于角色的访问控制：用户和存储库通过“项目”进行组织，用户可以对项目下的图像或Helm图表拥有不同的权限。
• 基于策略的复制：可以基于具有多个过滤器（存储库，标记和标签）的策略在多个注册表实例之间复制（同步）图像和图表。如果遇到任何错误，Harbor会自动重试复制。非常适合负载平衡，高可用性，多数据中心，混合和多云场景。
• 漏洞扫描：Harbor定期扫描图像并警告用户漏洞。
• LDAP / AD支持：Harbor与现有企业LDAP / AD集成以进行用户身份验证和管理，并支持将LDAP组导入Harbor并为其分配适当的项目角色。
• OIDC支持：Harbour利用OpenID Connect（OIDC）来验证由外部授权服务器或身份提供商进行身份验证的用户的身份。可以启用单点登录以登录Harbor门户。
• 图像删除和垃圾收集：可以删除图像，并可以回收它们的空间。
• 公证人：可以确保图像的真实性。
• 图形用户门户：用户可以轻松浏览，搜索存储库和管理项目。
• 审计：跟踪存储库的所有操作。
• RESTful API：适用于大多数管理操作的RESTful API，易于与外部系统集成。嵌入式Swagger UI可用于探索和测试API。
• 轻松部署：提供在线和离线安装程序。此外，Helm Chart可用于在Kubernetes上部署Harbor。

3. harbor的安装

安装分为在线安装和离线安装，我们这里选择在线安装。

3.1 目标环境的要求

需要安装docker和docker-compose,且有如下要求：docker 17.06.0-ce+ and docker-compose 1.18.0+

3.1.1 硬件

3.1.2 软件

3.1.3 网络端口

3.2 安装步骤

3.2.1 下载安装文件

我们可以从这里看所有的版本。

在线安装
$ tar xvf harbor-online-installer-<version>.tgz

离线安装：
$ tar xvf harbor-offline-installer-<version>.tgz

3.2.2 配置harbor.yml

必须设置的参数：

• hostname：目标机器的ip地址，可以是域名和公网ip，不能设置为127.0.0.1和localhost。
• data_volume：harbor数据的存放地址。
• harbor_admin_password：管理员密码，默认admin/Harbor12345 ，且只会生效一次。
• database：数据库相关配置，默认密码root123
• jobservice
• log:日志相关
  • level： 日志的级别，debug, info, warning, error, fatal；
  • rotate_count：最多保存几个日志文件
  • rotate_size：每个日志文件的大小
  • location：日志存放目录

可选的参数。

• http:http服务的端口号
• https：
  • port：端口号
  • certificate：ssl证书
  • private_key：ssl-key的路径
• external_url：external proxy启用的时候，external_url可用，但是hostname不再可用。

贴出我的配置文件：

# Configuration file of Harbor

# The IP address or hostname to access admin UI and registry service.
# DO NOT use localhost or 127.0.0.1, because Harbor needs to be accessed by external clients.
hostname: *.*.*.*

# http related config
http:
  # port for http, default is 80. If https enabled, this port will redirect to https port
  port: 80

# https related config
# https:
#   # https port for harbor, default is 443
#   port: 443
#   # The path of cert and key files for nginx
#   certificate: /your/certificate/path
#   private_key: /your/private/key/path

# Uncomment external_url if you want to enable external proxy
# And when it enabled the hostname will no longer used
# external_url: https://reg.mydomain.com:8433

# The initial password of Harbor admin
# It only works in first time to install harbor
# Remember Change the admin password from UI after launching Harbor.
harbor_admin_password: Harbor12345

# Harbor DB configuration
database:
  # The password for the root user of Harbor DB. Change this before any production use.
  password: root123

# The default data volume
data_volume: /opt/docker-hub/data

# Harbor Storage settings by default is using /data dir on local filesystem
# Uncomment storage_service setting If you want to using external storage
# storage_service:
#   # ca_bundle is the path to the custom root ca certificate, which will be injected into the truststore
#   # of registry's and chart repository's containers.  This is usually needed when the user hosts a internal storage with self signed certificate.
#   ca_bundle:

#   # storage backend, default is filesystem, options include filesystem, azure, gcs, s3, swift and oss
#   # for more info about this configuration please refer https://docs.docker.com/registry/configuration/
#   filesystem:
#     maxthreads: 100
#   # set disable to true when you want to disable registry redirect
#   redirect:
#     disabled: false

# Clair configuration
clair: 
  # The interval of clair updaters, the unit is hour, set to 0 to disable the updaters.
  updaters_interval: 12

  # Config http proxy for Clair, e.g. http://my.proxy.com:3128
  # Clair doesn't need to connect to harbor internal components via http proxy.
  http_proxy:
  https_proxy:
  no_proxy: 127.0.0.1,localhost,core,registry

jobservice:
  # Maximum number of job workers in job service  
  max_job_workers: 10

chart:
  # Change the value of absolute_url to enabled can enable absolute url in chart
  absolute_url: disabled

# Log configurations
log:
  # options are debug, info, warning, error, fatal
  level: info
  # Log files are rotated log_rotate_count times before being removed. If count is 0, old versions are removed rather than rotated.
  rotate_count: 50
  # Log files are rotated only if they grow bigger than log_rotate_size bytes. If size is followed by k, the size is assumed to be in kilobytes. 
  # If the M is used, the size is in megabytes, and if G is used, the size is in gigabytes. So size 100, size 100k, size 100M and size 100G 
  # are all valid.
  rotate_size: 200M
  # The directory on your host that store log
  location: /var/log/harbor

#This attribute is for migrator to detect the version of the .cfg file, DO NOT MODIFY!
_version: 1.8.0

# Uncomment external_database if using external database.
# external_database:
#   harbor:
#     host: harbor_db_host
#     port: harbor_db_port
#     db_name: harbor_db_name
#     username: harbor_db_username
#     password: harbor_db_password
#     ssl_mode: disable
#   clair:
#     host: clair_db_host
#     port: clair_db_port
#     db_name: clair_db_name
#     username: clair_db_username
#     password: clair_db_password
#     ssl_mode: disable
#   notary_signer:
#     host: notary_signer_db_host
#     port: notary_signer_db_port
#     db_name: notary_signer_db_name
#     username: notary_signer_db_username
#     password: notary_signer_db_password
#     ssl_mode: disable
#   notary_server:
#     host: notary_server_db_host
#     port: notary_server_db_port
#     db_name: notary_server_db_name
#     username: notary_server_db_username
#     password: notary_server_db_password
#     ssl_mode: disable

# Uncomment external_redis if using external Redis server
# external_redis:
#   host: redis
#   port: 6379
#   password:
#   # db_index 0 is for core, it's unchangeable
#   registry_db_index: 1
#   jobservice_db_index: 2
#   chartmuseum_db_index: 3

# Uncomment uaa for trusting the certificate of uaa instance that is hosted via self-signed cert.
# uaa:
#   ca_file: /path/to/ca

3.2.3 执行安装并启动

bash install.sh

我们分析下install.sh。

文档链接：https://mubu.com/doc/OOec-ZgGu 密码：eu3u

如果执行成功，会出现如下提示：

我们可以在浏览器输入提下内容，将看到启动界面如下：

输入用户名和密码后，我们可以看到我们的docker-hub仓库。

3.2.4 管理Harbor的生命周期

docker-compose stop
docker-compose start

4. harbor的使用

这部分是十分庞大的，我就简单的介绍下常用的，完整的文档见这里。

4.1 创建项目

项目可以分为公有的和私有的。

具体的操作不再赘述，去操作一遍就都会了。

4.2 拉取/推送镜像

首先我们需要进行登录，docker login ip

但是我们可能遇到下面的错误。

这样的原因是因为Harbor默认使用http，docker默认使用https的原因。

我们可以强制docker使用http，要在daemon.json中添加--insecure-registry myregistrydomain.com，即

{
  "log-driver":"json-file",
  "log-opts": {"max-size":"100m", "max-file":"1"},
  "insecure-registries" : ["myregistrydomain.com"]
}

然后我们还可能遇到下面的错误：

在github上的官方找到了下面的解决方案：原因是因为ubuntu上安装docker-compose的时候，不需要golang-docker-credential-helpers这个组件，我们把它删除即可，所以apt-get remove golang-docker-credential-helpers

这是第一种方案，第二中方案是让Harbor使用https,即申请一个CA证书，然后把CA证书放在/etc/docker/certs.d/myregistrydomain.com/ca.crt中。

下面我们进行推送镜像。

docker tag monitor-baseos:0.2 ip/kledger/monitor-baseos:0.2
docker push ip/kledger/monitor-baseos:0.2

记得替换ip。

然后我们在浏览器中就可以看到了。

拉取镜像就更加简单了。

docker pull ip/kledger/monitor-baseos:0.2

同样的记得修改ip地址。