一、harbor簡介

Harbor是VMware公司的開源級的企業級DockerRegistry(倉庫)專案，專案地址為 https://github.com/vmware/harbor.
Harbor的目標是幫助用戶迅速搭建一個企業級的DockerRegistry服務，
Harbor以docker公司開源的registry為基礎，提供了管理UI，基于角色的訪問控制（Role Based Access Control），AD/LDAP集成，以及審計日志（Auditlogging）等企業用戶需求的功能，同時還原生支持中文，
Harbor的每個組件都是以Docker容器的形式構建的，使用docker-compose來對它進行部署，用于部署Harbor的docker-compose模板位于/usr/local/bin/harbor/docker-compose.yml(自定義)
Docker harbor有可視化的web管理界面，可以方便管理Docker鏡像，又提供了多個專案的鏡像權限管理及控制功能

二、harbor的優勢

1、基于角色控制：用戶與Docker鏡像倉庫通過"專案"進行組織管理,一個用戶可以對多個鏡像倉庫在統一命名空間(projec)里有不同的權限
2、圖形化用戶界面：用戶可以通過瀏覽器來瀏覽,檢索當前Docker鏡像倉庫,管理專案和命名空間
3、審計管理：所有這怒地鏡像倉庫的錯都可以被記錄追溯，用于審計管理
4、基于鏡像的復制策略：鏡像可以在多個Harbor實體之間進行復制，
5、支持LDAP認證：Harbor的用戶授權可以使用已經存在的用戶，
6、鏡像洗掉和垃圾回收：image可以被洗掉并且回收image占用的空間，
7、簡單的部署功能：harbor提供了online、offline安裝，此外還提供了virtualappliance安裝
8、harbor和docker registry的關系：harbor實質上是對docker registry做了封裝，擴展了自己的業務模板，

三、harbor的簡易架構

harbor主要有6大模塊，默認的每個harbor的組件都被封裝成一個docker container，所以可以通過compose來部署harbor，總共分為8個容器運行，通過docker-compose ps來查看

●Proxy
  通過以一個前置的反向代理統一接收瀏覽器、Docker客戶端的請求，并將請求轉發給后端不同的服務
●Registry
  負載存盤Docker鏡像，并處理docker push/pull命令
●Core services
  Harbor的核心功能，包括UI、webhook、token服務
●Database
  為core services提供資料庫服務
●Log collector
  負責收集其他組件的log，供日后進行分析

四、部署harbor服務

1.確保docker-compose已能使用
[root@localhost ~]# mv docker-compose /usr/local/bin/
[root@localhost ~]# chmod +x /usr/local/bin/docker-compose
[root@localhost ~]# docker-compose -v
docker-compose version 1.21.1, build 5a3f1a3
2.將harbor-offline-installer-v1.2.2.tgz軟體包上傳到/root目錄下，解壓到/usr/local/目錄下
tar zxvf harbor-offline-installer-v1.2.2.tgz -C /usr/local/
3. 配置 Harbor 引數檔案
vim /usr/local/harbor/harbor.cfg
//5 hostname = 14.0.0.20
4.啟動 Harbor
[root@localhost ~]# cd /usr/local/harbor/
[root@localhost harbor]# ls
common                     docker-compose.yml     harbor.v1.2.2.tar.gz  NOTICE
docker-compose.clair.yml   harbor_1_1_0_template  install.sh            prepare
docker-compose.notary.yml  harbor.cfg             LICENSE               upgrade
[root@localhost harbor]# sh install.sh  
5. 查看 Harbor 啟動鏡像
//查看鏡像 docker images
//查看容器 docker ps -a
//查看compose編排的容器 docker-compose ps
6.打開瀏覽器訪問 http://14.0.0.20的管理頁面
默認的管理員用戶名和密碼是 admin/Harbor12345

7.添加專案并且填寫名稱 添加專案并且填寫名稱

新建專案myimages

此時可使用 Docker 命令在本地通過 127.0.0.1 來登錄和推送鏡像，默認情況下，
Register 服務器在埠 80 上偵聽，

//登錄 docker login -u admin -p Harbor12345 http://127.0.0.1
//下載鏡像進行測驗 下載鏡像進行測驗 
docker pull nginx
//鏡像打標簽 
docker tag nginx 127.0.0.1/myimages/nginx:v1
//上傳鏡像到 上傳鏡像到 Harbor 
docker push 127.0.0.1/myimages/nginx:v1

