1. 程式人生 > >Docker映象倉庫Harbor之搭建及配置

Docker映象倉庫Harbor之搭建及配置

目錄

  • Harbor介紹
  • 環境、軟體準備
  • Harbor服務搭建
  • Harbor跨資料複製配置
  • FAQ

1、Harbor 介紹

Docker容器應用的開發和執行離不開可靠的映象管理,雖然Docker官方也提供了公共的映象倉庫,但是從安全和效率等方面考慮,部署我們私有環境內的Registry也是非常必要的。Harbor是由VMware公司開源的企業級的Docker Registry管理專案,它包括許可權管理(RBAC)、LDAP、日誌稽核、管理介面、自我註冊、映象複製和中文支援等功能。

2、環境、軟體準備

本次演示環境,我是在虛擬機器Linux Centos7上操作,以下是安裝的軟體及版本:

  1. Docker:version 1.12.6
  2. Docker-compose: version 1.13.0
  3. Harbor: version 1.1.2

注意:Harbor的所有服務元件都是在Docker中部署的,所以官方安裝使用Docker-compose快速部署,所以我們需要安裝Docker、Docker-compose。由於Harbor是基於Docker Registry V2版本,所以就要求Docker版本不小於1.10.0,Docker-compose版本不小於1.6.0。

1)Docker 安裝

  • yum安裝 yum install docker

2) Docker-compose 安裝

1、下載指定版本的docker-compose
    $ curl -L https://github.com/docker/compose/releases/download/1.13.0/docker-compose-`uname -s`-`uname -m` > /usr/local/bin/docker-compose
2、對二進位制檔案賦可執行許可權
    $ sudo chmod +x /usr/local/bin/docker-compose
3、測試下docker-compose是否安裝成功
    $ docker-compose --version
    docker-compose version 1.13
.0, build 1719ceb

3、Harbor 服務搭建

1)下載Harbor安裝檔案
從 github harbor 官網 release 頁面下載指定版本的安裝包。

1、線上安裝包
    $ wget https://github.com/vmware/harbor/releases/download/v1.1.2/harbor-online-installer-v1.1.2.tgz
    $ tar xvf harbor-online-installer-v1.1.2.tgz
2、離線安裝包
    $ wget https://github.com/vmware/harbor/releases/download/v1.1.2/harbor-offline-installer-v1.1.2.tgz
    $ tar xvf harbor-offline-installer-v1.1.2.tgz

2)配置Harbor
解壓縮之後,目錄下回生成harbor.conf檔案,該檔案就是Harbor的配置檔案。

## Configuration file of Harbor

# hostname設定訪問地址,可以使用ip、域名,不可以設定為127.0.0.1或localhost
hostname = 10.236.63.76

# 訪問協議,預設是http,也可以設定https,如果設定https,則nginx ssl需要設定on
ui_url_protocol = http

# mysql資料庫root使用者預設密碼root123,實際使用時修改下
db_password = root123

max_job_workers = 3 
customize_crt = on
ssl_cert = /data/cert/server.crt
ssl_cert_key = /data/cert/server.key
secretkey_path = /data
admiral_url = NA

# 郵件設定,傳送重置密碼郵件時使用
email_identity = 
email_server = smtp.mydomain.com
email_server_port = 25
email_username = samp[email protected]
email_password = abc
email_from = admin <[email protected]>
email_ssl = false

# 啟動Harbor後,管理員UI登入的密碼,預設是Harbor12345
harbor_admin_password = Harbor12345

# 認證方式,這裡支援多種認證方式,如LADP、本次儲存、資料庫認證。預設是db_auth,mysql資料庫認證
auth_mode = db_auth

# LDAP認證時配置項
#ldap_url = ldaps://ldap.mydomain.com
#ldap_searchdn = uid=searchuser,ou=people,dc=mydomain,dc=com
#ldap_search_pwd = password
#ldap_basedn = ou=people,dc=mydomain,dc=com
#ldap_filter = (objectClass=person)
#ldap_uid = uid 
#ldap_scope = 3 
#ldap_timeout = 5

