摘要：私有倉(cāng)庫(kù)是，并在中運(yùn)行。不要使用或?yàn)橹鳈C(jī)名注冊(cè)表服務(wù)需要由外部客戶端訪問(wèn)或，默認(rèn)為用于訪問(wèn)和令牌通知服務(wù)的協(xié)議。打開(kāi)或關(guān)閉，默認(rèn)打開(kāi)打開(kāi)此屬性時(shí)，準(zhǔn)備腳本創(chuàng)建私鑰和根證書(shū)，用于生成驗(yàn)證注冊(cè)表令牌。

上一篇文章搭建了一個(gè)具有基礎(chǔ)功能，權(quán)限認(rèn)證、TLS 的私有倉(cāng)庫(kù)，但是Docker Registry 作為鏡像倉(cāng)庫(kù)，連管理界面都沒(méi)有，甚至連一些運(yùn)維必備的功能都是缺失的，還有什么 Docker 鏡像倉(cāng)庫(kù)管理工具呢？
這里有一個(gè)簡(jiǎn)單好用的企業(yè)級(jí) Registry 服務(wù)器 - Harbor，推薦在生產(chǎn)環(huán)境上使用。

Harbor是VMware公司開(kāi)源的企業(yè)級(jí)Docker Registry項(xiàng)目，其目標(biāo)是幫助用戶迅速搭建一個(gè)企業(yè)級(jí)的Docker registry服務(wù)。

它以Docker公司開(kāi)源的registry為基礎(chǔ)，提供了管理UI，基于角色的訪問(wèn)控制(Role Based AccessControl)，AD/LDAP集成、以及審計(jì)日志(Auditlogging) 等企業(yè)用戶需求的功能，通過(guò)添加一些企業(yè)必需的功能特性，例如安全、標(biāo)識(shí)和管理等，擴(kuò)展了開(kāi)源 Docker Distribution。

作為一個(gè)企業(yè)級(jí)私有 Registry 服務(wù)器，Harbor 提供了更好的性能和安全。提升用戶使用 Registry 構(gòu)建和運(yùn)行環(huán)境傳輸鏡像的效率。

Harbor 支持安裝在多個(gè) Registry 節(jié)點(diǎn)的鏡像資源復(fù)制，鏡像全部保存在私有 Registry 中，確保數(shù)據(jù)和知識(shí)產(chǎn)權(quán)在公司內(nèi)部網(wǎng)絡(luò)中管控。另外，Harbor 也提供了高級(jí)的安全特性，諸如用戶管理，訪問(wèn)控制和活動(dòng)審計(jì)等。

Harbor 是由 VMware 中國(guó)研發(fā)團(tuán)隊(duì)負(fù)責(zé)開(kāi)發(fā)的開(kāi)源企業(yè)級(jí) Docker Registry，不僅解決了我們直接使用 Docker Registry 的功能缺失，更解決了我們?cè)谏a(chǎn)使用 Docker Registry 面臨的高可用、鏡像倉(cāng)庫(kù)直接復(fù)制、鏡像倉(cāng)庫(kù)性能等運(yùn)維痛點(diǎn)。

系統(tǒng)：Ubuntu 17.04 x64

Docker 17.12.0-ce ,Docker Compose

python3

IP:198.13.48.154

域名：hub.ymq.io，此域名需要dns 解析到198.13.48.154 作為私有倉(cāng)庫(kù)地址

本文出現(xiàn)的所有：hub.ymq.io 域名。使用時(shí)候請(qǐng)?zhí)鎿Q成自己的域名

在部署私有倉(cāng)庫(kù)之前，需要在主機(jī)上安裝Docker。私有倉(cāng)庫(kù)是 registry images，并在Docker中運(yùn)行。

我是用的vultr 的服務(wù)器，所以，下面操作，就不用配置國(guó)內(nèi)的，加速鏡像庫(kù)，直接用Docker官方的！

國(guó)內(nèi)加速倉(cāng)庫(kù)，我其他文章有提到:Ubuntu 17.04 x64 安裝 Docker CE 初窺 Dockerfile 部署 Nginx
http://www.ymq.io/2017/12/30/Docker-Install/

使用存儲(chǔ)庫(kù)進(jìn)行安裝

1.更新apt軟件包索引：

$ sudo apt-get update

2.裝軟件包以允許apt通過(guò)HTTPS使用存儲(chǔ)庫(kù)：

