不停机升级Dataphin

本文介绍如何在Dataphin Manager中不停机升级Dataphin版本。

使用限制

仅当Dataphin当前版本与目标版本的版本号前三位相同时(例如,V5.1.2.02升级至V5.1.2.04),支持不停机升级。

前提条件

  • 已在许可证管理中导入许可证

  • 已了解版本升级的影响范围,详情请参见版本升级的影响范围

  • 当前没有进行中的配置和升级。如果系统正处于升级中的状态,请等待当前升级完成,或在必要时强制终止正在进行的版本升级后,再次进行升级。

背景信息

不停机升级Dataphin版本的操作可分为两个主要步骤:选择版本及升级模式、升级。在升级过程中,用户可正常登录Dataphin,升级时将对Dataphin的应用进行滚动升级。完整流程如下图:

image

操作步骤

步骤一:选择版本及升级模式

  1. Dataphin的登录地址后补充输入/opsconsole/v2,跳转至Dataphin Manager的登录界面。

  2. Dataphin Manager的登录界面输入用户名密码后,单击登录(用户名和密码您可联系Dataphin运营人员获取)。

  3. 升级记录页面单击升级Dataphin

  4. 在升级Dataphin页面中,选择版本及升级模式。参数及说明如下表。

    参数

    说明

    目标版本

    在版本列表中选择要升级到的目标版本。

    若版本列表中未包含所需的目标版本,可单击上传版本配置,上传目标版本配置文件。

    配置文件上传完成后,系统将进行配置文件校验。若配置文件内容不正确,则校验不通过,系统将会报错并展示失败原因;若配置文件通过校验,且系统中尚未包含该版本的配置文件,此时继续上传将导入该版本配置;若配置文件通过校验,且系统中已包含该版本的配置文件,此时继续上传将覆盖系统配置

    配置文件

    • 标准化配置:单击上传文件,上传YAMLzip格式的配置文件。上传后可下载配置文件。

      配置文件上传完成后,系统将进行配置文件校验。若配置文件中未包含所有配置项,系统将会报错,可单击报错信息中的查看详情,查看缺失配置项的列表。

    • 非标准化配置:在上传文件前,您可与Dataphin运维团队沟通获取所需的配置文件(zip格式)。单击上传文件,上传获取到的配置文件。配置文件上传完成后,系统将自动进行以下校验:

      • 配置文件中的版本标准化配置模板(product/dataphin/...)与上传的版本配置是否相同(MD5校验一致)。若不一致,系统将提示:配置文件中的配置模板与选择的版本不兼容,建议您与Dataphin运维团队进行确认,确认无误后再继续升级。

      • 配置文件中的overlay文件values.yaml文件版本标准化配置模板 (product/dataphin/...)是否兼容。若不兼容,系统将阻断本次升级,并提示:配置文件中的配置信息与选择的版本不兼容,无法继续升级,请您与Dataphin运维团队进行确认。

      • 配置文件中的values.yaml文件与您当前线上环境中运行的values.yaml文件是否一致。若不一致,系统将提示:配置文件中的配置信息与当前环境的线上配置不一致,继续升级将使用新配置文件继续升级。

      说明

      若无特殊情况,无需使用非标准化配置。

    升级模式

    选择不停机升级。升级时,数据服务不停服,且数据服务API调用持续可用(包括同步调用和异步调用)。

    通过当前版本及目标版本的可兼容性配置,来确认是否支持不停机升级。若不支持不停服升级,则默认选择停服升级。

  5. 选中风险声明后,单击开始升级

步骤二:开始升级

系统升级进度由进度条展示,升级过程中可单击查看日志,查看升级日志详情。