# 是否開啟自注冊
self_registration = on

# Token有效時間,預設30分鐘
token_expiration = 30

# 使用者建立專案許可權控制,預設是everyone(所有人),也可以設定為adminonly(只能管理員)
project_creation_restriction = everyone

verify_remote_cert = on

3)啟動 Harbor
修改完配置檔案後,在的當前目錄執行./install.sh,Harbor服務就會根據當期目錄下的docker-compose.yml開始下載依賴的映象,檢測並按照順序依次啟動各個服務,Harbor依賴的映象及啟動服務如下:

# docker images
REPOSITORY                   TAG                 IMAGE ID            CREATED             SIZE
vmware/harbor-jobservice     v1.1.2              ac332f9bd31c        10 days ago         162.9 MB
vmware/harbor-ui             v1.1.2              803897be484a        10 days ago         182.9 MB
vmware/harbor-adminserver    v1.1.2              360b214594e7        10 days ago         141.6 MB
vmware/harbor-db             v1.1.2              6f71ee20fe0c        10 days ago         328.5 MB
vmware/registry              2.6.1-photon        0f6c96580032        4 weeks ago         150.3 MB
vmware/harbor-notary-db      mariadb-10.1.10     64ed814665c6        10 weeks ago        324.1 MB
vmware/nginx                 1.11.5-patched      8ddadb143133        10 weeks ago        199.2 MB
vmware/notary-photon         signer-0.5.0        b1eda7d10640        11 weeks ago        155.7 MB
vmware/notary-photon         server-0.5.0        6e2646682e3c        3 months ago        156.9 MB
vmware/harbor-log            v1.1.2              9c46a7b5e517        4 months ago        192.4 MB
photon                       1.0                 e6e4e4a2ba1b        11 months ago       127.5 MB

# docker-compose ps
       Name                     Command               State                                Ports                               
------------------------------------------------------------------------------------------------------------------------------
harbor-adminserver   /harbor/harbor_adminserver       Up                                                                       
harbor-db            docker-entrypoint.sh mysqld      Up      3306/tcp                                                         
harbor-jobservice    /harbor/harbor_jobservice        Up                                                                       
harbor-log           /bin/sh -c crond && rm -f  ...   Up      127.0.0.1:1514->514/tcp                                          
harbor-ui            /harbor/harbor_ui                Up                                                                       
nginx                nginx -g daemon off;             Up      0.0.0.0:443->443/tcp, 0.0.0.0:4443->4443/tcp, 0.0.0.0:80->80/tcp 
registry             /entrypoint.sh serve /etc/ ...   Up      5000/tcp           

啟動完成後,我們訪問剛設定的hostname即可 http://10.236.63.76/,預設是80埠,如果端口占用,我們可以去修改docker-compose.yml檔案中,對應服務的埠對映。

這裡寫圖片描述

4) 登入 Web Harbor
輸入使用者名稱admin,預設密碼(或已修改密碼)登入系統。

這裡寫圖片描述

我們可以看到系統各個模組如下:

  • 專案:新增/刪除專案,檢視映象倉庫,給專案新增成員、檢視操作日誌、複製專案等
  • 日誌:倉庫各個映象create、push、pull等操作日誌
  • 系統管理
    • 使用者管理:新增/刪除使用者、設定管理員等
    • 複製管理:新增/刪除從庫目標、新建/刪除/啟停複製規則等
    • 配置管理:認證模式、複製、郵箱設定、系統設定等
  • 其他設定
    • 使用者設定:修改使用者名稱、郵箱、名稱資訊
    • 修改密碼:修改使用者密碼

注意:非系統管理員使用者登入,只能看到有許可權的專案和日誌,其他模組不可見。

