手把手教你搭建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地址。