Watson Studio Runtimes 从 5.2 版本升级至 5.3 版本

实例管理员可以将 Watson Studio Runtimes 从 5.2 版本升级到 5.3 版本。

谁需要完成这项任务?

实例管理员 若要升级 Watson Studio Runtimes,您必须是实例管理员。 实例管理员有权管理以下项目中的软件:

例如, 运算符项目

此实例 IBM Software Hub 的操作符已安装在 operators 项目中。 在升级命令中,环境变量 ${PROJECT_CPD_INST_OPERATORS} 指的是 operators 项目。

该实例的操作数项目

该实例的 control plane 以及相关 IBM Software Hub 服务已安装在 operands 项目中。 在升级命令中,环境变量 ${PROJECT_CPD_INST_OPERANDS} 指代操作数项目。

你需要在什么时候完成这项任务?

请查看以下选项,以确定您是否需要完成此任务:

  • 如果您希望同时升级 以及 control plane 一项或多项服务,请按照 《升级 IBM 实例》 Software Hub 中的步骤操作。
  • 如果您在升级 Watson Studio Runtimes 时未升级 ,请完成 control plane此任务以升级 Watson Studio Runtimes

    根据需要重复此操作。如果您负责管理多个实例 IBM Software Hub,可以重复此任务,以升级集群 Watson Studio Runtimes 中更多实例。

完成此任务所需的信息

升级前请仔细阅读 Watson Studio Runtimes以下信息:

版本需求

与某个实例相关的 IBM Software Hub 所有组件必须安装在同一版本中。 例如,如果 当前 control plane 版本为 5.3.1Watson Studio Runtimes ,则必须将其升级至 5.3.1

环境变量
本任务中的命令使用了环境变量,因此您可以直接按原样运行这些命令。
  • 如果您没有定义环境变量的脚本,请阅“设置安装环境变量”。
  • 若要在脚本中使用环境变量,必须在执行本任务中的命令之前加载环境变量。 例如,运行以下命令:
    source ./cpd_vars.sh
存储要求
升级时无需指定 Watson Studio Runtimes存储位置。

开始之前

本任务假设已满足以下先决条件:

系统需求
此任务假设该集群满足 Watson Studio Runtimes 的最低要求。
在何处查找更多信息
如果此任务尚未完成,请参阅 “系统要求 ”。
此外,请确保您为 Watson Studio Runtimes 配备了类型和数量均合适的GPU。
在何处查找更多信息
如果此任务尚未完成,请参阅 GPU 要求
工作站
此任务假设您将用于执行升级的工作站已配置为客户端工作站,并具备以下命令行界面:
  • IBM Software Hub 命令行界面: cpd-cli
  • OpenShift® 命令行界面: oc
  • Helm 命令行界面: oc
在何处查找更多信息
如果此任务尚未完成,请参阅 “更新客户端工作站”
控制平面
此任务假设 IBM Software Hubcontrol plane 已升级。
在何处查找更多信息
如果此任务尚未完成,请参阅 《升级 IBM 实例》 Software Hub
专用容器注册表
如果您的环境使用私有容器注册表(例如,您的集群处于物理隔离状态),则本任务假设以下任务已完成:
  1. Watson Studio Runtimes 软件镜像已同步到私有容器注册表。
    在何处查找更多信息
    如果此任务尚未完成,请参阅《 将镜像镜像到私有容器注册表》
  2. cpd-cli 已配置为从私有容器注册表拉取 olm-utils-v4 镜像。
    在何处查找更多信息
    如果此任务尚未完成,请参阅 《从私有容器注册表拉取 olm-utils-v4 镜像》
GPU 操作员
此任务假设已安装使用 GPU 所需的操作程序。
在何处查找更多信息
如果此任务尚未完成,请参阅 《为需要 GPU 的服务安装运算器》
集群范围内的资源
此任务假设集群范围内的资源(例如自定义资源定义、集群角色和集群角色绑定)已更新。
在何处查找更多信息
如果此任务尚未完成,请参阅“更新平台和服务的集群范围资源 ”。
映像提取私钥
此任务假设已存在包含该实例镜像拉取凭据的密钥。
在何处查找更多信息
如果此任务尚未完成,请参阅 《为 IBM 实例创建镜像拉取密钥》一文: Software Hub

必备服务

在升级 Watson Studio Runtimes 之前,请确保以下服务已升级且正在运行:

过程