5)新建專案
我們新建一個名稱為wanyang的專案,設定不公開。注意:當專案設為公開後,任何人都有此專案下映象的讀許可權。命令列使用者不需要“docker login”就可以拉取此專案下的映象。

這裡寫圖片描述

新建專案完畢後,我們就可以用admin賬戶提交本地映象到Harbor倉庫了。例如我們提交本地nginx映象:

1、admin登入
$ docker login 10.236.63.76
Username: admin
Password:
Login Succeeded

2、給映象打tag
$ docker tag nginx 10.236.63.76/wanyang/nginx:latest
$ docker images
REPOSITORY                         TAG                 IMAGE ID            CREATED             SIZE
nginx                              latest              958a7ae9e569        2 weeks ago         109 MB
10.236.63.76/wanyang/nginx         latest              958a7ae9e569        2 weeks ago         109 MB

3push到倉庫
$ docker push 10.236.63.76/wanyang/nginx
The push refers to a repository [10.236.63.76/wanyang/nginx]
a552ca691e49: Pushed
7487bf0353a7: Pushed
8781ec54ba04: Pushed
latest: digest: sha256:41ad9967ea448d7c2b203c699b429abe1ed5af331cd92533900c6d77490e0268 size: 948

上傳完畢後,登入Web Harbor,選擇專案,專案名稱wanyang,就可以檢視剛才上傳的nginx image了。

這裡寫圖片描述

6) 建立使用者並分配許可權
我們剛一直是用admin操作,實際應用中我們使用每個人自己的賬戶登入。所以就需要新建使用者,同時為了讓使用者有許可權操作已經建立的專案,還必須將該使用者新增到該專案成員中。
建立使用者名稱為wanyang的測試使用者,點選系統管理-》使用者管理-》建立使用者,輸入使用者名稱、郵箱、密碼等資訊。

這裡寫圖片描述

將wanyang使用者新增到wanyang專案成員中,點選專案-》wanyang-》成員-》新建成員,填寫姓名,選擇角色。

這裡寫圖片描述

現在我們使用wanyang賬戶本地模擬操作pull剛上傳的nginx映象。

1、先移除tag(因為我本地剛上傳了該nginx映象,直接pull,檢測本地存在就不會pull)
$ docker rmi -f 10.236.63.76/wanyang/nginx
Untagged: 10.236.63.76/wanyang/nginx:latest
Untagged: 10.236.63.76/wanyang/nginx@sha256:41ad9967ea448d7c2b203c699b429abe1ed5af331cd92533900c6d77490e0268

2、退出admin賬號,登入wanyang賬號
$ docker logout 10.236.63.76
Removing login credentials for 10.236.63.76
$ docker login 10.236.63.76
Username: wanyang
Password:
Login Succeeded

3、pull harbor映象到本地
$ docker pull 10.236.63.76/wanyang/nginx:latest
latest: Pulling from wanyang/nginx
Digest: sha256:41ad9967ea448d7c2b203c699b429abe1ed5af331cd92533900c6d77490e0268
Status: Downloaded newer image for 10.236.63.76/wanyang/nginx:latest

7)配置 Docker 映象複製
首先我們至少配置兩個Harbor服務 :

  1. Harbor1:10.236.63.76
  2. Harbor2:10.236.63.62

我們已經往Harbor1上面push了一個映象了,那麼就把Harbor1當做主節點,Harbor2當做複製節點,我們要把Harbor1上的映象自動複製到Harbor2上去。

配置複製規則,點選專案-》wanyang-》複製-》新建複製規則,填寫名稱、目標名、目標URL等資訊。 注意:目標URL這裡是複製節點Harbor2地址,http://10.236.63.62,使用者名稱和密碼為Harbor2配置的admin賬戶和密碼,一旦勾選啟用,那麼新建複製規則完成後,立馬就檢測需要同步的image自動同步。

這裡寫圖片描述

