docker/desktop-kubernetes-pause

pause 镜像文档

一、镜像概述

1.1 基本信息

本镜像为 k8s.gcr.io/pause 官方镜像的部分标签镜像，旨在提供官方 pause 镜像的功能等效替代方案。

1.2 主要用途

作为 Kubernetes (K8s) 集群中 Pod 基础设施容器（Infra Container） 的核心组件，为每个 Pod 提供基础运行环境，是 Pod 内所有容器共享命名空间的载体。

二、核心功能与特性

2.1 核心功能

• 命名空间共享：提供 Pod 内所有容器的 PID 命名空间共享，使容器间可通过进程 ID 通信。
• 网络命名空间维护：作为 Pod 网络命名空间的持有者，统一管理 Pod 的网络接口、IP 地址等网络资源。
• 生命周期管理：维持 Pod 的基础运行状态，支持容器暂停/恢复等生命周期操作，确保 Pod 内容器协同工作。

2.2 主要特性

• 轻量级：镜像体积极小（通常仅几 MB），资源占用低，不影响集群性能。
• 功能等效：与 k8s.gcr.io/pause 官方镜像功能完全一致，确保兼容性。
• 多标签支持：提供与官方同步的多个版本标签（如 3.6、3.9 等），适配不同 K8s 版本需求。
• 架构兼容性：支持主流架构（如 amd64、arm64 等，具体取决于镜像标签）。

三、使用场景与适用范围

3.1 典型场景

• Kubernetes 集群部署：作为每个 Pod 的默认基础设施容器，由 kubelet 自动调度运行。
• 网络/存储插件测试：在调试 Pod 网络命名空间或存储卷挂载时，作为基础容器使用。
• 离线环境支持：在无法直接访问 k8s.gcr.io 官方仓库的场景下，提供本地化镜像替代。

3.2 适用范围

• 所有基于 Kubernetes 的容器编排环境（包括自建集群、云厂商托管集群等）。
• 需要与官方 pause 镜像功能兼容的场景（如版本匹配、命名空间共享机制等）。
• 对镜像仓库访问受限的环境（如内网集群、防火墙隔离环境）。

四、使用方法与配置说明

4.1 镜像拉取

通过以下命令拉取指定标签的镜像：

bash
docker pull [镜像仓库地址]/pause:[标签]
# 示例：拉取 3.9 版本
docker pull example-registry.com/pause:3.9

4.2 Kubernetes 配置

Kubernetes 默认通过 kubelet 的 --pod-infra-container-image 参数指定基础设施容器镜像。如需使用本镜像，需修改 kubelet 配置：

4.2.1 临时生效（测试环境）

在 kubelet 启动命令中添加参数：

bash
kubelet --pod-infra-container-image=[镜像仓库地址]/pause:[标签] ...

4.2.2 持久化配置（生产环境）

修改 kubelet 配置文件（通常为 /var/lib/kubelet/config.yaml）：

yaml
podInfraContainerImage: "[镜像仓库地址]/pause:[标签]"

重启 kubelet 使配置生效：

bash
systemctl restart kubelet

4.3 手动运行示例（调试用）

pause 镜像通常由 K8s 自动管理，手动运行仅用于调试：

bash
# 启动一个 pause 容器（后台运行）
docker run -d --name pause-demo [镜像仓库地址]/pause:[标签]

# 查看容器状态
docker ps | grep pause-demo

五、部署方案示例

5.1 单节点 K8s 集群配置（使用 kubeadm）

1. 拉取镜像：

   bash
   docker pull example-registry.com/pause:3.9
   

2. 初始化集群时指定基础设施镜像：

   bash
   kubeadm init --pod-network-cidr=10.244.0.0/16 \
     --image-repository=example-registry.com \
     --pod-infra-container-image=example-registry.com/pause:3.9
   

5.2 现有集群镜像替换

1. 更新所有节点的 kubelet 配置（/var/lib/kubelet/config.yaml）：

   yaml
   podInfraContainerImage: "example-registry.com/pause:3.9"
   

2. 重启所有节点的 kubelet：

   bash
   systemctl daemon-reload && systemctl restart kubelet
   

3. 验证配置生效：

   bash
   # 查看任意 Pod 的基础设施容器镜像
   kubectl get pod <pod-name> -o jsonpath='{.status.containerStatuses[0].image}'
   # 输出应为 "example-registry.com/pause:3.9"
   

5.3 镜像标签选择

需根据 Kubernetes 集群版本选择匹配的 pause 镜像标签，参考官方兼容性矩阵：

• K8s 1.24+ → pause:3.8+
• K8s 1.21-1.23 → pause:3.5-3.7
• K8s 1.18-1.20 → pause:3.2-3.4

六、注意事项

• 版本兼容性：必须使用与 K8s 集群版本匹配的镜像标签，避免因命名空间机制差异导致 Pod 异常。
• 镜像仓库可访问性：确保集群所有节点均可拉取该镜像（可通过私有仓库同步或本地加载镜像）。
• 无配置参数：pause 镜像为极简设计，无环境变量或配置参数，功能通过镜像本身实现。