registry.k8s.io/pause 镜像文档

1. 镜像概述和主要用途

1.1 概述

registry.k8s.io/pause（简称pause镜像）是Kubernetes生态的核心基础镜像，由Cloud Native Computing Foundation（CNCF）维护，作为Pod的基础设施容器（Infrastructure Container）。该镜像仅包含一个静态编译的二进制程序，用于维护Pod的命名空间并保障容器间资源共享。

1.2 主要用途

• 作为Pod的“根容器”，为Pod内所有业务容器提供共享的网络命名空间和PID命名空间
• 充当Pod内所有进程的init进程（PID 1），负责回收僵尸进程，避免资源泄漏
• 维持Pod的生命周期基础，确保业务容器重启或退出时网络命名空间持续存在

2. 核心功能和特性

2.1 命名空间管理

• 网络命名空间共享：启动时创建网络命名空间，Pod内其他容器通过加入该命名空间实现IP、端口、网络设备等资源共享
• PID命名空间共享：作为Pod的PID 1进程，统一管理Pod内所有进程的生命周期，负责回收僵尸进程

2.2 轻量级设计

• 极小体积：基于scratch基础镜像，仅包含pause二进制文件，典型版本体积<5MB（如pause:3.9约2.5MB）
• 零依赖：静态编译的二进制程序，不依赖glibc等系统库，可在任何Linux内核环境运行
• 低资源占用：启动时间<10ms，运行时CPU占用<0.1%，内存占用<1MB

2.3 稳定性与兼容性

• 版本严格匹配Kubernetes：如Kubernetes v1.24对应pause:3.7，v1.25对应pause:3.8，确保与容器运行时（containerd/CRI-O）兼容
• 长期维护：作为Kubernetes核心组件，由CNCF持续更新，修复命名空间管理及进程回收相关问题

3. 使用场景和适用范围

3.1 主要使用场景

• Kubernetes Pod基础设施：Kubernetes创建Pod时自动启动，为业务容器提供共享命名空间
• 容器网络调试：非K8s环境中模拟Pod网络共享，用于测试多容器网络互通（如微服务本地联调）

3.2 适用范围

• Kubernetes集群环境：云原生应用部署、微服务架构、容器化CI/CD等基于K8s的场景
• 容器运行时测试：验证containerd、Docker Engine等运行时的网络/命名空间功能
• 教育与实验：理解Kubernetes Pod网络模型和容器隔离机制的学***环境

4. 使用方法和配置说明

4.1 Kubernetes环境中的自动管理

Kubernetes集群中，pause容器由kubelet自动管理，用户无需手动配置。kubelet通过--pod-infra-container-image参数指定镜像（默认registry.k8s.io/pause:<version>），创建Pod时自动启动。

查看集群当前使用的pause镜像：

kubectl get nodes -o jsonpath='{.items[*].status.nodeInfo.containerRuntimeVersion}'
# 输出示例：containerd://1.6.21 (registry.k8s.io/pause:3.9)

4.2 手动运行与网络共享示例（Docker环境）

4.2.1 拉取并启动pause容器

# 拉取指定版本（如3.9）
docker pull registry.k8s.io/pause:3.9

# 启动pause容器
docker run -d --name pause-demo registry.k8s.io/pause:3.9

4.2.2 启动业务容器并加入命名空间

# 启动busybox容器，共享pause-demo的网络和PID命名空间
docker run -it --rm \
  --net=container:pause-demo \  # 共享网络命名空间
  --pid=container:pause-demo \   # 共享PID命名空间
  busybox sh

# 验证网络共享（IP与pause容器一致）
ifconfig

# 验证PID共享（pause进程为PID 1）
ps aux

4.2.3 清理资源

docker stop pause-demo && docker rm pause-demo

4.3 配置参数说明

pause镜像无可用配置参数或环境变量。其内部二进制程序仅执行：

1. 创建并维护网络/PID命名空间
2. 执行sigsuspend进入休眠状态（不占用CPU）
3. 等待SIGTERM信号终止

5. 版本与兼容性

5.1 版本命名规则

遵循<major>.<minor>格式（如3.9），与Kubernetes版本强关联：

• major：对应Kubernetes架构变更（如命名空间管理逻辑调整）
• minor：对应兼容性修复或优化

5.2 主流版本对应关系

6. 注意事项

• 版本匹配：需使用与Kubernetes集群版本兼容的pause镜像，不匹配可能导致网络共享失败
• 镜像拉取：无法直接访问registry.k8s.io时，需通过私有仓库同步或配置镜像代理
• 禁止手动干预：Kubernetes Pod中的pause容器由kubelet管理，手动停止/删除会导致Pod异常重建
• 资源配置：无需为pause容器设置资源限制（CPU/内存），其资源占用可忽略不计