将 Watson Discovery 从版本 5.3.x 升级至更高版本 5.3 刷新

实例管理员可将 Watson Discovery 从 5.3.x 版本升级至更高版本的 5.3 刷新版本。

谁需要完成这项任务？

实例管理员要升级 Watson Discovery ，您必须是实例管理员。 实例管理员有权限管理以下项目中的软件：

实例的操作员项目

此实例的 Watson Discovery 操作符已安装在 operators 项目中。 在升级命令中，环境变量 ${PROJECT_CPD_INST_OPERATORS} 指代操作员的项目。

实例的操作数项目

用于 和 Watson Discoverycontrol plane 的自定义资源已安装在 operands 项目中。 在升级命令中，环境变量 ${PROJECT_CPD_INST_OPERANDS} 指代操作数项目。

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

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

  • 若需同时升级 及 control planeIBM Software Hub 一项或多项服务，请参照 《升级 IBM 实例》 中的流程操作： Software Hub。
  • 若您在升级 时未升级 Watson DiscoveryIBM Software Hubcontrol plane ，请完成此任务以升级 Watson Discovery。

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

完成此任务所需的信息

在升级 Watson Discovery 之前，请查看以下信息：

版本需求

与实例 IBM Software Hub 相关的所有组件必须安装在同一版本中。 例如，如果 IBM Software Hubcontrol plane 处于版本 5.3.1 ，则必须将 Watson Discovery 升级至版本 5.3.1。

环境变量
本任务中的命令使用环境变量，因此您可以完全按照所写的命令运行。
  • 若您尚未拥有定义环境变量的脚本，请参阅 《设置安装环境变量》。
  • 要使用脚本中的环境变量，必须在本任务中运行命令之前加载这些环境变量。 例如，运行以下命令：
    source ./cpd_vars.sh

开始之前

此任务要求满足以下先决条件：

系统需求
此任务假定集群满足 Watson Discovery 的最低要求。
在何处查找更多信息
如果此任务尚未完成，请参阅系统要求。
工作站
此任务假定您将用于运行升级的工作站已配置为客户端工作站，并具备以下命令行界面：
  • IBM Software Hub 命令行界面： cpd-cli
  • OpenShift® 命令行界面： oc
  • Helm 命令行界面： oc
在何处查找更多信息
如果此任务尚未完成，请参阅更新客户端工作站。
控制平面
此任务假设 已升级 IBM Software Hubcontrol plane 。
在何处查找更多信息
如果此任务尚未完成，请参阅 《升级 IBM 实例》 Software Hub。
专用容器注册表
如果您的环境使用私有容器注册表（例如，您的集群处于空气隔离状态），则此任务假定以下任务已完成：
  1. Watson Discovery 软件镜像已同步至私有容器注册表。
    在何处查找更多信息
    如果此任务尚未完成，请参阅《 将镜像镜像到私有容器注册表》。
  2. 该 cpd-cli 配置用于从私有容器注册表中拉取镜像 olm-utils-v4 。
    在何处查找更多信息
    如果此任务尚未完成，请参阅从私有容器注册表拉取 olm-utils-v4 镜像。
Multicloud Object Gateway
此任务假设在需要时会 Multicloud Object Gateway 进行升级。
在何处查找更多信息
如果此任务尚未完成，请参阅 《升级多云对象网关》。
簇作用域资源
此任务假设集群范围资源（如自定义资源定义、集群角色和集群角色绑定）已完成更新。
在何处查找更多信息
如果此任务尚未完成，请参阅 《更新平台和服务的集群范围资源》。

过程

完成以下任务以升级 Watson Discovery ：

  1. 指定配置选项
  2. 服务升级
  3. 验证升级
  4. 升级现有服务实例
  5. 下一步该做什么

指定安装选项

若计划安装 Watson Discovery，可在 目录 cpd-cli workinstall-options.yml 下的 文件中指定以下安装选项（例如： cpd-cli-workspace/olm-utils-workspace/work）。

该参数是可选的。 若未设置此安装参数，则使用默认值。

请根据您 IBM Software Hub 安装的版本遵循相应的指导：

版本 5.3.1

示例 YAML 内容使用默认值。

5.3.1 此格式仅适用于 5.3.1IBM Software Hub 版本。

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

---
# ............................................................................
# Watson Discovery parameters
# ............................................................................
non_olm:
  watsonDiscovery:
    discovery_deployment_type: Production
版本 5.3.0

示例YAML内容使用默认值。

若需覆盖一个或多个默认值，请在 文件的 install-options.yml 条目 watsonDiscovery: 下，将参数添加至 部分 non_olm: 。

# ............................................................................
# Watson Discovery parameters
# ............................................................................
  watsonDiscovery:
    discovery_deployment_type: Production
属性 描述
discovery_deployment_type 部署类型为 Watson Discovery.

部署类型决定了分配给的资源 Watson Discovery数量。

缺省值
Production
有效值
Production
生产环境部署中，每个Pod至少有两个副本，以支持生产级工作负载。 对于生产环境部署，部署规模为 小 scaleConfig 设置。
Starter
初始部署的资源和计算能力均少于生产环境部署。 对于初始部署，部署规模为。 超小 scaleConfig 设置

在以前的版本中，此部署类型被称为部署 development 类型。

升级服务

升级 Watson Discovery ：

  1. 登录 cpd-cli 到集群 Red Hat® OpenShift Container Platform ：
    ${CPDM_OC_LOGIN}
    请记住： CPDM_OC_LOGIN 是一个别名，代表 命令 cpd-cli manage login-to-ocp 。
  2. 更新 Watson Discovery 的操作员和自定义资源。
    cpd-cli manage install-components \
--license_acceptance=true \
--components=watson_discovery \
--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 Discovery 当命令 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=watson_discovery

升级现有的服务实例

下一步操作

Watson Discovery 已准备就绪，可立即使用。 有关如何授予他人访问您实例的权限的信息，请参阅 《 Watson Discovery 管理指南 》。