openebs/mayastor-upgrade-job

Mayastor 升级任务镜像

概述

Mayastor 升级任务镜像是专为Mayastor云原生存储系统设计的专用工具镜像，用于自动化或手动执行Mayastor集群的版本升级操作。该镜像封装了升级所需的核心逻辑与依赖组件，旨在简化升级流程，确保从旧版本平滑过渡至目标版本，同时保障升级过程中的数据安全与服务可用性。

核心功能

• 集群升级执行：支持Mayastor控制平面与数据平面组件的有序升级
• 版本兼容性校验：内置版本检查机制，验证目标版本与当前环境的兼容性
• 数据一致性保障：在升级过程中维护存储数据的完整性与一致性
• 升级状态监控：提供实时升级进度反馈与状态报告
• 故障恢复支持：集成基础的升级失败检测与恢复建议（部分版本支持自动回滚）

使用场景

• Mayastor集群的日常版本更新与维护
• 生产环境中Mayastor从旧版本迁移至新版本
• 需要标准化升级流程的企业级部署场景
• 自动化运维流水线中的Mayastor升级环节

使用方法

基本使用流程

1. 准备Mayastor集群的访问凭证与目标版本信息
2. 配置升级参数（通过环境变量或配置文件）
3. 运行升级任务镜像执行升级操作
4. 监控升级进度与结果

Docker 运行示例

bash
docker run --rm \
  -e TARGET_VERSION="v2.5.0" \
  -e MAYASTOR_NAMESPACE="mayastor" \
  -e KUBECONFIG="/kubeconfig" \
  -v /path/to/kubeconfig:/kubeconfig \
  docker.xuanyuan.run/mayastor-upgrade-job:latest

Kubernetes Job 部署示例

yaml
apiVersion: batch/v1
kind: Job
metadata:
  name: mayastor-upgrade
  namespace: mayastor
spec:
  template:
    spec:
      serviceAccountName: mayastor-upgrade-sa
      containers:
      - name: upgrade-executor
        image: docker.xuanyuan.run/mayastor-upgrade-job:latest
        env:
        - name: TARGET_VERSION
          value: "v2.5.0"
        - name: MAYASTOR_NAMESPACE
          value: "mayastor"
        - name: LOG_LEVEL
          value: "info"
      restartPolicy: Never
  backoffLimit: 1

配置参数说明

注意事项

• 升级前需确保Mayastor集群处于健康状态（所有卷状态正常、无故障副本）
• 建议在业务低峰期执行升级操作，减少对业务的影响
• 首次使用建议在测试环境验证升级流程，确认兼容性
• 升级过程中避免同时执行其他存储维护操作（如扩容、迁移）
• 生产环境升级前建议备份关键数据或配置

版本兼容性

该镜像需与目标升级版本匹配使用，具体版本对应关系请参考Mayastor官方发布说明。通常建议使用与目标版本相同系列的升级镜像（如升级至v2.5.0使用v2.5.x系列的升级镜像）。