portworx/pxcentral-onprem-pre-upgrade

镜像概述和主要用途

该Docker镜像专为Px-backup 2.7.3版本设计，用于发布和执行升级前钩子（pre-upgrade-hook）的变更。升级前钩子是在Px-backup升级操作启动前执行的关键流程，负责环境检查、数据预处理及配置验证等前置任务，旨在保障从旧版本到2.7.3版本升级过程的稳定性和安全性。

核心功能和特性

• 环境兼容性检查：自动验证当前系统环境是否满足Px-backup 2.7.3的升级要求，包括依赖组件版本、操作系统兼容性等。
• 数据安全预处理：执行升级前必要的数据备份或状态保存操作，防止升级过程中数据丢失或损坏。
• 配置冲突检测：扫描现有配置文件与2.7.3版本的兼容性，识别并标记潜在的配置冲突项。
• 执行日志记录：详细记录钩子运行全过程的关键步骤、结果及异常信息，支持升级前后的问题追溯。

使用场景和适用范围

• Px-backup 2.7.3版本升级：适用于所有将Px-backup从支持的旧版本升级至2.7.3版本的场景。
• 生产环境升级保障：推荐在生产环境中使用，通过自动化前置操作减少人工干预，降低升级风险。
• 规模化部署场景：在多实例部署环境中，可通过统一镜像确保所有节点升级前准备工作的一致性。

使用方法和配置说明### 前提条件

• 已安装Docker Engine（20.10.0+版本）。
• 可访问Px-backup镜像仓库（具体地址需参考官方指引）。
• 已获取Px-backup当前环境的配置目录访问权限。

镜像拉取

bash
docker pull [镜像仓库地址]/px-backup-pre-upgrade-hook:2.7.3

注：[镜像仓库地址]需替换为实际仓库地址（如官方私有仓库或公共镜像服务地址）。

容器运行示例

bash
docker run --rm \
  --name px-pre-upgrade-2.7.3 \
  -v /opt/px-backup/config:/etc/px-backup:ro \  # 只读挂载当前配置目录
  -v /var/log/px-upgrade:/var/log/pre-upgrade:rw \  # 挂载日志输出目录
  -e TARGET_VERSION="2.7.3" \  # 目标升级版本（固定为2.7.3）
  -e ENABLE_BACKUP="true" \  # 启用数据备份（可选，默认false）
  -e RESOURCE_CHECK_TIMEOUT=300 \  # 资源检查超时时间（秒，默认300）
  [镜像仓库地址]/px-backup-pre-upgrade-hook:2.7.3

参数说明| 参数/挂载项 | 类型 | 描述 | 必填性 | 默认值 |

|---------------------------|--------------|----------------------------------------------------------------------|--------|---------------------------------| | /etc/px-backup | 目录挂载 | 挂载Px-backup当前配置目录（只读），用于兼容性检查 | 是 | - | | /var/log/pre-upgrade | 目录挂载 | 挂载日志输出目录（读写），用于存储钩子执行日志 | 否 | 容器内/var/log/pre-upgrade | | TARGET_VERSION | 环境变量 | 目标升级版本号，必须设置为2.7.3 | 是 | - | | ENABLE_BACKUP | 环境变量 | 是否启用数据备份（true/false） | 否 | false | | RESOURCE_CHECK_TIMEOUT | 环境变量 | 系统资源检查超时时间（秒） | 否 | 300 | | LOG_LEVEL | 环境变量 | 日志级别（info/warn/error/debug） | 否 | info |

执行结果验证

1. 状态检查：容器执行完成后，通过docker ps -a查看状态，Exited (0)表示执行成功，非0状态码表示存在异常。
2. 日志验证：查看挂载的日志目录下的pre-upgrade-hook.log文件，确认无ERROR级别日志。
3. 备份验证（若启用）：检查配置目录下的pre-upgrade-backup子目录，确认备份文件生成且完整。

注意事项

• 钩子执行期间需确保Px-backup服务处于正常运行状态（部分检查需访问服务接口）。
• 生产环境建议先在测试环境验证钩子执行结果，再应用于生产环境升级。
• 若执行失败，需根据日志提示修复问题后重新运行钩子，直至成功执行。