本文首发在个人博客上,欢迎来踩!
本次分析参考的K8s版本是v1.27.0。
K8s的整体调度框架如下图所示。
调度框架顶层函数
K8s调度器调度的核心函数schedulerone
在pkg/scheduler/schedule_one.go:62
,如下,这里将一些解释写在了注释里
// scheduleOne does the entire scheduling workflow for a single pod. It is serialized on the scheduling algorithm's host fitting.
func (sched *Scheduler) scheduleOne(ctx context.Context) {
// 获取调度队列中的下一个 Pod 信息
podInfo := sched.NextPod()
// 如果 podInfo 或者其包含的 Pod 为 nil,说明调度队列关闭或者没有 Pod 需要调度,直接返回
if podInfo == nil || podInfo.Pod == nil {
return
}
// 获取 Pod 对象
pod := podInfo.Pod
// 为当前 Pod 选择一个调度框架(scheduler framework)
fwk, err := sched.frameworkForPod(pod)
if err != nil {
// 这种情况不应该发生,因为我们只接受那些指定了匹配调度器名称的 Pod 进行调度
klog.ErrorS(err, "Error occurred")
return
}
// 如果跳过调度,则直接返回
if sched.skipPodSchedule(fwk, pod) {
return
}
// 记录尝试调度 Pod 的日志
klog.V(3).InfoS("Attempting to schedule pod", "pod", klog.KObj(pod))
// 开始计时,尝试为 Pod 找到合适的宿主机
start := time.Now()
// 初始化调度周期状态
state := framework.NewCycleState()
// 设置是否记录插件指标的随机概率
state.SetRecordPluginMetrics(rand.Intn(100) < pluginMetricsSamplePercent)
// 初始化一个空的 podsToActivate 结构,这个结构将由插件填充或者保持为空
podsToActivate := framework.NewPodsToActivate()
// 将 podsToActivate 写入状态中
state.Write(framework.PodsToActivateKey, podsToActivate)
// 创建一个新的带有取消功能的上下文,用于调度周期
schedulingCycleCtx, cancel := context.WithCancel(ctx)
defer cancel()
// 执行调度周期,尝试为 Pod 找到合适的宿主机
scheduleResult, assumedPodInfo, status := sched.schedulingCycle(schedulingCycleCtx, state, fwk, podInfo, start, podsToActivate)
// 如果调度失败,则调用失败处理器
if !status.IsSuccess() {
sched.FailureHandler(schedulingCycleCtx, fwk, assumedPodInfo, status, scheduleResult.nominatingInfo, start)
return
}
// 异步绑定 Pod 到其宿主机(可以这样做是因为上面的假设步骤)
go func() {
// 创建一个新的带有取消功能的上下文,用于绑定周期
bindingCycleCtx, cancel := context.WithCancel(ctx)
defer cancel()
// 增加绑定阶段的 goroutine 指标
metrics.SchedulerGoroutines.WithLabelValues(metrics.Binding).Inc()
defer metrics.SchedulerGoroutines.WithLabelValues(metrics.Binding).Dec()
metrics.Goroutines.WithLabelValues(metrics.Binding).Inc()
defer metrics.Goroutines.WithLabelValues(metrics.Binding).Dec()
// 执行绑定周期,尝试将 Pod 绑定到宿主机
status := sched.bindingCycle(bindingCycleCtx, state, fwk, scheduleResult, assumedPodInfo, start, podsToActivate)
// 如果绑定失败,则处理绑定周期错误
if !status.IsSuccess() {
sched.handleBindingCycleError(bindingCycleCtx, state, fwk, assumedPodInfo, start, scheduleResult, status)
}
}()
}
这段代码的主要功能是:
- 从调度队列中获取下一个要调度的 Pod。
- 为 Pod 选择一个调度框架。
- 如果配置允许,跳过调度。
- 记录日志并开始调度周期。
- 如果调度成功,异步地尝试将 Pod 绑定到选定的宿主机。
- 如果调度或绑定失败,执行相应的错误处理逻辑。
此处也指明了两个周期,分别为调度周期schedulingCycle
和绑定周期bindingCycle
,绑定周期会在后面一节进行介绍,这里主要关注schedulingCycle
。
查看关键的schedulingCycle
函数,在pkg/scheduler/schedule_one.go:120
中,补充了部分注释。
// schedulingCycle tries to schedule a single Pod.
func (sched *Scheduler) schedulingCycle(
ctx context.Context, // 调度上下文
state *framework.CycleState, // 调度周期状态
fwk framework.Framework, // 调度框架
podInfo *framework.QueuedPodInfo, // 待调度的 Pod 信息
start time.Time, // 调度开始时间
podsToActivate *framework.PodsToActivate, // 待激活的 Pods
) (ScheduleResult, *framework.QueuedPodInfo, *framework.Status) {
// 获取待调度的 Pod
pod := podInfo.Pod
// 调用调度器的 SchedulePod 方法尝试调度 Pod
scheduleResult, err := sched.SchedulePod(ctx, fwk, state, pod)
if err != nil {
// 如果没有可用节点,则返回错误状态
if err == ErrNoNodesAvailable {
status := framework.NewStatus(framework.UnschedulableAndUnresolvable).WithError(err)
return ScheduleResult{
nominatingInfo: clearNominatedNode}, podInfo, status
}
// 如果错误是 FitError 类型,则说明 Pod 无法适应任何节点
fitError, ok := err.(*framework.FitError)
if !ok {
klog.ErrorS(err, "Error selecting node for pod", "pod", klog.KObj(pod))
return ScheduleResult{
nominatingInfo: clearNominatedNode}, podInfo, framework.AsStatus(err)
}
// 如果没有 PostFilter 插件,则不执行抢占
if !fwk.HasPostFilterPlugins() {
klog.V(3).InfoS("No PostFilter plugins are registered, so no preemption will be performed")
return ScheduleResult{
}, podInfo, framework.NewStatus(framework.Unschedulable).WithError(err)
}
// 运行 PostFilter 插件,尝试使 Pod 在未来的调度周期中可调度
result, status := fwk.RunPostFilterPlugins(ctx, state, pod, fitError.Diagnosis.NodeToStatusMap)
msg := status.Message()
fitError.Diagnosis.PostFilterMsg = msg
if status.Code() == framework.Error {
klog.ErrorS(nil, "Status after running PostFilter plugins for pod", "pod", klog.KObj(pod), "status", msg)
} else {
klog.V(5).InfoS("Status after running PostFilter plugins for pod", "pod", klog.KObj(pod), "status", msg)
}
// 获取 PostFilter 插件返回的 NominatingInfo
var nominatingInfo *framework.NominatingInfo
if result != nil {
nominatingInfo = result.NominatingInfo
}
return ScheduleResult{
nominatingInfo: nominatingInfo}, podInfo, framework.NewStatus(framework.Unschedulable).WithError(err)
}
// 计算并记录调度算法的延迟
metrics.SchedulingAlgorithmLatency.Observe(metrics.SinceInSeconds(start))
// 假设 Pod 已经在给定节点上运行,这样子就不用等它实际绑定就可以执行后续的操作了
assumedPodInfo := podInfo.DeepCopy()
assumedPod := assumedPodInfo.Pod
// 假设操作,设置 Pod 的 NodeName 为调度结果推荐的宿主机
err = sched.assume(assumedPod, scheduleResult.SuggestedHost)
if err != nil {
// 如果假设操作失败,这可能是重试逻辑中的一个 BUG
// 报告错误以便重新调度 Pod
return ScheduleResult{
nominatingInfo: clearNominatedNode},
assumedPodInfo,
framework.AsStatus(err)
}
// 运行预留插件的 Reserve 方法
if sts := fwk.RunReservePluginsReserve(ctx, state, assumedPod, scheduleResult.SuggestedHost); !sts.IsSuccess() {
// 如果预留失败,触发取消预留以清理与预留 Pod 相关的资源
fwk.RunReservePluginsUnreserve(ctx, state, assumedPod, scheduleResult.SuggestedHost)
if forgetErr := sched.Cache.ForgetPod(assumedPod); forgetErr != nil {
klog.ErrorS(forgetErr, "Scheduler cache ForgetPod failed")
}
return ScheduleResult{
nominatingInfo: clearNominatedNode},
assumedPodInfo,
sts
}
// 运行 "permit" 插件
runPermitStatus := fwk.RunPermitPlugins(ctx, state, assumedPod, scheduleResult.SuggestedHost)
if !runPermitStatus.IsWait() && !runPermitStatus.IsSuccess() {
// 如果许可检查失败,触发取消预留以清理与预留 Pod 相关的资源
fwk.RunReservePluginsUnreserve(ctx, state, assumedPod, scheduleResult.SuggestedHost)
if forgetErr := sched.Cache.ForgetPod(assumedPod); forgetErr != nil {
klog.ErrorS(forgetErr, "Scheduler cache ForgetPod failed")
}
return ScheduleResult{
nominatingInfo: clearNominatedNode},
assumedPodInfo,
runPermitStatus
}
// 成功调度周期结束后,查看是否有必要设置一些pod为可调度的状态
if len(podsToActivate.Map) != 0 {
sched.SchedulingQueue.Activate(podsToActivate.Map)
// 激活后清空条目
podsToActivate.Map = make(map[string]*v1.Pod)
}
// 返回调度结果
return scheduleResult, assumedPodInfo, nil
}
主要流程包括:
- 尝试调度 Pod,并处理可能出现的错误。
- 如果调度失败,根据错误类型执行不同的逻辑,如处理节点不可用或 Pod 不适应任何节点的情况。
- 如果调度成功,记录调度算法的延迟,并提前假设 Pod 已经在推荐的节点上运行。
- 运行预留插件的 Reserve 方法,并处理预留成功或失败的情况。
- 运行抢占插件,并根据结果进行相应的处理。
- 如果有待转为active的 Pods,执行激活操作。
- 返回调度结果。
一般调度
这里最关键的是SchedulePod
函数,在pkg/scheduler/schedule_one.go:334
中
// schedulePod tries to schedule the given pod to one of the nodes in the node list.
// If it succeeds, it will return the name of the node.
// If it fails, it will return a FitError with reasons.
func (sched *Scheduler) schedulePod(ctx context.Context, fwk framework.Framework, state *framework.CycleState, pod *v1.Pod) (result ScheduleResult, err error) {
trace := utiltrace.New("Scheduling", utiltrace.Field{
Key: "namespace", Value: pod.Namespace}, utiltrace.Field{
Key: "name", Value: pod.Name})
defer trace.LogIfLong(100 * time.Millisecond)
if err := sched.Cache.UpdateSnapshot(sched.nodeInfoSnapshot); err != nil {
return result, err
}
trace.Step("Snapshotting scheduler cache and node infos done")
if sched.nodeInfoSnapshot.NumNodes() == 0 {
return result, ErrNoNodesAvailable
}
feasibleNodes, diagnosis, err := sched.findNodesThatFitPod(ctx, fwk, state, pod)
if err != nil {
return result, err
}
trace.Step("Computing predicates done")
if len(feasibleNodes) == 0 {
return result, &framework.