Harbor 簡介
Harbor是VMware公司開源的企業(yè)級Docker Registry項目,其目標是幫助用戶迅速搭建一個企業(yè)級的Docker registry服務。
它以Docker公司開源的registry為基礎,提供了管理UI,基于角色的訪問控制(Role Based AccessControl),AD/LDAP集成、以及審計日志(Auditlogging) 等企業(yè)用戶需求的功能,通過添加一些企業(yè)必需的功能特性,例如安全、標識和管理等,擴展了開源 Docker Distribution。
作為一個企業(yè)級私有 Registry 服務器,Harbor 提供了更好的性能和安全。提升用戶使用 Registry 構建和運行環(huán)境傳輸鏡像的效率。
Harbor 支持安裝在多個 Registry 節(jié)點的鏡像資源復制,鏡像全部保存在私有 Registry 中,確保數據和知識產權在公司內部網絡中管控。另外,Harbor 也提供了高級的安全特性,諸如用戶管理,訪問控制和活動審計等。
Harbor 是由 VMware 中國研發(fā)團隊負責開發(fā)的開源企業(yè)級 Docker Registry,不僅解決了我們直接使用 Docker Registry的功能缺失,更解決了我們在生產使用 Docker Registry 面臨的高可用、鏡像倉庫直接復制、鏡像倉庫性能等運維痛點。
環(huá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 作為私有倉庫地址
本文出現的所有:hub.ymq.io 域名。使用時候請?zhí)鎿Q成自己的域名
Docker 環(huán)境
在部署私有倉庫之前,需要在主機上安裝Docker。私有倉庫是 registry images,并在Docker中運行。
我是用的vultr 的服務器,所以,下面操作,就不用配置國內的,加速鏡像庫,直接用Docker官方的!
國內加速倉庫,我其他文章有提到:Ubuntu 17.04 x64 安裝 Docker CE 初窺 Dockerfile 部署 Nginx
http://www.ymq.io/2017/12/30/Docker-Install/
安裝Docker CE
使用存儲庫進行安裝
1.更新apt軟件包索引:
$ sudo apt-get update
2.裝軟件包以允許apt通過HTTPS使用存儲庫:
$ 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.使用以下命令來設置穩(wěn)定的存儲庫
$ 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.通過運行hello-world 映像驗證是否正確安裝了Docker CE 。
$ sudo docker run hello-world
Docker Compose
安裝 Compose
在Linux上,您可以從GitHub上的Compose存儲庫版本頁面下載Docker Compose二進制文件。按照鏈接中的說明進行操作,即curl在終端中運行命令以下載二進制文件。這些一步一步的說明也包括在下面。
GitHub上的Compose存儲庫版本頁面下載地址:https://github.com/docker/compose/releases
1.運行此命令下載最新版本的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.對二進制文件應用可執(zhí)行權限:
sudo chmod +x /usr/local/bin/docker-compose
測試安裝
$ docker-compose --version
docker-compose version 1.18.0, build 8dd22a9
Python 環(huán)境
安裝 Python
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 實現了 acme 協(xié)議, 可以從 letsencrypt 生成免費的證書. https://github.com/Neilpang/acme.sh
很簡單就兩個步驟:
- 安裝
acme.sh - 生成證書,及驗證證書
安裝 acme.sh
安裝很簡單, 一個命令:
$ curl https://get.acme.sh | sh
這條命令,會做的事情
1.把 acme.sh 安裝到你的 home 目錄下: 并創(chuàng)建 一個 bash 的 alias, 方便你的使用: acme.sh=~/.acme.sh/acme.sh
2.自動為你創(chuàng)建 cronjob, 每天 0:00 點自動檢測所有的證書, 如果快過期了, 需要更新, 則會自動更新證書.
生成證書
如果你還沒有運行任何 web 服務, 且80 端口是空閑的, 那么 acme.sh 能假裝自己是一個webserver, 臨時聽在80 端口, 完成驗證:
注意:如果您使用的時候,請把,hub.ymq.io 替換成自己域名,此域名需要dns 解析到安裝私有倉庫的服務器IP
$ cd ~/.acme.sh/
$ apt-get install socat
$ sh acme.sh --issue -d hub.ymq.io --standalone
如果看到如下信息,說明證書驗證并生成成功,證書生成位置在:/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
Harbor 倉庫
前提條件:域名的dns 解析到安裝私有倉庫的服務器IP上
復制證書
1.創(chuàng)建一個certs目錄。
$ cd /opt/
$ mkdir -p certs
2.移動證書到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
Harbor 下載
下載Harbour版本的二進制文件 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
Harbor 配置
$ cd harbor
$ vim harbor.cfg
只需修改如下內容
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
參數解釋
hostname = 主機名:目標主機的主機名,用于訪問UI和注冊表服務。它應該是目標機器的IP地址或完全限定的域名(FQDN),例如198.13.48.154或 `hub.ymq.io`。不要使用localhost或127.0.0.1為主機名 - 注冊表服務需要由外部客戶端訪問!
ui_url_protocol = (http或https,默認為http)用于訪問UI和令牌/通知服務的協(xié)議。如果公證處于啟用狀態(tài),則此參數必須為https。默認情況下,這是http。
customize_crt = (打開或關閉,默認打開)打開此屬性時,準備腳本創(chuàng)建私鑰和根證書,用于生成/驗證注冊表令牌。當由外部來源提供密鑰和根證書時,將此屬性設置為off
ssl_cert =SSL證書的路徑,僅當協(xié)議設置為https時才應用
ssl_cert_key = SSL密鑰的路徑,僅當協(xié)議設置為https時才應用
默認安裝
$ sudo ./install.sh
Harbor 登錄
如果一切正常,你應該可以打開瀏覽器訪問http://hub.ymq.io的管理門戶(將hub.ymq.io更改為在你的配置中的主機名harbor.cfg)。請注意,默認的管理員用戶名/密碼是admin / Harbor12345。
登錄管理員門戶并創(chuàng)建一個新項目,例如myproject。然后,您可以使用docker命令來登錄和推送圖像(默認情況下,注冊表服務器在端口80上偵聽):



