目錄
1. harbor介紹
2. docker-ce的安裝
3. docker-compose的安裝
4. Harbor私有倉庫的安裝
5. 客戶端鏈接鏡像倉庫配置過程
1. harbor介紹
Docker容器應用的開發和運行離不開可靠的鏡像管理，雖然Docker官方也提供了公共的鏡像倉庫，可是從安全和效率等方面考慮，部署咱們私有環境內的Registry也是很是必要的。Harbor是由VMware公司開源的企業級的Docker Registry管理項目，它包括權限管理(RBAC)、LDAP、日誌審覈、管理界面、自我註冊、鏡像複製和中文支持等功能。python
2. docker-ce的安裝
step 1：安裝一些必要的系統工具mysql
yum install -y yum-utils device-mapper-persistent-data lvm2
Step 2：添加docker鏡像源linux
yum-config-manager --add-repo http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo
Step 3: 安裝 Docker-CEnginx
yum -y install docker-ce
Step 4: 開啓Docker服務git
systemctl start docker.server
注意：
官方軟件源默認啓用了最新的軟件，您能夠經過編輯軟件源的方式獲取各個版本的軟件包。例如官方並無將測試版本的軟件源置爲可用，你能夠經過如下方式開啓。同理能夠開啓各類測試版本等。github
vim /etc/yum.repos.d/docker-ce.repo
將 [docker-ce-test] 下方的 enabled=0 修改成 enabled=1sql
安裝指定版本的Docker-CE:
Step 1: 查找Docker-CE的版本:docker
yum list docker-ce.x86_64 --showduplicates | sort -r
Loading mirror speeds from cached hostfile
Loaded plugins: branch, fastestmirror, langpacks
docker-ce.x86_64 17.03.1.ce-1.el7.centos docker-ce-stable
docker-ce.x86_64 17.03.1.ce-1.el7.centos @docker-ce-stable
docker-ce.x86_64 17.03.0.ce-1.el7.centos docker-ce-stable
Available Packages
Step2 : 安裝指定版本的Docker-CE: (VERSION 例如上面的 17.03.0.ce.1-1.el7.centos)shell
yum -y install docker-ce-[VERSION]
FQA：
默認配置下，若是在 CentOS 使用 Docker CE 看到下面的這些警告信息：數據庫
WARNING: bridge-nf-call-iptables is disabled
WARNING: bridge-nf-call-ip6tables is disabled
#請添加內核配置參數以啓用這些功能。
$ sudo tee -a /etc/sysctl.conf <<-EOF
net.bridge.bridge-nf-call-ip6tables = 1
net.bridge.bridge-nf-call-iptables = 1
EOF
而後從新加載 sysctl.conf 便可
$ sudo sysctl -p
3.安裝docker-compose
方法一
curl -L https://github.com/docker/compose/releases/download/1.18.0/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose
#查看版本
docker-compose version
方法二
CentOS:
yum install epel-release -y
yum install python-pip -y
Ubuntu:
apt-get install python-pip -y
# 通用命令
pip --version
pip install --upgrade pip
pip install -U -i https://pypi.tuna.tsinghua.edu.cn/simple docker-compose
docker-compose version
4.Harbor私有倉庫的安裝
- 下載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
本次離線安裝。
推薦使用第二種，由於第一種在線安裝可能因爲官網源的網絡波動致使安裝失敗。
- 配置Harbor
解壓縮以後，目錄下回生成harbor.conf文件，該文件就是Harbor的配置文件。
## Configuration file of Harbor
# hostname設置訪問地址，可使用ip、域名，不能夠設置爲127.0.0.1或localhost
hostname = docker.bksx.com
# 訪問協議，默認是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 = sample_admin@mydomain.com
email_password = abc
email_from = admin <sample_admin@mydomain.com>
email_ssl = false
# 啓動Harbor後，管理員UI登陸的密碼，默認是Harbor12345
harbor_admin_password = 1qaz@WSX
# 認證方式，這裏支持多種認證方式，如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
-
啓動 Harbor
修改完配置文件後，在的當前目錄執行./install.sh，Harbor服務就會根據當期目錄下的docker-compose.yml開始下載依賴的鏡像，檢測並按照順序依次啓動各
[root@localhost harbor]# ./install.sh
[Step 0]: checking installation environment ...
Note: docker version: 18.03.1
Note: docker-compose version: 1.18.0
[Step 1]: loading Harbor images ...
- 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://docker.bksx.com，默認是80端口，若是端口占用，咱們能夠去修改docker-compose.yml文件中，對應服務的端口映射。windos，hosts文件地址：C:\Windows\System32\drivers\etc，將域名與ip添加進去便可。
- 登陸 Web Harbor
輸入用戶名admin，默認密碼（或已修改密碼）登陸系統。
咱們能夠看到系統各個模塊以下：
- 項目：新增/刪除項目，查看鏡像倉庫，給項目添加成員、查看操做日誌、複製項目等
- 日誌：倉庫各個鏡像create、push、pull等操做日誌
- 系統管理
- 用戶管理：新增/刪除用戶、設置管理員等
- 複製管理：新增/刪除從庫目標、新建/刪除/啓停複製規則等
- 配置管理：認證模式、複製、郵箱設置、系統設置等
- 其餘設置
- 用戶設置：修改用戶名、郵箱、名稱信息
- 修改密碼：修改用戶密碼
注意：非系統管理員用戶登陸，只能看到有權限的項目和日誌，其餘模塊不可見。
- 新建項咱們新建一個名稱爲wanyang的項目，設置不公開。注意：當項目設爲公開後，任何人都有此項目下鏡像的讀權限。命令行用戶不須要「docker login」就能夠拉取此項目下的鏡像。
新建項目完畢後，咱們就能夠用admin帳戶提交本地鏡像到Harbor倉庫了。例如咱們提交本地nginx鏡像
1、admin登陸
$ docker login docker.bksx.com
Username: admin
Password:
Login Succeeded
2、給鏡像打tag
$ docker tag nginx docker.bksx.com/docker/nginx:latest
$ docker images
REPOSITORY TAG IMAGE ID CREATED SIZE
nginx latest 958a7ae9e569 2 weeks ago 109 MB
docker.bksx.com/docker/nginx latest 958a7ae9e569 2 weeks ago 109 MB
3、push到倉庫
$ docker push docker.bksx.com/docker/nginx
The push refers to a repository [docker.bksx.com/docker/nginx]
a552ca691e49: Pushed
7487bf0353a7: Pushed
8781ec54ba04: Pushed
latest: digest: sha256:41ad9967ea448d7c2b203c699b429abe1ed5af331cd92533900c6d77490e0268 size: 948
上傳完畢後，登陸Web Harbor，選擇項目，項目名稱docker，就能夠查看剛纔上傳的nginx image了。
- FAQ
- 配置並啓動Harbor以後，本地執行登陸操做，報錯：
docker login docker.bksx.com
Username: admin
Password:
Error response from daemon: Get https://docker.bksx.com/v2/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的時就會報錯。解決辦法：
- 若是系統是MacOS，則能夠點擊「Preference」裏面的「Advanced」在「Insecure
Registry」里加上docker.bksx.com，重啓Docker客戶端就能夠了。 - 若是系統是Ubuntu，則修改配置文件/lib/systemd/system/docker.service，修改[Service]下ExecStart參數，增長– insecure-registry
docker.bksx.com。 - 若是系統是Centos，能夠修改配置/etc/sysconfig/docker，將OPTIONS增長 –insecure-registry
docker.bksx.com。 - 若是是新版本的docker在/etc/sysconfig/ 沒有docker這個配置文件的狀況下。
#在daemon.json中添加如下參數
[root@localhost harbor]# cat /etc/docker/daemon.json
{
"insecure-registries": [
"docker.bksx.com"
]
}
注意：該文件必須符合 json 規範，不然 Docker 將不能啓動。
若是須要修改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