$ sudo apt-get install 
    apt-transport-https 
    ca-certificates 
    curl 
    software-properties-common

3.添加Docker的官方GPG密鑰：

$ curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -

4.使用以下命令來(lái)設(shè)置穩(wěn)定的存儲(chǔ)庫(kù)

$ sudo add-apt-repository 
   "deb [arch=amd64] https://download.docker.com/linux/ubuntu 
   $(lsb_release -cs) 
   stable"

5.更新apt軟件包索引。

$ sudo apt-get update

7.安裝最新版本的Docker CE

$ sudo apt-get install docker-ce

8.通過(guò)運(yùn)行hello-world 映像驗(yàn)證是否正確安裝了Docker CE 。

$ sudo docker run hello-world

在Linux上，您可以從GitHub上的Compose存儲(chǔ)庫(kù)版本頁(yè)面下載Docker Compose二進(jìn)制文件。按照鏈接中的說(shuō)明進(jìn)行操作，即curl在終端中運(yùn)行命令以下載二進(jìn)制文件。這些一步一步的說(shuō)明也包括在下面。

GitHub上的Compose存儲(chǔ)庫(kù)版本頁(yè)面下載地址：https://github.com/docker/compose/releases

1.運(yùn)行此命令下載最新版本的Docker Compose：

sudo curl -L https://github.com/docker/compose/releases/download/1.18.0/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-compose

2.對(duì)二進(jìn)制文件應(yīng)用可執(zhí)行權(quán)限：

sudo chmod +x /usr/local/bin/docker-compose

$ docker-compose --version
docker-compose version 1.18.0, build 8dd22a9

apt-get install python3
apt-get install python-minimal
apt-get install python3-setuptools
easy_install3 pip
apt-get install python-argparse

$ python --version
Python 2.7.13

$ pip -V
pip 9.0.1 from /usr/local/lib/python3.5/dist-packages/pip-9.0.1-py3.5.egg (python 3.5)

acme.sh 實(shí)現(xiàn)了 acme 協(xié)議, 可以從 letsencrypt 生成免費(fèi)的證書(shū). https://github.com/Neilpang/acme.sh

給acme.sh組織贊助：Acknowledgments

很簡(jiǎn)單就兩個(gè)步驟:

安裝 acme.sh

生成證書(shū)，及驗(yàn)證證書(shū)

安裝很簡(jiǎn)單, 一個(gè)命令:

$ curl  https://get.acme.sh | sh

這條命令，會(huì)做的事情

1.把 acme.sh 安裝到你的 home 目錄下：
并創(chuàng)建 一個(gè) bash 的 alias, 方便你的使用: acme.sh=~/.acme.sh/acme.sh

2.自動(dòng)為你創(chuàng)建 cronjob, 每天 0:00 點(diǎn)自動(dòng)檢測(cè)所有的證書(shū), 如果快過(guò)期了, 需要更新, 則會(huì)自動(dòng)更新證書(shū).

如果你還沒(méi)有運(yùn)行任何 web 服務(wù), 且80 端口是空閑的, 那么 acme.sh 能假裝自己是一個(gè)webserver, 臨時(shí)聽(tīng)在80 端口, 完成驗(yàn)證:

注意：如果您使用的時(shí)候，請(qǐng)把，hub.ymq.io 替換成自己域名，此域名需要dns 解析到安裝私有倉(cāng)庫(kù)的服務(wù)器IP

$ cd ~/.acme.sh/
$ apt-get install socat
$ sh acme.sh  --issue -d hub.ymq.io   --standalone

如果看到如下信息，說(shuō)明證書(shū)驗(yàn)證并生成成功,證書(shū)生成位置在：/root/.acme.sh/hub.ymq.io/ 下

Success
Verify finished, start to sign.
Cert success.
-----BEGIN CERTIFICATE-----