请完成以下任务以升级 Watson Studio Runtimes

  1. 指定安装选项
  2. 升级服务
  3. 验证升级
  4. 接下来该做什么

指定安装选项

升级 Watson Studio Runtimes 时,请在 work 目录下的 文件 install-options.yml 中指定要安装和保留的运行时。
重要提示: 如果您希望在升级时自动升级所有现有运行时 Watson Studio,请在升级时指定该 ws_runtimesWatson Studio 组件。

如果您在升级时未指定 Watson Studio组件 ws_runtimes ,则仅会升级默认运行时。 您必须手动升级非默认的运行时环境。

请按照您 IBM Software Hub 所安装的版本对应的说明进行操作:
版本 5.3.1

5.3.1 以及后续版本。此格式仅适用于 5.3.1IBM Software Hub 版本。

请保留条目开头的 --- 语法,以确保该条目被视为独立文档。

---
# ............................................................................
# Watson Studio Runtimes parameters
# ............................................................................
non_olm:
  wsRuntimes:
    kinds: []
版本 5.3.0

若要安装一个或多个可选运行时,请在 文件 install-options.yml 中的 部分 non_olm: ,于 条目 wsRuntimes: 下添加相应参数。

# ............................................................................
# Watson Studio Runtimes parameters
# ............................................................................
  wsRuntimes:
    kinds: []
属性 描述
kinds 请指定是否要安装 GPU 和 R 的 Watson Studio Runtimes 可选组件。
缺省值
[]
有效值
ibm-cpd-ws-runtime-251-pygpu
安装 Runtime 25.1 on Python 3.12 for GPU
ibm-cpd-ws-runtime-241-pygpu
安装 Runtime 24.1 on Python 3.11 for GPU
ibm-cpd-ws-runtime-251-r
安装 Runtime 25.1 on R 4.4
ibm-cpd-ws-runtime-241-r
安装 Runtime 24.1 on R 4.3
包括此参数
请在单独一行上将运行时名称作为列表项指定。
安装 Runtime 25.1 on Python 3.12 for GPU
  wsRuntimes:
    kinds:
      - ibm-cpd-ws-runtime-251-pygpu
安装 Runtime 24.1 on Python 3.11 for GPU
  wsRuntimes:
    kinds:
      - ibm-cpd-ws-runtime-241-pygpu
安装 Runtime 25.1 on R 4.4
  wsRuntimes:
    kinds:
      - ibm-cpd-ws-runtime-251-r
安装 Runtime 24.1 on R 4.3
  wsRuntimes:
    kinds:
      - ibm-cpd-ws-runtime-241-r
安装所有运行时环境
  wsRuntimes:
    kinds:
      - ibm-cpd-ws-runtime-251-pygpu
      - ibm-cpd-ws-runtime-241-pygpu
      - ibm-cpd-ws-runtime-251-r
      - ibm-cpd-ws-runtime-241-r

升级服务

要升级 Watson Studio Runtimes

  1. 登录到 cpd-cliRed Hat® OpenShift Container Platform 集群:
    ${CPDM_OC_LOGIN}
    请记住: CPDM_OC_LOGIN 是 命令 cpd-cli manage login-to-ocp 的别名。
  2. 更新 Watson Studio Runtimes 的操作符和自定义资源。
    cpd-cli manage install-components \
    --license_acceptance=true \
    --components=ws_runtimes \
    --release=${VERSION} \
    --operator_ns=${PROJECT_CPD_INST_OPERATORS} \
    --instance_ns=${PROJECT_CPD_INST_OPERANDS} \
    --image_pull_prefix=${IMAGE_PULL_PREFIX} \
    --image_pull_secret=${IMAGE_PULL_SECRET} \
    --param-file=/tmp/work/install-options.yml \
    --upgrade=true

验证升级

Watson Studio Runtimes 当该 install-components 命令返回时,会进行升级:
[SUCCESS]... The install-components command ran successfully

若要确认自定义资源的状态为 Completed,您可以运行以下 cpd-cli manage get-cr-status 命令:

cpd-cli manage get-cr-status \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--components=ws_runtimes

下一步操作

  1. 如果您在 Watson Studio中使用自定义运行时镜像,则必须创建并注册这些自定义镜像,以便将镜像与最新的 IBM Software Hub 运行时镜像进行重新基准化。 请参阅 “构建自定义运行时镜像 ”。

完成上述步骤后, Watson Studio Runtimes 即可投入使用。 详情请参阅 “笔记本环境 ”。