kube-scheduler 镜像文档

1. 镜像概述和主要用途

本镜像为 k8s.gcr.io/kube-scheduler 选定标签的镜像，用于提供 Kubernetes 集群核心控制平面组件——kube-scheduler 的运行环境。kube-scheduler 作为 Kubernetes 的调度器，负责根据集群资源状况、Pod 资源需求、亲和性规则等因素，将未调度的 Pod 分配到合适的节点上，是保障集群资源高效利用和服务可用性的关键组件。

2. 核心功能和特性

2.1 核心调度能力

• 智能调度算法：基于优先级、资源需求、节点亲和性/反亲和性、Pod 亲和性/反亲和性等多维度规则进行调度决策。
• 资源匹配：支持根据 CPU、内存等资源需求，匹配节点可分配资源，确保 Pod 运行条件满足。
• 节点选择策略：支持节点标签选择、污点与容忍度（Taints/Tolerations）、节点亲和性规则等节点筛选机制。
• 抢占机制：当高优先级 Pod 无法调度时，可抢占低优先级 Pod 的资源。
• 扩展性：支持自定义调度策略和调度插件，满足特定业务需求。

3. 使用场景和适用范围

3.1 典型场景

• Kubernetes 集群控制平面部署：作为控制平面核心组件，与 kube-apiserver、kube-controller-manager 协同工作。
• 离线/受限环境部署：在无法直接访问 k8s.gcr.io 镜像仓库的环境中，通过本镜像获取 kube-scheduler 组件。
• 集群升级/版本一致性：需要使用特定版本 kube-scheduler 时，通过指定标签拉取对应版本镜像。

3.2 适用范围

• 所有 Kubernetes 集群环境（包括单节点集群、生产级多节点集群）。
• 需自定义调度策略或依赖调度插件的场景。
• 对集群资源利用率、Pod 部署效率有要求的业务场景。

4. 使用方法和配置说明

4.1 镜像拉取

通过以下命令拉取特定标签的镜像（将 <TAG> 替换为目标版本，如 v1.28.0）：

docker pull <镜像仓库地址>/kube-scheduler:<TAG>
# 示例：若镜像仓库为私有仓库 example.com，则命令为
# docker pull example.com/kube-scheduler:v1.28.0

4.2 Docker Run 命令示例

注意：kube-scheduler 通常作为 Kubernetes 控制平面组件由 kubelet 管理（通过 Static Pod 或 Deployment），直接使用 docker run 仅用于调试或特殊场景。

docker run -d \
  --name kube-scheduler \
  --network host \
  -v /etc/kubernetes/scheduler.conf:/etc/kubernetes/scheduler.conf \
  <镜像仓库地址>/kube-scheduler:<TAG> \
  kube-scheduler \
    --kubeconfig=/etc/kubernetes/scheduler.conf \
    --leader-elect=true \
    --scheduler-name=default-scheduler \
    --v=2

参数说明：

• --network host：使用主机网络，确保能访问 kube-apiserver。
• -v /etc/kubernetes/scheduler.conf:/etc/kubernetes/scheduler.conf：挂载 kubeconfig 文件，用于认证和连接 kube-apiserver。

4.3 Docker Compose 配置示例（调试用）

version: '3'
services:
  kube-scheduler:
    image: <镜像仓库地址>/kube-scheduler:<TAG>
    container_name: kube-scheduler
    network_mode: host
    volumes:
      - /etc/kubernetes/scheduler.conf:/etc/kubernetes/scheduler.conf
    command:
      - kube-scheduler
      - --kubeconfig=/etc/kubernetes/scheduler.conf
      - --leader-elect=true
      - --scheduler-name=default-scheduler
      - --v=2
    restart: always

4.4 核心配置参数

kube-scheduler 通过启动参数配置，常用参数如下：

4.5 环境变量

kube-scheduler 主要通过启动参数配置，环境变量使用较少，常见如下：

5. 注意事项

1. 版本匹配：镜像标签需与 Kubernetes 集群版本严格一致（如集群版本为 v1.28.0，镜像标签应为 v1.28.0），避免版本不兼容导致集群异常。
2. kubeconfig 配置：确保挂载的 kubeconfig 文件包含正确的认证信息（如证书、token），且有权限访问 kube-apiserver 的 pods、nodes 等资源。
3. 生产环境部署：生产环境中建议通过 Kubernetes Static Pod 或 Deployment 部署，由 kubelet 管理生命周期，而非直接使用 docker run 或 docker-compose。
4. 自定义调度策略：如需使用自定义调度插件或策略，需通过 --policy-config-file 指定策略配置文件，并确保镜像包含对应的插件二进制文件。