[Wed Jan  3 14:36:25 UTC 2018] Standalone mode.
[Wed Jan  3 14:36:25 UTC 2018] Registering account
[Wed Jan  3 14:36:27 UTC 2018] Registered
[Wed Jan  3 14:36:27 UTC 2018] ACCOUNT_THUMBPRINT="7TpUIE5N--hq2nhk2ruKmHBfgKB-LX-pBCkWzzmHzVM"
[Wed Jan  3 14:36:27 UTC 2018] Creating domain key
[Wed Jan  3 14:36:28 UTC 2018] The domain key is here: /root/.acme.sh/hub.ymq.io/hub.ymq.io.key
[Wed Jan  3 14:36:28 UTC 2018] Single domain="hub.ymq.io"
[Wed Jan  3 14:36:28 UTC 2018] Getting domain auth token for each domain
[Wed Jan  3 14:36:28 UTC 2018] Getting webroot for domain="hub.ymq.io"
[Wed Jan  3 14:36:28 UTC 2018] Getting new-authz for domain="hub.ymq.io"
[Wed Jan  3 14:36:29 UTC 2018] The new-authz request is ok.
[Wed Jan  3 14:36:29 UTC 2018] Verifying:hub.ymq.io
[Wed Jan  3 14:36:29 UTC 2018] Standalone mode server
[Wed Jan  3 14:36:34 UTC 2018] Success
[Wed Jan  3 14:36:34 UTC 2018] Verify finished, start to sign.
[Wed Jan  3 14:36:35 UTC 2018] Cert success.
-----BEGIN CERTIFICATE-----
MIIE9zCCA9+gAwIBAgISA6WV4ZFi6lr/kngVGx7/FoPMMA0GCSqGSIb3DQEBCwUA
******************************************
...

-----END CERTIFICATE-----
[Wed Jan  3 14:36:35 UTC 2018] Your cert is in  /root/.acme.sh/hub.ymq.io/hub.ymq.io.cer 
[Wed Jan  3 14:36:35 UTC 2018] Your cert key is in  /root/.acme.sh/hub.ymq.io/hub.ymq.io.key 
[Wed Jan  3 14:36:35 UTC 2018] The intermediate CA cert is in  /root/.acme.sh/hub.ymq.io/ca.cer 
[Wed Jan  3 14:36:35 UTC 2018] And the full chain certs is there:  /root/.acme.sh/hub.ymq.io/fullchain.cer 

前提條件：域名的dns 解析到安裝私有倉(cāng)庫(kù)的服務(wù)器IP上

1.創(chuàng)建一個(gè)certs目錄。

$ cd /opt/
$ mkdir -p certs

2.移動(dòng)證書(shū)到certs目錄。

$ cd ~/.acme.sh/
$ sh acme.sh  --installcert  -d  hub.ymq.io   
        --key-file   /opt/certs/hub.ymq.io.key 
        --fullchain-file /opt/certs/fullchain.cer

下載Harbour版本的二進(jìn)制文件 https://github.com/vmware/harbor/releases

目前最新版本 V1.3.0

$ wget https://storage.googleapis.com/harbor-releases/harbor-online-installer-v1.3.0.tgz
$ tar -zxvf harbor-offline-installer-v1.3.0-rc4.tgz 

$ cd harbor
$ vim harbor.cfg

只需修改如下內(nèi)容

hostname = hub.ymq.io
ui_url_protocol = https
customize_crt = off
ssl_cert = /opt/certs/fullchain.cer
ssl_cert_key = /opt/certs/hub.ymq.io.key

參數(shù)解釋

hostname = 主機(jī)名：目標(biāo)主機(jī)的主機(jī)名，用于訪問(wèn)UI和注冊(cè)表服務(wù)。它應(yīng)該是目標(biāo)機(jī)器的IP地址或完全限定的域名（FQDN），例如198.13.48.154或 `hub.ymq.io`。不要使用localhost或127.0.0.1為主機(jī)名 - 注冊(cè)表服務(wù)需要由外部客戶端訪問(wèn)！
ui_url_protocol = （http或https，默認(rèn)為http）用于訪問(wèn)UI和令牌/通知服務(wù)的協(xié)議。如果公證處于啟用狀態(tài)，則此參數(shù)必須為https。默認(rèn)情況下，這是http。
customize_crt = （打開(kāi)或關(guān)閉，默認(rèn)打開(kāi)）打開(kāi)此屬性時(shí)，準(zhǔn)備腳本創(chuàng)建私鑰和根證書(shū)，用于生成/驗(yàn)證注冊(cè)表令牌。當(dāng)由外部來(lái)源提供密鑰和根證書(shū)時(shí)，將此屬性設(shè)置為off
ssl_cert =SSL證書(shū)的路徑，僅當(dāng)協(xié)議設(shè)置為https時(shí)才應(yīng)用
ssl_cert_key = SSL密鑰的路徑，僅當(dāng)協(xié)議設(shè)置為https時(shí)才應(yīng)用

