Cedana helper 镜像文档

概述

Cedana helper是Cedana生态系统中的关键组件，专门设计用于在Kubernetes集群中提供检查点/恢复(c/r)功能的基础设施支持。它以DaemonSet控制器模式部署，确保在集群中的每个节点上都运行一个实例，从而能够在节点级别为工作负载提供低延迟的检查点和恢复操作支持。

核心功能特性

• DaemonSet部署模式：通过Kubernetes DaemonSet控制器确保在集群所有节点（或指定节点）上运行，提供全集群覆盖的c/r能力
• 检查点/恢复(c/r)支持：直接在节点本地执行工作负载的检查点创建和恢复操作，支持容器级别的状态持久化
• 与Cedana控制平面集成：接收来自Cedana控制平面的指令，协调c/r流程的执行与状态上报，实现集群级c/r任务管理
• 资源管理优化：内置检查点文件的生命周期管理，支持自动清理过期文件，避免节点存储资源耗尽

使用场景与适用范围

• Kubernetes工作负载高可用性保障：通过定期创建检查点，实现工作负载故障时的快速恢复，减少业务中断时间
• 工作负载迁移场景：支持跨节点、跨集群迁移工作负载，通过检查点导出与恢复实现无状态迁移
• 故障恢复与容灾：在节点故障或工作负载异常时，利用预存检查点快速恢复服务状态，提升集群容错能力
• 资源弹性调度：配合集群资源调度策略，可通过暂停-恢复机制临时释放资源，实现资源动态优化

使用方法与配置说明

部署方式

Cedana helper需以DaemonSet方式部署在Kubernetes集群中，典型部署流程如下：

1. 准备命名空间（可选）

kubectl create namespace cedana-system

2. 部署DaemonSet资源

创建cedana-helper-daemonset.yaml文件，内容示例如下：

apiVersion: apps/v1
kind: DaemonSet
metadata:
  name: cedana-helper
  namespace: cedana-system
spec:
  selector:
    matchLabels:
      app: cedana-helper
  template:
    metadata:
      labels:
        app: cedana-helper
    spec:
      hostPID: true  # 需要访问主机PID命名空间以支持容器状态捕获
      containers:
      - name: cedana-helper
        image: cedana/helper:latest  # 替换为实际镜像标签
        resources:
          requests:
            cpu: 100m
            memory: 256Mi
          limits:
            cpu: 500m
            memory: 512Mi
        env:
        - name: CEDANA_CONTROL_PLANE_URL
          value: "[***]"  # Cedana控制平面服务地址
        - name: CHECKPOINT_STORAGE_PATH
          value: "/var/lib/cedana/checkpoints"  # 检查点文件存储路径
        - name: LOG_LEVEL
          value: "info"  # 日志级别：debug/info/warn/error
        volumeMounts:
        - name: checkpoint-storage
          mountPath: /var/lib/cedana/checkpoints
        - name: host-root
          mountPath: /host
          readOnly: true  # 只读挂载主机根文件系统，用于访问容器运行时信息
      volumes:
      - name: checkpoint-storage
        hostPath:
          path: /var/lib/cedana/checkpoints
          type: DirectoryOrCreate  # 自动创建目录（若不存在）
      - name: host-root
        hostPath:
          path: /

3. 应用部署配置

kubectl apply -f cedana-helper-daemonset.yaml

关键配置参数说明

验证部署状态

部署完成后，可通过以下命令验证Pod运行状态：

kubectl get pods -n cedana-system -l app=cedana-helper

预期输出示例：

NAME                  READY   STATUS    RESTARTS   AGE
cedana-helper-2x4f8   1/1     Running   0          5m
cedana-helper-7b9kq   1/1     Running   0          5m
cedana-helper-pqrzd   1/1     Running   0          5m

注意事项

• 需确保集群节点已安装必要的依赖（如CRIU工具，用于容器检查点/恢复操作）
• 安全上下文配置：根据集群安全策略，可能需要调整securityContext以获取必要权限（如privileged: true）
• 存储规划：CHECKPOINT_STORAGE_PATH对应的存储路径需确保有足够磁盘空间，建议使用持久化存储或定期清理策略