以上操作都是在 Harbor 服務器本地操作，如果其他客戶端上傳鏡像到 Harbor，就會報如下錯誤，出現這問題的原因 Docker Registry 互動默認使用的是 HTTPS，但是搭建私有鏡像默認使用的是 HTTP 服務，所以與私有鏡像互動時出現以下錯誤，

[root@localhost ~]# docker login -u admin -p Harbor12345 http://14.0.0.20
WARNING! Using --password via the CLI is insecure. Use --password-stdin.
Error response from daemon: Get https://14.0.0.20/v2/: dial tcp 14.0.0.20:443: connect: connection refused

如何解決：

[root@client ~]# vim /usr/lib/systemd/system/docker.service
ExecStart=/usr/bin/dockerd -H fd:// -- insecure-registry 14.0.0.30 -- containerd=/run/containerd/containerd.sock
[root@client ~]# systemctl daemon-reload 
[root@client ~]# systemctl restart docker
[root@client ~]# docker login -u admin -p Harbor12345 http://14.0.0.20

[root@localhost ~]# docker images
REPOSITORY                 TAG                 IMAGE ID            CREATED             SIZE
14.0.0.20/myimages/nginx   v1                  7e4d58f0e5f3        13 days ago         133MB
[root@localhost ~]# docker tag 14.0.0.20/myimages/nginx:v1 14.0.0.20/myimages/nginx:v2
[root@localhost ~]# docker push 14.0.0.20/myimages/nginx:v2

五、維護管理harbor

可以使用 docker-compose 來管理 Harbor，一些有用的命令如下所示，必須在與
docker-compose.yml 相同的目錄中運行，
修改 Harbor.cfg 組態檔
要更改 Harbour 的組態檔時，請先停止現有的 Harbor 實體并更新 Harbor.cfg；然
后運行 prepare 腳本來填充配置；最后重新創建并啟動 Harbor 的實體，

1.停止現有的 Harbor 實體
docker-compose down -v
[root@localhost harbor]# pwd
/usr/local/harbor
[root@localhost harbor]# ls
common                     docker-compose.yml     harbor.v1.2.2.tar.gz  NOTICE
docker-compose.clair.yml   harbor_1_1_0_template  install.sh            prepare
docker-compose.notary.yml  harbor.cfg             LICENSE               upgrade
2.更新 Harbor.cfg
[root@localhost harbor]# vim Harbor.cfg
3.運行 prepare 腳本來填充配置
[root@localhost harbor]# ./prepare
4.重新創建并啟動 Harbor 的實體
如果出現如下報錯： docker-compose up -d
Creating network "harbor_harbor" with the default driver
ERROR: Failed to Setup IP tables: Unable to enable SKIP DNAT rule: (iptables failed: iptables -- wait -t nat -I DOCKER -i br-25094fc09b3c -j RETURN: iptables: No chain/target/match by that name.
(exit status 1))
解決方法：關閉防火墻后， 解決：關閉防火墻后， docker需要重啟 
systemctl restart docker 
docker-compose up -d

//創建用戶chen，并將其創建為myimages專案的開發人員

#在客戶端上操作：使用新創建的開發人員用戶登錄

[root@localhost ~]# docker logout 14.0.0.20
Removing login credentials for 14.0.0.20
[root@localhost ~]# docker login 14.0.0.20
Username: chen      #使用新創建的開發人員用戶
Password:
[root@localhost ~]# docker pull 14.0.0.20/myimages/nginx:v1
v1: Pulling from myimages/nginx
Digest: sha256:794275d96b4ab96eeb954728a7bf11156570e8372ecd5ed0cbc7280313a27d19
Status: Image is up to date for 14.0.0.20/myimages/nginx:v1
14.0.0.20/myimages/nginx:v1
[root@localhost ~]# docker images
REPOSITORY                 TAG                 IMAGE ID            CREATED             SIZE
14.0.0.20/myimages/nginx   v1                  7e4d58f0e5f3        13 days ago         133MB
14.0.0.20/myimages/nginx   v2                  7e4d58f0e5f3        13 days ago         133MB

#移除 Harbor 服務容器同時保留鏡像資料/資料庫

//在 Harbor服務器上操作 docker-compose down -v
Stopping nginx ... done
Stopping harbor-jobservice ... done
Stopping harbor-ui ... done
Stopping registry ... done
Stopping harbor-db ... done
...省略內容

如需重新部署，需要移除 Harbor 服務容器全部資料
持久資料，如鏡像，資料庫等在宿主機的/data/目錄下,日志在宿主機的/var/log/Harbor/目錄下，

rm -rf /data/database/
rm -rf /data/registry/