// pkg/kubelet/kubelet.go
func (kl *Kubelet) syncLoop(
    ctx context.Context,
    updates <-chan kubetypes.PodUpdate,  // Pod 更新通道
    handler SyncHandler,                  // 同步处理器
) {
    for {
        // 检查运行时错误，如有则指数退避
        if err := kl.runtimeState.runtimeErrors(); err != nil {
            time.Sleep(duration)
            continue
        }
        
        // 监听多个通道，哪个有数据就处理哪个
        kl.syncLoopIteration(ctx, updates, handler,
            syncTicker.C, housekeepingTicker.C, plegCh)
    }
}

// pkg/kubelet/kubelet.go
func (kl *Kubelet) syncLoopIteration(
    ctx context.Context,
    configCh <-chan kubetypes.PodUpdate,  // 配置变更通道
    handler SyncHandler,
    syncCh <-chan time.Time,              // 定期同步通道
    housekeepingCh <-chan time.Time,      // 清理通道
    plegCh <-chan *pleg.PodLifecycleEvent, // Pod 生命周期事件通道
) bool {
    select {
    case u, open := <-configCh:
        // 处理 Pod 配置变更（添加/更新/删除/调和）
        // PodUpdate 只有三个字段：Pods []*v1.Pod、Op、Source
        switch u.Op {
        case kubetypes.ADD:
            handler.HandlePodAdditions(ctx, u.Pods)
        case kubetypes.UPDATE:
            handler.HandlePodUpdates(ctx, u.Pods)
        case kubetypes.REMOVE:
            handler.HandlePodRemoves(ctx, u.Pods)
        case kubetypes.RECONCILE:
            handler.HandlePodReconcile(ctx, u.Pods)
        }
    case <-syncCh:
        // 定期同步所有待同步的 Pod
        podsToSync := kl.getPodsToSync()
        handler.HandlePodSyncs(ctx, podsToSync)
    case <-housekeepingCh:
        // 清理已终止的 Pod、孤立的 Volume 和 Pod 目录等
        handler.HandlePodCleanups(ctx)
    case e := <-plegCh:
        // Pod 生命周期事件（容器启动/停止），同步对应的 Pod
        if pod, ok := kl.podManager.GetPodByUID(e.ID); ok {
            handler.HandlePodSyncs(ctx, []*v1.Pod{pod})
        }
    }
}

// pkg/kubelet/pod_workers.go
type podWorkers struct {
    podLock    sync.Mutex
    podsSynced bool  // 所有工作中的 Pod 至少同步过一次后置为 true

    // 每个 Pod 一个更新通道，向通道发信号通知对应 goroutine 消费更新
    podUpdates map[types.UID]chan struct{}
    // 按 UID 跟踪 Pod 的同步状态（syncing / terminating / terminated / evicted）
    podSyncStatuses map[types.UID]*podSyncStatus

    workQueue queue.WorkQueue
    podSyncer podSyncer  // 实际执行同步的接口，由 Kubelet 实现
}

// 更新 Pod（异步执行，不阻塞调用方）
func (p *podWorkers) UpdatePod(ctx context.Context, options UpdatePodOptions) {
    p.podLock.Lock()
    // 将更新写入该 Pod 的 podSyncStatus.pendingUpdate，
    // 并向 podUpdates[uid] 通道发信号（goroutine 不存在则创建）
    p.podLock.Unlock()
}

// 每个 Pod 的 goroutine 串行消费更新，按 kubetypes.SyncPodType 分类：
//   SyncPodCreate / SyncPodUpdate / SyncPodSync / SyncPodKill
func (p *podWorkers) podWorkerLoop(uid types.UID) {
    for range podUpdatesCh {
        // 根据 podSyncStatus 状态机，调用 podSyncer 对应方法：
        switch {
        case 需要创建或更新:
            p.podSyncer.SyncPod(ctx, updateType, pod, mirrorPod, podStatus)
        case 需要终止:
            p.podSyncer.SyncTerminatingPod(...)  // 停止容器
        case 已终止:
            p.podSyncer.SyncTerminatedPod(...)   // 清理资源
        }
    }
}

// pkg/kubelet/container/runtime.go —— kubelet 内部运行时层
type State string

const (
    ContainerStateCreated State = "created" // 已创建但未启动
    ContainerStateRunning State = "running"
    ContainerStateExited  State = "exited"
    ContainerStateUnknown State = "unknown" // restarting、paused、dead 等
)

