以下是為 registry.k8s.io/pause:3.8 鏡像的導出與導入操作定制的完整教程，適用于 Kubernetes 集群中使用 containerd 作為容器運行時的場景。本教程包含詳細步驟、常見問題解析及注意事項。

---

從零實現 registry.k8s.io/pause:3.8 鏡像的導出與導入

背景說明

Kubernetes 基礎鏡像 registry.k8s.io/pause:3.8 是 Pod 沙箱容器的基礎組件，若因網絡問題（如訪問 k8s.gcr.io 受限）導致無法直接拉取，可通過替代鏡像源獲取并手動導入到 containerd 中。本教程提供全流程操作指南。

---

步驟一：拉取替代鏡像

由于直接訪問 registry.k8s.io 可能受限，建議使用國內鏡像源（如阿里云鏡像倉庫）拉取同名鏡像：

# 從阿里云鏡像源拉取 pause:3.8
docker pull registry.cn-hangzhou.aliyuncs.com/google_containers/pause:3.8# 重命名為 Kubernetes 官方鏡像名稱
docker tag registry.cn-hangzhou.aliyuncs.com/google_containers/pause:3.8 registry.k8s.io/pause:3.8

---

步驟二：導出鏡像為 tar 文件

將鏡像打包為離線文件以便傳輸：

docker save registry.k8s.io/pause:3.8 -o pause-3.8.tar

---

步驟三：導入鏡像至 containerd

使用 ctr 工具將鏡像導入到 containerd 的 k8s.io 命名空間（關鍵步驟）：

# 導入鏡像到 k8s.io 命名空間
sudo ctr -n k8s.io images import pause-3.8.tar# 驗證鏡像是否存在
sudo ctr -n k8s.io images ls | grep "pause:3.8"

注意：-n k8s.io 必須指定，否則鏡像會被導入到 default 命名空間，導致 Kubernetes 無法識別。

---

步驟四：驗證鏡像可用性

創建一個測試 Pod 以確認鏡像加載成功：

# test-pause.yaml
apiVersion: v1
kind: Pod
metadata:name: test-pause
spec:containers:- name: pause-containerimage: registry.k8s.io/pause:3.8command: ["/pause"]

執行以下命令驗證：

kubectl apply -f test-pause.yaml
kubectl get pod test-pause -o wide

若 Pod 狀態為 Running，則表明鏡像導入成功。

---

常見問題與解決方案

1. 鏡像導入后 Pod 仍處于 ContainerCreating 狀態

• 原因：鏡像未正確導入到 k8s.io 命名空間。
• 解決：

  # 刪除錯誤命名空間的鏡像
  sudo ctr -n default images rm registry.k8s.io/pause:3.8
  # 重新導入到 k8s.io
  sudo ctr -n k8s.io images import pause-3.8.tar
  

2. 拉取鏡像時網絡超時

• 原因：國內訪問 registry.k8s.io 受限。
• 解決：改用以下鏡像源：

  # 阿里云鏡像
  docker pull registry.cn-hangzhou.aliyuncs.com/google_containers/pause:3.8
  # 或 Google 鏡像代理
  docker pull mirrorgooglecontainers/pause:3.8
  

3. ctr 命令缺失 tag 功能

• 現象：低版本 ctr 不支持直接重命名鏡像。
• 解決：通過 docker tag 重命名后再導出：

  docker tag mirrorgooglecontainers/pause:3.8 registry.k8s.io/pause:3.8
  

---

高級操作：批量處理鏡像

若需批量導出多個鏡像，可編寫自動化腳本：

#!/bin/bash
# 導出鏡像列表
IMAGES=("pause:3.8" "nginx:1.25")
for IMAGE in "${IMAGES[@]}"; dodocker pull registry.cn-hangzhou.aliyuncs.com/google_containers/${IMAGE}docker tag registry.cn-hangzhou.aliyuncs.com/google_containers/${IMAGE} registry.k8s.io/${IMAGE}docker save registry.k8s.io/${IMAGE} -o ${IMAGE//:/_}.tar
done

---

附錄：關鍵命令速查表

操作	命令
拉取替代鏡像	docker pull registry.cn-hangzhou.aliyuncs.com/google_containers/pause:3.8
重命名鏡像	docker tag <源鏡像> registry.k8s.io/pause:3.8
導出為 tar 文件	docker save registry.k8s.io/pause:3.8 -o pause-3.8.tar
導入到 containerd	sudo ctr -n k8s.io images import pause-3.8.tar
驗證鏡像列表	sudo ctr -n k8s.io images ls | grep pause

---

參考文檔

• Containerd 鏡像導入問題解析
• Kubernetes 集群初始化與鏡像處理

通過本教程，可高效解決 registry.k8s.io/pause:3.8 鏡像的離線部署問題，適用于內網環境或網絡受限場景。