測試服務
登錄倉庫
Username:admin
Password:Harbor12345
$ docker login hub.ymq.io
Username (testuser): admin
Password: 輸入倉庫密碼
Login Succeeded
拉取鏡像
從 Docker Hub拉取 ubuntu:16.04 鏡像
$ docker pull ubuntu:16.04
標記鏡像
將鏡像標記為 hub.ymq.io/myproject,在推送時,Docker會將其解釋為倉庫的位置。
$ docker tag ubuntu:16.04 hub.ymq.io/myproject/my-ubuntu
推送鏡像
將鏡像推送到本地鏡像標記的倉庫hub.ymq.io/myproject/
$ docker push hub.ymq.io/myproject/my-ubuntu

在鏡像列表:可以刪除,復制,查看日志,及其他操作
刪除鏡像
刪除本地緩存ubuntu:16.04和hub.ymq.io/myproject/my-ubuntu 鏡像,以便您可以測試從私有倉庫中拉取鏡像。這不會hub.ymq.io/myproject/my-ubuntu 從您的私有倉庫中刪除鏡像。
$ docker image remove ubuntu:16.04
$ docker image remove hub.ymq.io/myproject/my-ubuntu
拉取鏡像
拉取 hub.ymq.io 倉庫的 /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 Compose 是 Docker 官方編排(Orchestration)項目之一,負責快速在集群中部署分布式應用。
一個使用Docker容器的應用,通常由多個容器組成。使用Docker Compose,不再需要使用shell腳本來啟動容器。在配置文件中,所有的容器通過services來定義,然后使用docker-compose腳本來啟動,停止和重啟應用,和應用中的服務以及所有依賴服務的容器
Contact
- 作者:鵬磊
- 出處:http://www.ymq.io
- Email:admin@souyunku.com
- 版權歸作者所有,轉載請注明出處