$ sudo ./install.sh

如果一切正常，你應(yīng)該可以打開(kāi)瀏覽器訪問(wèn)http://hub.ymq.io的管理門(mén)戶（將hub.ymq.io更改為在你的配置中的主機(jī)名harbor.cfg）。請(qǐng)注意，默認(rèn)的管理員用戶名/密碼是admin / Harbor12345。

登錄管理員門(mén)戶并創(chuàng)建一個(gè)新項(xiàng)目，例如myproject。然后，您可以使用docker命令來(lái)登錄和推送圖像（默認(rèn)情況下，注冊(cè)表服務(wù)器在端口80上偵聽(tīng)）：

Username:admin
Password:Harbor12345

$ docker login hub.ymq.io
Username (testuser): admin
Password: 輸入倉(cāng)庫(kù)密碼
Login Succeeded

從 Docker Hub拉取 ubuntu:16.04 鏡像

$ docker pull ubuntu:16.04

將鏡像標(biāo)記為 hub.ymq.io/myproject，在推送時(shí)，Docker會(huì)將其解釋為倉(cāng)庫(kù)的位置。

$ docker tag  ubuntu:16.04 hub.ymq.io/myproject/my-ubuntu

將鏡像推送到本地鏡像標(biāo)記的倉(cāng)庫(kù)hub.ymq.io/myproject/

$ docker push hub.ymq.io/myproject/my-ubuntu

在鏡像列表：可以刪除，復(fù)制，查看日志，及其他操作

刪除本地緩存ubuntu:16.04和hub.ymq.io/myproject/my-ubuntu 鏡像，以便您可以測(cè)試從私有倉(cāng)庫(kù)中拉取鏡像。這不會(huì)hub.ymq.io/myproject/my-ubuntu 從您的私有倉(cāng)庫(kù)中刪除鏡像。

$ docker image remove ubuntu:16.04
$ docker image remove hub.ymq.io/myproject/my-ubuntu

拉取 hub.ymq.io 倉(cāng)庫(kù)的 /myproject/my-ubuntu 鏡像。

root@souyunku:~# docker pull hub.ymq.io/myproject/my-ubuntu
Using default tag: latest
latest: Pulling from myproject/my-ubuntu
50aff78429b1: Pull complete 
f6d82e297bce: Pull complete 
275abb2c8a6f: Pull complete 
9f15a39356d6: Pull complete 
fc0342a94c89: Pull complete 
Digest: sha256:f871d0805ee3ce1c52b0608108dbdf1b447a34d22d5c7278a3a9dd78fc12c663
Status: Downloaded newer image for hub.ymq.io/myproject/my-ubuntu:latest

root@souyunku:~# docker images hub.ymq.io/myproject/my-ubuntu
REPOSITORY                       TAG                 IMAGE ID            CREATED             SIZE
hub.ymq.io/myproject/my-ubuntu   latest              00fd29ccc6f1        3 weeks ago         111MB

官方文檔:
https://github.com/vmware/harbor/blob/master/docs/installation_guide.md

Docker Compose 是 Docker 官方編排（Orchestration）項(xiàng)目之一，負(fù)責(zé)快速在集群中部署分布式應(yīng)用。

一個(gè)使用Docker容器的應(yīng)用，通常由多個(gè)容器組成。使用Docker Compose，不再需要使用shell腳本來(lái)啟動(dòng)容器。在配置文件中，所有的容器通過(guò)services來(lái)定義，然后使用docker-compose腳本來(lái)啟動(dòng)，停止和重啟應(yīng)用，和應(yīng)用中的服務(wù)以及所有依賴服務(wù)的容器

Docker Compose 的搭建，及使用，發(fā)布 spring boot整合redis做訪問(wèn)計(jì)數(shù)demo，實(shí)戰(zhàn) WordPress，正在整理中，會(huì)在下篇文章體現(xiàn)，關(guān)注公眾號(hào)：“搜云庫(kù)” 我會(huì)在微信公眾號(hào)首發(fā)

作者：鵬磊

出處：http://www.ymq.io/2018/01/06/Docker-harbor-registry/

版權(quán)歸作者所有，轉(zhuǎn)載請(qǐng)注明出處

Wechat：關(guān)注公眾號(hào)，"搜云庫(kù)"，專注于開(kāi)發(fā)技術(shù)的研究與知識(shí)分享