热门搜索:
acryldata/datahub-upgrade
acryldata
DataHub升级命令行工具（CLI）的Docker镜像，用于执行DataHub的升级操作。
5 次收藏下载次数: 0状态：社区镜像维护者：acryldata仓库类型：镜像最近更新：19 天前
让 AI 帮你使用轩辕镜像？ · 展开查看说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
datahub-upgrade CLI 镜像文档
一、镜像概述和主要用途
datahub-upgrade CLI 镜像是用于 DataHub 数据治理平台升级管理的命令行工具容器化封装。该镜像提供了标准化的升级流程，支持 DataHub 实例的版本检查、预升级验证、升级执行及结果确认等操作，旨在简化 DataHub 升级过程，降低手动操作风险，确保升级过程可重复、可审计。
二、核心功能和特性
核心功能
- 版本兼容性检查：自动检测当前 DataHub 实例版本与目标版本的兼容性，识别潜在冲突（如依赖组件版本、API 变更）。
- 预升级验证：执行升级前的环境检查（如数据库连接性、服务健康状态、资源充足性），输出风险评估报告。
- 升级流程自动化：按预设步骤执行升级（包括元数据迁移、配置更新、服务重启触发等），支持断点续跑。
- 回滚支持：升级失败时可触发自动回滚（需提前启用备份），恢复至升级前状态。
- 多环境适配：支持自定义配置文件，适配不同部署环境（开发、测试、生产）的升级需求。
特性
- 无状态设计：工具本身不存储持久数据，升级过程依赖外部配置（如 DataHub 服务地址、认证信息）。
- 轻量级：基于 Alpine 或 Distroless 基础镜像，镜像体积小，启动速度快。
- 日志标准化：输出 JSON 格式日志，支持集成至日志收集系统（如 ELK、Prometheus）。
三、使用场景和适用范围
典型使用场景
- DataHub 版本升级：生产/测试环境中 DataHub 实例的主版本/次版本升级（如从 v0.10.5 升级至 v0.11.0）。
- 升级流程测试：在预发环境验证升级脚本的有效性，模拟生产环境条件执行“干跑”（dry-run）。
- 多实例批量升级：通过统一配置文件，对分布式部署的多个 DataHub 实例执行一致性升级。
- 升级审计与合规：记录升级过程日志，满足数据治理场景下的操作审计要求。
适用范围
- 基于 Docker/Kubernetes 部署的 DataHub 实例（支持开源版及企业版）。
- 需严格控制升级风险的生产环境（如***、电商等对数据连续性要求高的场景）。
- 需跨团队协作执行升级的组织（通过标准化工具统一操作流程）。
四、使用方法和配置说明
4.1 前置条件
- 已部署 DataHub 实例，且可通过网络访问（需开放 API 端口，默认 8080/8443）。
- 具备 DataHub 管理员权限（用于执行元数据操作、服务重启等）。
- 若启用数据备份，需提前配置外部存储（如 S3、NFS）用于存储备份文件。
4.2 基本使用流程
-
拉取镜像：从镜像仓库拉取指定版本的 datahub-upgrade CLI 镜像（建议使用固定版本标签，避免自动更新风险）。
bashdocker pull acryldata/datahub-upgrade:v0.11.0 # 示例版本，需替换为实际目标版本 -
执行升级操作：通过
docker run启动容器，传入升级参数（如目标版本、DataHub 服务地址等）。 -
验证升级结果：升级完成后，通过工具内置命令或外部健康检查确认服务状态及数据完整性。
4.3 配置参数与环境变量
4.3.1 环境变量
| 环境变量名 | 描述 | 示例值 | 是否必填 |
|---|---|---|---|
DATAHUB_BASE_URL | DataHub 服务基础地址（需包含协议，如 http/https） | http://datahub-service:8080 | 是 |
DATAHUB_AUTH_TOKEN | 访问 DataHub 的认证令牌（若启用认证，如 JWT、OAuth2 令牌） | eyJhbGciOiJIUzI1NiIsInR5cCI6... | 否（未启用认证时可不填） |
DB_CONNECTION_STRING | DataHub 元数据库连接串（用于直接操作数据库的升级步骤，如 MySQL/PostgreSQL） | jdbc:mysql://db-host:3306/datahub | 否（部分升级步骤依赖） |
LOG_LEVEL | 日志级别（DEBUG/INFO/WARN/ERROR） | INFO | 否（默认 INFO） |
BACKUP_DIR | 升级前数据备份目录（需挂载外部存储路径） | /backup | 否（启用备份时必填） |
4.3.2 命令行参数
| 参数名 | 描述 | 示例值 |
|---|---|---|
--target-version | 目标升级版本（必填，格式如 v0.11.0） | --target-version v0.11.0 |
--dry-run | 执行“干跑”模式，仅模拟升级流程，不实际修改数据 | --dry-run |
--skip-precheck | 跳过预升级环境检查（不建议生产环境使用） | --skip-precheck |
--backup | 升级前自动备份元数据（需配合 BACKUP_DIR 环境变量） | --backup |
--verbose | 输出详细日志（等价于 LOG_LEVEL=DEBUG） | --verbose |
4.4 部署示例
4.4.1 基础升级命令（docker run）
以下示例为升级 DataHub 至 v0.11.0，执行预检查并备份数据：
bashdocker run -it --rm \ -e DATAHUB_BASE_URL="http://datahub-service:8080" \ -e DATAHUB_AUTH_TOKEN="your-auth-token" \ -e BACKUP_DIR="/backup" \ -v /host/backup:/backup \ # 挂载主机目录存储备份文件 acryldata/datahub-upgrade:v0.11.0 \ upgrade --target-version v0.11.0 --backup
4.4.2 干跑模式（验证升级流程）
bashdocker run -it --rm \ -e DATAHUB_BASE_URL="http://datahub-test:8080" \ acryldata/datahub-upgrade:v0.11.0 \ upgrade --target-version v0.11.0 --dry-run --verbose
五、注意事项
-
版本匹配：确保 datahub-upgrade CLI 镜像版本与目标 DataHub 版本一致（如升级至 v0.11.0 需使用对应 CLI 版本）。
-
生产环境建议：升级前通过
--dry-run验证流程，并手动备份关键数据（如数据库、配置文件），避免工具备份失效。 -
网络隔离：若 DataHub 部署在私有网络，需确保容器可访问 DataHub 服务及依赖组件（如数据库、Kafka）。
-
资源限制：升级过程可能涉及元数据迁移，建议为容器分配足够 CPU/内存（如
--cpus 2 --memory 4g）。
注：具体参数及功能可能随 DataHub 版本迭代更新，使用前请参考对应版本的官方升级文档。
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 datahub-upgrade 镜像标签
docker pull docker.xuanyuan.run/acryldata/datahub-upgrade:<标签>
DockerHub 原生拉取命令
docker pull acryldata/datahub-upgrade:<标签>
更多 datahub-upgrade 镜像推荐
linkedin/datahub-upgrade
linkedin
暂无描述
855 次下载
3 年前更新
rancher/k3s-upgrade
rancher
暂无描述
7 次收藏1000万+ 次下载
21 天前更新
rancher/rke2-upgrade
rancher
暂无描述
2 次收藏1000万+ 次下载
13 天前更新
pgautoupgrade/pgautoupgrade
pgautoupgrade
支持PostgreSQL 9.5至17.x版本的容器，启动前可升级数据库文件。
32 次收藏1000万+ 次下载
11 天前更新
rancher/system-upgrade-controller
rancher
暂无描述
2 次收藏1000万+ 次下载
22 天前更新
rancher/harvester-upgrade
rancher
暂无描述
10万+ 次下载
6 天前更新
镜像拉取常见问题
功能
排错
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"