// staging/src/k8s.io/api/core/v1/types.go —— API 层
// Waiting/Running/Terminated 是 v1.ContainerState 结构体的字段（互斥指针）：
type ContainerState struct {
    Waiting    *ContainerStateWaiting
    Running    *ContainerStateRunning
    Terminated *ContainerStateTerminated
}

// k8s.io/cri-api/pkg/apis/runtime/v1/api.proto
service RuntimeService {
    rpc RunPodSandbox(RunPodSandboxRequest) returns (RunPodSandboxResponse);
    rpc StopPodSandbox(StopPodSandboxRequest) returns (StopPodSandboxResponse);
    rpc RemovePodSandbox(RemovePodSandboxRequest) returns (RemovePodSandboxResponse);
    rpc CreateContainer(CreateContainerRequest) returns (CreateContainerResponse);
    rpc StartContainer(StartContainerRequest) returns (StartContainerResponse);
    rpc StopContainer(StopContainerRequest) returns (StopContainerResponse);
    rpc RemoveContainer(RemoveContainerRequest) returns (RemoveContainerResponse);
    rpc ListContainers(ListContainersRequest) returns (ListContainersResponse);
    rpc ContainerStatus(ContainerStatusRequest) returns (ContainerStatusResponse);
    rpc ExecSync(ExecSyncRequest) returns (ExecSyncResponse);
    rpc Attach(AttachRequest) returns (AttachResponse);
    rpc PortForward(PortForwardRequest) returns (PortForwardResponse);
    rpc UpdateContainerResources(UpdateContainerResourcesRequest) returns (UpdateContainerResourcesResponse);
}

// pkg/kubelet/kuberuntime/kuberuntime_container.go
// Pod Sandbox（Pause 容器）已在 SyncPod 流程中先行创建，这里不再创建
func (m *kubeGenericRuntimeManager) startContainer(
    ctx context.Context,
    podSandboxID string,
    podSandboxConfig *runtimeapi.PodSandboxConfig,
    spec *startSpec,
    pod *v1.Pod,
    podStatus *kubecontainer.PodStatus,
    pullSecrets []v1.Secret,
    podIP string, podIPs []string,
    imageVolumes kubecontainer.ImageVolumes,
) (string, error) {
    // 1. 确保镜像存在（不存在则拉取）
    imageRef, msg, err := m.imagePuller.EnsureImageExists(
        ctx, ref, pod, container.Image, pullSecrets, podSandboxConfig, ...)
    
    // 2. 生成容器配置并创建容器
    containerConfig, cleanupAction, err := m.generateContainerConfig(...)
    containerID, err := m.runtimeService.CreateContainer(
        ctx, podSandboxID, containerConfig, podSandboxConfig)
    
    // 3. 启动容器
    err = m.runtimeService.StartContainer(ctx, containerID)
    
    // 4. 执行 PostStart 钩子（失败则杀死容器）
    if container.Lifecycle != nil && container.Lifecycle.PostStart != nil {
        m.runner.Run(ctx, kubeContainerID, pod, container, container.Lifecycle.PostStart)
    }
    
    return "", nil
}

// pkg/kubelet/cm/container_manager.go
type ContainerManager interface {
    Start(context.Context, *v1.Node, ActivePodsFunc, GetNodeFunc,
        config.SourcesReady, status.PodStatusProvider,
        internalapi.RuntimeService, bool) error
    SystemCgroupsLimit() v1.ResourceList
    GetNodeConfig() NodeConfig
    GetResources(ctx context.Context, pod *v1.Pod, container *v1.Container) (*kubecontainer.RunContainerOptions, error)
    UpdateQOSCgroups(logger klog.Logger) error
}

// pkg/kubelet/cm/cgroup_manager_linux.go
// 公共部分抽为 cgroupCommon，cgroup v1/v2 各有具体实现
type cgroupCommon struct {
    subsystems *CgroupSubsystems // 节点上已挂载的 cgroup 子系统
    useSystemd bool              // 是否使用 systemd cgroup 驱动
}

var _ CgroupManager = &cgroupV1impl{}
var _ CgroupManager = &cgroupV2impl{}

func (m *cgroupV1impl) Create(logger klog.Logger, config *CgroupConfig) error {
    // 创建 cgroup 目录
    // 设置资源限制：cpu.shares、memory.limit_in_bytes 等
    // （v2 实现对应 cpu.weight、memory.max 等）
    return nil
}

