Docker鏡像倉庫Harbor怎么用

Docker鏡像倉庫Harbor怎么用

目錄

1. 引言
2. Harbor簡介
3. Harbor的安裝與配置
   • 3.1 系統要求
   • 3.2 安裝Docker和Docker Compose
   • 3.3 下載Harbor安裝包
   • 3.4 配置Harbor
   • 3.5 啟動Harbor
4. Harbor的基本使用
   • 4.1 登錄Harbor
   • 4.2 創建項目
   • 4.3 推送鏡像到Harbor
   • 4.4 從Harbor拉取鏡像
5. Harbor的高級功能
   • 5.1 鏡像復制
   • 5.2 鏡像掃描
   • 5.3 用戶管理
   • 5.4 權限控制
6. Harbor的維護與監控
   • 6.1 備份與恢復
   • 6.2 日志管理
   • 6.3 監控與報警
7. 常見問題與解決方案
8. 總結

引言

在現代軟件開發中，容器技術已經成為不可或缺的一部分。Docker作為最流行的容器平臺之一，廣泛應用于開發、測試和生產環境中。隨著容器數量的增加，如何高效地管理和分發Docker鏡像成為了一個重要的問題。Harbor企業級的Docker鏡像倉庫，提供了豐富的功能來幫助用戶管理和分發Docker鏡像。本文將詳細介紹Harbor的安裝、配置、使用以及高級功能，幫助讀者全面掌握Harbor的使用方法。

Harbor簡介

Harbor是由VMware公司開源的一個企業級Docker鏡像倉庫，它提供了鏡像的存儲、分發、安全掃描、復制等功能。Harbor不僅支持Docker鏡像的存儲和分發，還支持Helm Chart的存儲和分發。Harbor的主要特點包括：

• 安全性：Harbor提供了基于角色的訪問控制（RBAC）、鏡像簽名、漏洞掃描等安全功能，確保鏡像的安全性。
• 高可用性：Harbor支持多節點部署，確保服務的高可用性。
• 易用性：Harbor提供了友好的Web界面，用戶可以方便地管理鏡像和項目。
• 擴展性：Harbor支持插件機制，用戶可以根據需要擴展Harbor的功能。

Harbor的安裝與配置

3.1 系統要求

在安裝Harbor之前，需要確保系統滿足以下要求：

• 操作系統：Linux（推薦Ubuntu 16.04或更高版本）
• Docker版本：1.10.0或更高版本
• Docker Compose版本：1.6.0或更高版本
• 硬件要求：至少4GB內存，2核CPU，50GB磁盤空間

3.2 安裝Docker和Docker Compose

在安裝Harbor之前，需要先安裝Docker和Docker Compose。以下是安裝步驟：

# 安裝Docker
sudo apt-get update
sudo apt-get install -y docker.io

# 啟動Docker服務
sudo systemctl start docker
sudo systemctl enable docker

# 安裝Docker Compose
sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

3.3 下載Harbor安裝包

Harbor的安裝包可以從其GitHub倉庫下載。以下是下載步驟：

# 下載Harbor安裝包
wget https://github.com/goharbor/harbor/releases/download/v2.4.0/harbor-offline-installer-v2.4.0.tgz

# 解壓安裝包
tar -xzf harbor-offline-installer-v2.4.0.tgz
cd harbor

3.4 配置Harbor

Harbor的配置文件位于harbor.yml中。用戶可以根據需要修改配置文件。以下是常見的配置項：

# 主機名
hostname: harbor.example.com

# HTTP端口
http:
  port: 80

# HTTPS端口
https:
  port: 443
  certificate: /path/to/certificate.crt
  private_key: /path/to/private.key

# 數據庫配置
database:
  password: root123

# 數據存儲路徑
data_volume: /data/harbor

# 日志配置
log:
  level: info
  rotate_count: 50
  rotate_size: 200M
  location: /var/log/harbor

3.5 啟動Harbor

配置完成后，可以使用以下命令啟動Harbor：

sudo ./install.sh

啟動完成后，可以通過瀏覽器訪問Harbor的Web界面，默認地址為http://<hostname>。

Harbor的基本使用

4.1 登錄Harbor

在瀏覽器中訪問Harbor的Web界面后，使用默認的管理員賬號admin和密碼Harbor12345登錄。

4.2 創建項目

在Harbor中，鏡像存儲在一個個項目中。用戶可以根據需要創建項目。以下是創建項目的步驟：

1. 登錄Harbor后，點擊左側菜單中的“項目”。
2. 點擊“新建項目”按鈕。
3. 輸入項目名稱和描述，選擇訪問級別（公開或私有），然后點擊“確定”。

4.3 推送鏡像到Harbor

要將本地鏡像推送到Harbor，首先需要登錄Harbor的Docker Registry。以下是推送鏡像的步驟：

# 登錄Harbor
docker login harbor.example.com

# 給本地鏡像打標簽
docker tag my-image:latest harbor.example.com/my-project/my-image:latest

# 推送鏡像到Harbor
docker push harbor.example.com/my-project/my-image:latest

4.4 從Harbor拉取鏡像

要從Harbor拉取鏡像，首先需要登錄Harbor的Docker Registry。以下是拉取鏡像的步驟：

# 登錄Harbor
docker login harbor.example.com

# 拉取鏡像
docker pull harbor.example.com/my-project/my-image:latest

Harbor的高級功能

5.1 鏡像復制

Harbor支持將鏡像從一個Harbor實例復制到另一個Harbor實例。以下是配置鏡像復制的步驟：

1. 登錄Harbor后，點擊左側菜單中的“復制管理”。
2. 點擊“新建復制規則”按鈕。
3. 輸入源Harbor實例和目標Harbor實例的地址，選擇要復制的項目，然后點擊“確定”。

5.2 鏡像掃描

Harbor集成了Clair和Trivy等漏洞掃描工具，可以對鏡像進行安全掃描。以下是啟用鏡像掃描的步驟：

1. 登錄Harbor后，點擊左側菜單中的“系統管理”。
2. 點擊“漏洞掃描”選項卡。
3. 選擇要使用的掃描工具，然后點擊“保存”。

5.3 用戶管理

Harbor支持多用戶管理，可以為不同的用戶分配不同的權限。以下是創建用戶的步驟：

1. 登錄Harbor后，點擊左側菜單中的“用戶管理”。
2. 點擊“新建用戶”按鈕。
3. 輸入用戶名、密碼和郵箱，選擇用戶角色，然后點擊“確定”。

5.4 權限控制

Harbor提供了基于角色的訪問控制（RBAC），可以為不同的用戶和項目分配不同的權限。以下是配置權限的步驟：

1. 登錄Harbor后，點擊左側菜單中的“項目”。
2. 選擇要配置權限的項目，點擊“成員”選項卡。
3. 點擊“添加成員”按鈕，選擇用戶和角色，然后點擊“確定”。

Harbor的維護與監控

6.1 備份與恢復

Harbor的數據包括鏡像、數據庫和配置文件。為了確保數據安全，需要定期備份Harbor的數據。以下是備份和恢復的步驟：

# 備份Harbor數據
sudo tar -czf harbor-backup-$(date +%Y%m%d).tar.gz /data/harbor /var/lib/docker/volumes/harbor_* /etc/harbor

# 恢復Harbor數據
sudo tar -xzf harbor-backup-20231001.tar.gz -C /

6.2 日志管理

Harbor的日志文件位于/var/log/harbor目錄下。用戶可以根據需要查看和管理日志文件。以下是查看日志的步驟：

# 查看Harbor日志
tail -f /var/log/harbor/harbor.log

6.3 監控與報警

Harbor支持與Prometheus和Grafana等監控工具集成，可以實時監控Harbor的運行狀態。以下是配置監控的步驟：

1. 登錄Harbor后，點擊左側菜單中的“系統管理”。
2. 點擊“監控”選項卡。
3. 配置Prometheus和Grafana的地址，然后點擊“保存”。

常見問題與解決方案

7.1 Harbor啟動失敗

問題描述：Harbor啟動時出現錯誤，無法正常啟動。

解決方案：檢查Harbor的日志文件/var/log/harbor/harbor.log，查找錯誤信息并解決。

7.2 鏡像推送失敗

問題描述：推送鏡像到Harbor時出現錯誤。

解決方案：檢查Docker客戶端和Harbor的日志文件，確保網絡連接正常，并且Harbor的存儲空間充足。

7.3 鏡像掃描失敗

問題描述：鏡像掃描失敗，無法獲取掃描結果。

解決方案：檢查Harbor的日志文件，確保漏洞掃描工具（如Clair或Trivy）正常運行，并且網絡連接正常。

總結

Harbor企業級的Docker鏡像倉庫，提供了豐富的功能來幫助用戶管理和分發Docker鏡像。通過本文的介紹，讀者可以掌握Harbor的安裝、配置、使用以及高級功能，從而在實際工作中更好地利用Harbor來管理Docker鏡像。希望本文能夠幫助讀者全面了解Harbor，并在實際應用中發揮其強大的功能。