portworx/maas-resource-manager-migrations

资源管理器迁移镜像（Resource Manager Migrations Image）

1. 镜像概述

资源管理器迁移镜像是一款专为资源管理器迁移设计的工具镜像，旨在简化资源管理器（如配置管理平台、服务注册中心等）的配置、数据及关联依赖项在不同环境（如开发、测试、生产）或不同版本间的迁移过程。通过集成自动化迁移脚本与校验机制，该镜像可有效降低手动迁移成本，减少迁移风险，确保迁移过程平滑、高效且数据一致。

2. 核心功能与特性

2.1 核心功能

• 自动化迁移流程：支持一键式迁移，自动完成源环境数据采集、目标环境适配、数据导入及依赖项同步。
• 跨环境/版本适配：内置多版本资源管理器配置解析器，支持主流资源管理器（如HashiCorp Consul、etcd等）的跨版本迁移。
• 配置检测与修复：迁移前自动检测源配置与目标环境兼容性，对不兼容项提供修复建议或自动适配。
• 数据完整性校验：迁移后执行数据一致性校验（如配置项数量、关键字段匹配度等），生成校验报告。
• 迁移日志与回滚：全程记录迁移日志，支持异常场景下的迁移回滚，保障数据安全。

2.2 特性

• 轻量级设计：基于Alpine Linux构建，镜像体积小，启动速度快。
• 无侵入式迁移：无需修改源/目标资源管理器核心组件，通过API或客户端工具实现数据交互。
• 可扩展插件系统：支持通过自定义插件扩展迁移能力，适配特定业务场景的资源迁移需求。

3. 使用场景与适用范围

3.1 典型使用场景

• 资源管理器版本升级：如从Consul 1.9.x迁移至1.15.x，自动处理配置格式变更与数据结构调整。
• 跨环境迁移：将开发环境的资源管理器配置与数据迁移至测试或生产环境，确保环境一致性。
• 跨平台迁移：如从自建资源管理器迁移至云托管服务（如AWS Cloud Map、阿里云服务注册中心）。
• 灾备环境构建：快速复制生产环境资源管理器数据至灾备环境，缩短灾备部署周期。

3.2 适用范围

• 支持的资源管理器类型：HashiCorp Consul、etcd、Apache ZooKeeper（基础配置）、Kubernetes ConfigMap/Secret（通过API适配）。
• 支持的环境：物理机、虚拟机、容器化环境（Docker、Kubernetes）、云环境（AWS、Azure、阿里云等）。

4. 使用方法与配置说明

4.1 前置条件

• 源资源管理器与目标资源管理器网络互通，且已开放API访问端口（如Consul默认8500端口）。
• 源/目标资源管理器访问凭证（如Token、用户名密码）已准备，且具备读写权限。
• 宿主机已安装Docker Engine（20.10+）或Docker Compose（2.0+）。

4.2 快速启动（Docker Run）

基本迁移命令

bash
docker run -it --rm \
  -e SOURCE_TYPE=consul \
  -e SOURCE_ADDR=http://source-consul:8500 \
  -e SOURCE_TOKEN=source-access-token \
  -e TARGET_TYPE=consul \
  -e TARGET_ADDR=http://target-consul:8500 \
  -e TARGET_TOKEN=target-access-token \
  resource-manager-migrations:latest migrate

参数说明

4.3 迁移流程

1. 环境准备：配置源/目标资源管理器访问参数，确保网络与权限正常。
2. 启动迁移：执行上述docker run命令，镜像自动启动迁移流程。
3. 迁移校验：迁移完成后，镜像自动执行数据校验，输出校验结果（成功/失败及原因）。
4. 查看报告：校验通过后，可通过docker logs <container-id>查看详细迁移日志与报告路径（如挂载了本地目录，报告将保存至挂载路径）。

4.4 高级配置（挂载自定义插件/配置）

如需使用自定义迁移插件或配置文件，可通过挂载本地目录实现：

bash
docker run -it --rm \
  -v /local/plugins:/app/plugins \  # 挂载自定义插件目录
  -v /local/config:/app/config \    # 挂载自定义配置文件
  -e SOURCE_TYPE=consul \
  -e SOURCE_ADDR=http://source-consul:8500 \
  -e TARGET_TYPE=consul \
  -e TARGET_ADDR=http://target-consul:8500 \
  -e PLUGINS_DIR=/app/plugins \     # 指定插件目录
  resource-manager-migrations:latest migrate

5. 注意事项

• 迁移前建议备份源/目标资源管理器数据，避免不可逆数据变更。
• 对于大规模数据迁移（如10万+配置项），建议通过MIGRATE_BATCH_SIZE环境变量（默认1000）调整批次大小，避免网络拥堵。
• 迁移过程中需确保源资源管理器处于只读状态（或暂停写入），防止迁移期间数据变更导致不一致。
• 不支持跨架构（如x86至ARM）的直接迁移，需在目标架构环境中运行镜像。