// pkg/kubelet/cm/cpumanager/policy_static.go
func (p *staticPolicy) Allocate(logger klog.Logger, s state.State,
    pod *v1.Pod, container *v1.Container, operation lifecycle.Operation) error {
    // 为 Guaranteed Pod 的容器分配独占 CPU 核（目前仅支持 Add 操作）
    // 另有 AllocatePod(logger, s, pod, operation) 处理 Pod 级资源分配
    return p.allocateForAdd(logger, s, pod, container)
}

// pkg/kubelet/cm/devicemanager/types.go
type Manager interface {
    Start(logger klog.Logger, activePods ActivePodsFunc, sourcesReady config.SourcesReady, ...) error
    Allocate(ctx context.Context, pod *v1.Pod, container *v1.Container, operation lifecycle.Operation) error
    UpdatePluginResources(node *schedulerframework.NodeInfo, attrs *lifecycle.PodAdmitAttributes) error
    GetDevices(podUID, containerName string) ResourceDeviceInstances
}

// pkg/kubelet/prober/prober_manager.go（probeType 是小写未导出类型）
type probeType int

const (
    liveness probeType = iota
    readiness
    startup
)

// pkg/kubelet/prober/prober.go
func (pb *prober) probe(ctx context.Context, probeType probeType, pod *v1.Pod,
    status v1.PodStatus, container v1.Container, containerID kubecontainer.ContainerID,
) (results.Result, error) {
    // v1.Probe 内嵌 ProbeHandler（Exec/HTTPGet/TCPSocket/GRPC 指针字段），
    // 没有 Type 字段，通过判断哪个字段非 nil 来选择探测方式
    switch probeSpec := getProbeSpec(container, probeType); {
    case probeSpec.Exec != nil:
        return pb.exec.Probe(...)
    case probeSpec.HTTPGet != nil:
        return pb.http.Probe(...)
    case probeSpec.TCPSocket != nil:
        return pb.tcp.Probe(...)
    case probeSpec.GRPC != nil:
        return pb.grpc.Probe(...)
    }
}

// pkg/kubelet/prober/worker.go
func (w *worker) run(ctx context.Context) {
    // 用探针配置的 PeriodSeconds 构造 ticker（worker 没有 ProbeInterval 字段）
    probeTicker := time.NewTicker(time.Duration(w.spec.PeriodSeconds) * time.Second)

    for w.doProbe(ctx) {
        select {
        case <-w.stopCh:
            return
        case <-probeTicker.C:
            // 到点继续下一次探测
        }
    }
}

// doProbe 执行一次探测，只把结果写入 resultsManager，从不直接杀死容器
func (w *worker) doProbe(ctx context.Context) (keepGoing bool) {
    result, err := w.probeManager.prober.probe(
        ctx, w.probeType, w.pod, status, w.container, w.containerID)
    w.resultsManager.Set(w.containerID, result, w.pod)
    // 结果由 syncLoopIteration 消费 kl.livenessManager.Updates() 等通道，
    // 触发 handler.HandlePodSyncs，在后续 SyncPod 流程中间接杀死并重建失败的容器
    return true
}

// pkg/kubelet/volumemanager/volume_manager.go
func (vm *volumeManager) WaitForAttachAndMount(pod *v1.Pod) error {
    for _, volume := range pod.Spec.Volumes {
        // 1. 等待 Volume 由 Controller 完成 Attach（如 EBS）
        err := volumePlugin.WaitForAttach(volume, pod)
        
        // 2. 挂载 Volume 到节点
        err = volumePlugin.MountDevice(volume, pod)
        
        // 3. 挂载到 Pod 目录
        err = volumePlugin.SetUp(volume, pod)
    }
    return nil
}

// pkg/kubelet/eviction/api/types.go
type Threshold struct {
    Signal      Signal            // memory.available、nodefs.inodesFree 等
    Operator    ThresholdOperator // 目前只有 OpLessThan
    Value       ThresholdValue    // 二选一：Quantity *resource.Quantity 或 Percentage float32
    GracePeriod time.Duration
    MinReclaim  *ThresholdValue   // 触发阈值后至少回收的资源量
}

type Signal string

const (
    SignalMemoryAvailable   Signal = "memory.available"
    SignalNodeFsAvailable   Signal = "nodefs.available"
    SignalNodeFsInodesFree  Signal = "nodefs.inodesFree"
    SignalImageFsAvailable  Signal = "imagefs.available"
    SignalImageFsInodesFree Signal = "imagefs.inodesFree"
    SignalPIDAvailable      Signal = "pid.available"
)