為了更好的演示效果,現在我往Harbor1上wanyang專案下在push一個映象maven:3-jdk-8,看下新上傳的映象會不會自動同步到Harbor2上去。

這裡寫圖片描述

push完畢,顯示已完成複製到Harbor2,現在登入到Harbor2 Web Harbor,我們看到映象已經自動複製過來啦,操作日誌也會一起復制過來。

這裡寫圖片描述

我們現在從Harbor2上面pull下剛同步過去的maven映象試試看,妥妥的沒問題。

$ docker login 10.236.63.62
Username: admin
Password:
Login Succeeded

$ docker pull 10.236.63.62/wanyang/maven:3-jdk-8
3-jdk-8: Pulling from wanyang/maven
Digest: sha256:16e68f691322cd425d27c798f88df4eb3c4322fe294067f21325b36ec587fa06
Status: Downloaded newer image for 10.236.63.62/wanyang/maven:3-jdk-8

$ docker images
REPOSITORY                         TAG                 IMAGE ID            CREATED             SIZE
nginx                              latest              958a7ae9e569        2 weeks ago         109 MB
10.236.63.76/wanyang/nginx         latest              958a7ae9e569        2 weeks ago         109 MB
10.236.63.62/wanyang/maven         3-jdk-8             c58c661bb6ad        5 weeks ago         653 MB
10.236.63.76/wanyang/maven         3-jdk-8             c58c661bb6ad        5 weeks ago         653 MB
maven                              3-jdk-8             c58c661bb6ad        5 weeks ago         653 MB

我們在看下Harbor1和Harbor2上的操作日誌,是都按照我們操作的順序顯示的。

這裡寫圖片描述

這裡寫圖片描述

5、FAQ

  1. 配置並啟動Harbor之後,本地執行登入操作,報錯:

    docker login 10.236.63.76
    Username: admin
    Password:
    Error response from daemon: Get https://10.236.63.76/v1/users/: dial tcp 10.236.63.76:443: getsockopt: connection refused

    這是因為docker1.3.2版本開始預設docker registry使用的是https,我們設定Harbor預設http方式,所以當執行用docker login、pull、push等命令操作非https的docker regsitry的時就會報錯。解決辦法:

    1. 如果系統是MacOS,則可以點選“Preference”裡面的“Advanced”在“Insecure Registry”里加上10.236.63.76,重啟Docker客戶端就可以了。
    2. 如果系統是Ubuntu,則修改配置檔案/lib/systemd/system/docker.service,修改[Service]下ExecStart引數,增加–insecure-registry 10.236.63.76。
    3. 如果系統是Centos,可以修改配置/etc/sysconfig/docker,將OPTIONS增加–insecure-registry 10.236.63.76。
  2. 使用wanyang賬戶執行docker pull命令時,報錯

    $ docker pull 10.236.63.76/wanyang/nginx:latest
    Error response from daemon: repository 10.236.63.76/wanyang/nginx not found: does not exist or no pull access

    這是原因可能有,一是Harbor倉庫上wanyang/nginx確實不存在,二是專案未設定公開的時候,該賬戶未執行docker login 10.236.63.76登入操作,三是該賬戶對10.236.63.76/wanyang專案沒有許可權,需要在該專案下增加wanyang成員,並選擇角色。

  3. 如果需要修改Harbor的配置檔案harbor.cfg,因為Harbor是基於docker-compose服務編排的,我們可以使用docker-compose命令重啟Harbor。不修改配置檔案,重啟Harbor命令:docker-compose start | stop | restart

    1、停止Harbor
    $ docker-compose down -v
    Stopping nginx ... done
    Stopping harbor-jobservice ... done
    ......
    Removing harbor-log ... done
    Removing network harbor_harbor
    
    2、啟動Harbor
    $ docker-compose up -d
    Creating network "harbor_harbor" with the default driver
    Creating harbor-log ... 
    ......
    Creating nginx
    Creating harbor-jobservice ... done
    

參考資料: