第一步：備份現(xiàn)有 Registry 數(shù)據(jù)（重要?。?/h2>

在卸載任何東西之前，請務(wù)必備份您現(xiàn)有的鏡像數(shù)據(jù)，以防萬一需要回滾。

# 1. 查看舊倉庫占用的空間（確認數(shù)據(jù)位置）
sudo du -sh /data/docker-registry
# 2. 創(chuàng)建備份目錄
mkdir -p ~/backup
# 3. 將整個數(shù)據(jù)目錄打包備份
sudo tar czf ~/backup/old-registry-backup-$(date +"%Y%m%d").tar.gz -C /data docker-registry
# 4. 驗證備份文件是否創(chuàng)建成功
ls -lh ~/backup/

第二步：停止并卸載舊的 Docker Registry 容器

這一步是清理舊環(huán)境，為 Harbor 騰出空間和端口。

# 1. 停止并刪除舊的 registry 容器
docker stop docker-registry
docker rm docker-registry
# 2. （可選）如果您想徹底清理空間，可以刪除舊的數(shù)據(jù)目錄
# 注意：請確保上一步的備份已成功完成，再執(zhí)行此操作
# sudo rm -rf /data/docker-registry

第三步：部署 Harbor

我們將使用 Harbor 的離線安裝包進行部署，這種方式更穩(wěn)定可靠。

3.1 安裝 Docker Compose

Harbor 依賴于 Docker Compose 來管理其多個組件。

# 下載 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
# 賦予執(zhí)行權(quán)限
sudo chmod +x /usr/local/bin/docker-compose
# 驗證安裝
docker-compose --version

3.2 下載并配置 Harbor

1. 下載離線安裝包：
   訪問 Harbor 官方 GitHub 的 Release 頁面，找到 v2.7.1 或更新的穩(wěn)定版本，復(fù)制離線安裝包（harbor-offline-installer-<版本>.tgz）的下載鏈接，然后在服務(wù)器上執(zhí)行：

   cd ~
   wget https://github.com/goharbor/harbor/releases/download/v2.7.1/harbor-offline-installer-v2.7.1.tgz
   tar xvf harbor-offline-installer-v2.7.1.tgz
   cd harbor

2. 修改配置文件：
   復(fù)制配置文件模板并進行修改。

   cp harbor.yml.tmpl harbor.yml
   vim harbor.yml

   必須修改的配置項：

   # 修改為您的服務(wù)器IP地址或域名，例如：192.168.1.100
   hostname: 請?zhí)鎿Q為您的服務(wù)器IP
   # http 相關(guān)配置保持默認，監(jiān)聽80端口
   http:
     port: 80
   # 重要：將 https 相關(guān)部分全部注釋掉，因為我們暫時使用 HTTP
   # https:
     # port: 443
     # certificate: /your/certificate/path
     # private_key: /your/private/key/path
   # 修改管理員密碼（默認是 Harbor12345，請務(wù)必修改?。?
   harbor_admin_password: 您的新密碼
   # 修改數(shù)據(jù)存儲路徑（使用我們之前準(zhǔn)備的目錄）
   data_volume: /data/harbor

   請?zhí)貏e注意：因為我們是測試或內(nèi)網(wǎng)環(huán)境，這里暫時注釋掉 HTTPS 配置。生產(chǎn)環(huán)境務(wù)必配置證書啟用 HTTPS。

3.3 安裝并啟動 Harbor

# 創(chuàng)建數(shù)據(jù)目錄
sudo mkdir -p /data/harbor
# 執(zhí)行安裝腳本（這會自動拉取鏡像并啟動所有 Harbor 服務(wù)）
sudo ./install.sh

安裝完成后，您可以通過瀏覽器訪問 http://您的服務(wù)器IP，使用用戶名 admin 和您剛才設(shè)置的密碼登錄 Harbor 的 Web 管理界面。

第四步：將舊鏡像遷移到 Harbor

由于 Harbor 2.x 版本有自己的元數(shù)據(jù)管理機制，不能通過簡單地覆蓋存儲目錄來遷移。推薦使用最高效的工具：skopeo。

4.1 安裝 skopeo

# Ubuntu 18.04 可以直接從官方源安裝
sudo apt-get update
sudo apt-get install -y skopeo

4.2 執(zhí)行鏡像遷移

skopeo 可以在不同倉庫間直接復(fù)制鏡像，而無需在本地磁盤解壓和重新壓縮鏡像層，速度極快。

首先，在 Harbor 的 Web 界面中，為您舊的鏡像項目創(chuàng)建對應(yīng)的項目（Project）。例如，如果您舊倉庫中有一個鏡像叫 localhost:5000/myav1，那么您需要在 Harbor 中創(chuàng)建一個名為 myapp 的項目。

然后，使用 skopeo copy 命令進行遷移：

# 命令格式：
# skopeo copy --src-tls-verify=false --dest-tls-verify=false \
#   docker://舊倉庫地址/項目名/鏡像名:標(biāo)簽 \
#   docker://Harbor地址/項目名/鏡像名:標(biāo)簽
# 示例：將之前測試用的 hello-world 鏡像遷移到 Harbor
# 請將 192.168.1.100 替換為您的實際服務(wù)器IP
skopeo copy --src-tls-verify=false --dest-tls-verify=false \
  docker://localhost:5000/hello-world:test \
  docker://192.168.1.100/library/hello-world:test

提示：您可以通過腳本批量處理所有鏡像。先通過 curl http://localhost:5000/v2/_catalog 獲取鏡像列表，然后寫一個循環(huán)腳本逐個遷移。

第五步：配置 Docker 客戶端并驗證

修改您本機和所有需要訪問新倉庫的客戶端的 Docker 配置，將新 Harbor 地址也加入 insecure-registries 列表。

# 編輯 Docker 配置文件
sudo vim /etc/docker/daemon.json

確保文件內(nèi)容如下：

{
  "insecure-registries": ["您的服務(wù)器IP:5000", "您的服務(wù)器IP"]
}

重啟 Docker：

sudo systemctl restart docker

現(xiàn)在，您可以登錄新的 Harbor 并進行驗證：

# 登錄 Harbor (輸入您設(shè)置的 admin 密碼)
docker login 您的服務(wù)器IP
# 拉取剛才遷移的鏡像進行測試
docker pull 您的服務(wù)器IP/library/hello-world:test
# 運行測試
docker run --rm 您的服務(wù)器IP/library/hello-world:test

通過以上步驟，您就成功地從單機的 Docker Registry 遷移到了企業(yè)級的 Harbor 倉庫。如果在這個過程中遇到任何問題，例如配置文件修改或鏡像遷移腳本編寫，隨時可以再問我。

到此這篇關(guān)于Docker Registry升級部署Harbor的實現(xiàn)步驟的文章就介紹到這了,更多相關(guān)Docker Registry升級部署Harbor內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評論