// pkg/kubelet/eviction/eviction_manager.go
func (m *managerImpl) Start(ctx context.Context, diskInfoProvider DiskInfoProvider,
    podFunc ActivePodsFunc, podCleanedUpFunc PodCleanedUpFunc,
    monitoringInterval time.Duration) {
    go func() {
        for {
            // 1. 核心循环：采集节点摘要、判定阈值、必要时驱逐
            evictedPods, err := m.synchronize(ctx, diskInfoProvider, podFunc)

            if evictedPods != nil && err == nil {
                // 2. 每个监控周期最多驱逐 1 个 Pod，
                //    驱逐后阻塞等待其清理完成再进入下一周期
                m.waitForPodsCleanup(logger, podCleanedUpFunc, evictedPods)
            } else {
                time.Sleep(monitoringInterval)
            }
        }
    }()
}

// synchronize 内部：先尝试回收节点级资源（镜像/容器 GC），
// 压力仍未缓解时按信号对应的排序函数（rankMemoryPressure 等）
// 对活跃 Pod 排序，驱逐排名第一的 Pod 后立即返回

// pkg/kubelet/kubelet_node_status.go
// 周期性循环在外层 syncNodeStatus 中，每次调用带重试的 updateNodeStatus
func (kl *Kubelet) updateNodeStatus(ctx context.Context) error {
    for i := 0; i < nodeStatusUpdateRetry; i++ {
        if err := kl.tryUpdateNodeStatus(ctx, i); err != nil {
            // 失败则重试
        } else {
            return nil
        }
    }
    return fmt.Errorf("update node status exceeds retry count")
}

// tryUpdateNodeStatus 内部经 setNodeStatus 填充节点条件：
//   Ready / MemoryPressure / DiskPressure / PIDPressure / NetworkUnavailable
// 其中三种压力条件来自 eviction manager 的
// IsUnderMemoryPressure() / IsUnderDiskPressure() / IsUnderPIDPressure()，
// 最后调用 API Server 的 UpdateStatus 上报

// pkg/kubelet/kubelet_pods.go
func (kl *Kubelet) HandlePodCleanups(ctx context.Context) error {
    // 1. 对比期望与实际集合，停止已终止 Pod 的 worker
    workingPods := kl.podWorkers.SyncKnownPods(logger, allPods)

    // 2. 停止不再运行的 Pod 的探针
    kl.probeManager.CleanupPods(possiblyRunningPods)

    // 3. 清理孤立的 Pod 状态
    kl.removeOrphanedPodStatuses(logger, allPods, mirrorPods)

    // 4. 清理孤立的 Pod 数据目录和 Volume
    kl.cleanupOrphanedPodDirs(logger, allPods, runningRuntimePods)

    // 5. 删除孤立的 mirror Pod、终止残留的孤儿容器等
}

// pkg/kubelet/container/container_gc.go
type GCPolicy struct {
    MinAge             time.Duration // 容器可被回收的最小存在时间
    MaxPerPodContainer int           // 每个 Pod（UID+容器名）最多保留的已退出容器数
    MaxContainers      int           // 全节点最多保留的已退出容器总数
}

// pkg/kubelet/images/image_manager.go
func (m *imageManager) EnsureImageExists(
    ctx context.Context,
    objRef *v1.ObjectReference,
    pod *v1.Pod,
    requestedImage string,
    pullSecrets []v1.Secret,
    podSandboxConfig *runtimeapi.PodSandboxConfig,
    podRuntimeHandler string,
    pullPolicy v1.PullPolicy,
) (imageRef, message string, err error) {
    // 1. 通过 CRI ImageStatus 检查镜像是否已存在（不存在本地 imageCache）
    // 2. 按 pullPolicy（Always/IfNotPresent/Never）决定是否需要拉取
    // 3. 需要拉取时解析凭据并调用 CRI PullImage
    return imageRef, message, nil
}

// pkg/kubelet/images/image_gc_manager.go
func (im *realImageGCManager) GarbageCollect(ctx context.Context, beganGC time.Time) error {
    // 1. 按最近使用时间对镜像排序（最久未用的在前）
    images, err := im.imagesInEvictionOrder(ctx, freeTime)

    // 2. 获取镜像文件系统的磁盘使用率
    fsStats, _, err := im.statsProvider.ImageFsStats(ctx)

    // 3. 使用率高于 HighThresholdPercent 时，从旧到新删除未使用的镜像，
    //    直到使用率降到 LowThresholdPercent
    if usagePercent >= im.policy.HighThresholdPercent {
        im.freeSpace(ctx, amountToFree, freeTime, images)
    }
    return nil
}