快捷導(dǎo)航

如何將Docker Registry存儲(chǔ)中的Docker鏡像遷移到Harbor

更新時(shí)間：2025年05月29日 09:24:14 作者：學(xué)亮編程手記

這篇文章主要介紹了如何將Docker Registry存儲(chǔ)中的Docker鏡像遷移到Harbor問題,具有很好的參考價(jià)值,希望對(duì)大家有所幫助,如有錯(cuò)誤或未考慮完全的地方,望不吝賜教

Docker Registry存儲(chǔ)的Docker鏡像遷移到Harbor

#!/bin/bash
REGISTRY_PATH="/var/lib/registry"
REGISTRY_DOMAIN="${1}"
REGISTRY_USER="${2}"
REGISTRY_PWD="${3}"

# 切換到 registry 存儲(chǔ)主目錄下
cd ${REGISTRY_PATH}

gen_skopeo_dir() {
   # 定義 registry 存儲(chǔ)的 blob 目錄 和 repositories 目錄，方便后面使用
    BLOB_DIR="docker/registry/v2/blobs/sha256"
    REPO_DIR="docker/registry/v2/repositories"
    # 定義生成 skopeo 目錄
    SKOPEO_DIR="docker/skopeo"
    # 通過 find 出 current 文件夾可以得到所有帶 tag 的鏡像，因?yàn)橐粋€(gè) tag 對(duì)應(yīng)一個(gè) current 目錄
    for image in $(find ${REPO_DIR} -type d -name "current"); do
        # 根據(jù)鏡像的 tag 提取鏡像的名字
        name=$(echo ${image} | awk -F '/' '{print $5"/"$6":"$9}')
        link=$(cat ${image}/link | sed 's/sha256://')
        mfs="${BLOB_DIR}/${link:0:2}/${link}/data"
        # 創(chuàng)建鏡像的硬鏈接需要的目錄
        mkdir -p "${SKOPEO_DIR}/${name}"
        # 硬鏈接鏡像的 manifests 文件到目錄的 manifest 文件
        ln -f ${mfs} ${SKOPEO_DIR}/${name}/manifest.json
        # 使用正則匹配出所有的 sha256 值，然后排序去重
        layers=$(grep -Eo "\b[a-f0-9]{64}\b" ${mfs} | sort -n | uniq)
        for layer in ${layers}; do
            # 硬鏈接 registry 存儲(chǔ)目錄里的鏡像 layer 和 images config 到鏡像的 dir 目錄
            ln -f ${BLOB_DIR}/${layer:0:2}/${layer}/data ${SKOPEO_DIR}/${name}/${layer}
        done
    done
}

sync_image() {
    # 使用 skopeo sync 將 dir 格式的鏡像同步到 harbor
    for project in $(ls ${SKOPEO_DIR}); do
        skopeo sync --insecure-policy --src-tls-verify=false --dest-tls-verify=false \
        --dest-creds ${REGISTRY_USER}:${REGISTRY_PWD} \
        --src dir --dest docker ${SKOPEO_DIR}/${project} ${REGISTRY_DOMAIN}
    done
}

gen_skopeo_dir
sync_image

該腳本用于將 Docker Registry 存儲(chǔ)中的鏡像遷移到 Harbor 或其他兼容的鏡像倉(cāng)庫(kù)，核心邏輯分為兩步：

生成符合 Skopeo 要求的目錄結(jié)構(gòu)（gen_skopeo_dir 函數(shù)）
使用 Skopeo 同步鏡像到目標(biāo)倉(cāng)庫(kù)（sync_image 函數(shù)）

逐段代碼解析

1. 初始化參數(shù)與路徑

REGISTRY_PATH="/var/lib/registry"  # Docker Registry 存儲(chǔ)根目錄
REGISTRY_DOMAIN="${1}"             # 目標(biāo) Harbor 域名（如 harbor.example.com）
REGISTRY_USER="${2}"               # Harbor 用戶名
REGISTRY_PWD="${3}"                # Harbor 密碼

作用：接收用戶輸入的 Harbor 地址和認(rèn)證信息，并指定 Registry 存儲(chǔ)路徑。

2. 生成 Skopeo 目錄結(jié)構(gòu)（gen_skopeo_dir）

BLOB_DIR="docker/registry/v2/blobs/sha256"  # 鏡像 Blob 存儲(chǔ)路徑
REPO_DIR="docker/registry/v2/repositories"  # 鏡像元數(shù)據(jù)存儲(chǔ)路徑
SKOPEO_DIR="docker/skopeo"                  # Skopeo 臨時(shí)目錄

for image in $(find ${REPO_DIR} -type d -name "current"); do
    name=$(echo ${image} | awk -F '/' '{print $5"/"$6":"$9}')  # 提取鏡像名（格式：項(xiàng)目/鏡像:標(biāo)簽）
    link=$(cat ${image}/link | sed 's/sha256://')               # 獲取 Manifest 的 SHA256 值
    mfs="${BLOB_DIR}/${link:0:2}/${link}/data"                  # 定位 Manifest 文件路徑
    mkdir -p "${SKOPEO_DIR}/${name}"                            # 創(chuàng)建鏡像目錄
    ln -f ${mfs} ${SKOPEO_DIR}/${name}/manifest.json           # 硬鏈接 Manifest 文件
    layers=$(grep -Eo "\b[a-f0-9]{64}\b" ${mfs} | sort -n | uniq)  # 提取所有 Layer SHA256
    for layer in ${layers}; do
        ln -f ${BLOB_DIR}/${layer:0:2}/${layer}/data ${SKOPEO_DIR}/${name}/${layer}  # 硬鏈接 Layer 文件
    done
done

核心功能：

遍歷 Registry 存儲(chǔ)目錄中的每個(gè)鏡像 Tag（通過 current 目錄標(biāo)識(shí)）。
通過硬鏈接（ln -f）復(fù)用 Registry 存儲(chǔ)中的 Blob 文件，避免磁盤復(fù)制開銷。
生成符合 Skopeo dir 格式的目錄結(jié)構(gòu)，包含 manifest.json 和 Layer 文件。

3. 同步鏡像到 Harbor（sync_image）

for project in $(ls ${SKOPEO_DIR}); do
    skopeo sync --insecure-policy --src-tls-verify=false --dest-tls-verify=false \
    --dest-creds ${REGISTRY_USER}:${REGISTRY_PWD} \
    --src dir --dest docker ${SKOPEO_DIR}/${project} ${REGISTRY_DOMAIN}
done

核心功能：

使用 skopeo sync 命令將生成的 dir 格式鏡像同步到 Harbor。
--dest-creds 指定 Harbor 的認(rèn)證信息，--src-tls-verify=false 忽略源/目標(biāo)的 TLS 驗(yàn)證（適用于非 HTTPS 或自簽名證書環(huán)境）。
按項(xiàng)目（Project）逐一批量同步鏡像。