从零实现 registry.k8s.io/pause:3.8 镜像的导出与导入-CSDN博客

本文链接：https://blog.csdn.net/gs80140/article/details/147471583

以下是为 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-container
    image: registry.k8s.io/pause:3.8
    command: ["/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[@]}"; do
  docker 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`