k8s.gcr.io/kube-controller-manager-amd64 镜像文档

镜像概述

k8s.gcr.io/kube-controller-manager-amd64 是 Kubernetes 控制平面的核心组件镜像，提供适用于 AMD64 架构的 kube-controller-manager 可执行文件。该组件负责运行集群级别的控制器进程，通过持续监控集群状态并调整系统行为，确保集群实际状态与用户期望状态一致，是维持 Kubernetes 集群稳定运行的关键组件。

核心功能和特性

主要控制器功能

kube-controller-manager 集成多种控制器，核心功能包括：

• 节点控制器（Node Controller）：监控节点健康状态，标记故障节点并触发节点驱逐流程。
• 副本控制器（ReplicaSet Controller）：确保指定数量的 Pod 副本持续运行，自动创建/删除 Pod 以维持期望副本数。
• 端点控制器（Endpoint Controller）：管理 Service 与后端 Pod 的端点映射关系，维护 Endpoint 对象。
• 命名空间控制器（Namespace Controller）：监控命名空间生命周期，清理过期命名空间资源。
• 服务账号控制器（ServiceAccount Controller）：为新命名空间自动创建默认服务账号及密钥。
• 资源配额控制器（ResourceQuota Controller）：确保命名空间内资源使用不超过配额限制。

特性

• 高可用支持：通过 leader 选举（--leader-elect）实现多实例部署时的主节点自动切换。
• 可配置控制器集：支持通过 --controllers 参数启用/禁用特定控制器，灵活适配集群需求。
• 安全通信：支持通过 TLS 证书与 API Server、etcd 等组件加密通信，确保数据传输安全。

使用场景和适用范围

适用场景

• Kubernetes 集群控制平面部署：作为控制平面核心组件，需在每个控制平面节点运行（通常通过静态 Pod 或 systemd 服务管理）。
• 集群状态管理：适用于所有需要维持集群稳定性、保障资源按需分配的 Kubernetes 环境（包括自建集群、云厂商托管集群的控制平面自定义场景）。

架构限制

• 仅支持 AMD64 架构节点，其他架构（如 ARM64）需使用对应架构镜像（如 k8s.gcr.io/kube-controller-manager-arm64）。

使用方法和配置说明

前置依赖

• 需与 Kubernetes API Server、etcd 集群通信，确保网络可达。
• 需配置 TLS 证书（用于身份认证和加密通信），通常通过 --kubeconfig 或命令行参数指定证书路径。

Docker 运行示例

注意：实际生产环境中，kube-controller-manager 通常通过 Kubernetes 静态 Pod 或系统服务运行，以下为基础 Docker 运行示例（需替换占位符为实际环境配置）。

bash
docker run -d \
  --name kube-controller-manager \
  --network host \
  -v /etc/kubernetes/pki:/etc/kubernetes/pki \
  -v /etc/kubernetes/controller-manager.conf:/etc/kubernetes/controller-manager.conf \
  k8s.gcr.io/kube-controller-manager-amd64:v1.27.0 \
  kube-controller-manager \
    --kubeconfig=/etc/kubernetes/controller-manager.conf \
    --leader-elect=true \
    --controllers=*,bootstrapsigner,tokencleaner \
    --cluster-name=kubernetes \
    --cluster-signing-cert-file=/etc/kubernetes/pki/ca.crt \
    --cluster-signing-key-file=/etc/kubernetes/pki/ca.key \
    --root-ca-file=/etc/kubernetes/pki/ca.crt \
    --service-account-private-key-file=/etc/kubernetes/pki/sa.key

核心配置参数说明

常用环境变量

无特殊环境变量，配置主要通过命令行参数或 kubeconfig 文件传递。

注意事项

• 版本兼容性：镜像标签需与 Kubernetes 集群版本一致（如 v1.27.0 对应 Kubernetes 1.27 版本）。
• 权限要求：需挂载集群证书目录（通常 /etc/kubernetes/pki）和 kubeconfig 文件，确保容器内有读取权限。
• 网络配置：建议使用 --network host 使组件直接使用主机网络，避免网络转发延迟或端口冲突。