安装 "代码watsonx Code Assistant for Z解释

实例管理员可以在版本 IBM® Software Hub 上安装 watsonx Code Assistant for Z 代码 5.3 说明。

谁需要完成这项任务？

实例管理员要安装watsonx Code Assistant for ZCode Explanation，您必须是实例管理员。 实例管理员有权在以下项目中安装软件：

实例的运营商项目

watsonx Code Assistant for ZCode Explanation的操作符安装在操作符项目中。

在安装命令中，${PROJECT_CPD_INST_OPERATORS} 环境变量指的是操作员项目。

实例的操作数项目

control plane和 "代码watsonx Code Assistant for Z解释的自定义资源已安装在操作符项目中。

在安装命令中，${PROJECT_CPD_INST_OPERANDS} 环境变量指的是操作数项目。

您需要何时完成这项任务？

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

  • 如果要同时安装多个服务，请遵循 运行解决方案和服务的批量安装 中的流程。
  • 如果您没有将watsonx Code Assistant for ZCode Explanation作为批量安装的一部分，请完成此任务将watsonx Code Assistant for ZCode Explanation添加到您的环境中。

    根据需要重复 如果您负责多个 "IBM Software Hub实例，可以重复此任务，在群集上安装更多的watsonx Code Assistant for ZCode Explanation实例。

完成此任务所需的信息

在安装watsonx Code Assistant for Z代码解释之前，请查看以下信息：

版本需求

与 IBM Software Hub 实例关联的所有组件必须在同一版本中安装。 例如，如果 安装 control planeIBM Software Hub 在版本 5.3.1 ，则必须安装 watsonx Code Assistant for Z 代码说明在版本 5.3.1。

环境变量

本任务中的命令使用环境变量，因此可以完全按照编写的命令运行。

  • 如果没有定义环境变量的脚本，请参阅 设置安装环境变量。
  • 要使用脚本中的环境变量，必须在运行本任务中的命令前获取环境变量的源代码。 例如，运行以下命令：
    source ./cpd_vars.sh
安全上下文约束

代码watsonx Code Assistant for Z解释与默认的 "Red Hat® OpenShift® Container Platform安全上下文约束一起使用，"restricted-v2.

Common core services

watsonx Code Assistant for Z代码解释需要 "IBM Software Hub"common core services。

如果实例的操作数项目中没有安装 "common core services，则在安装watsonx Code Assistant for ZCode Explanation 时会自动安装 "common core services。 common core services 安装会增加完成安装所需的时间。

存储要求
您必须在安装watsonx Code Assistant for ZCode Explanation时指定存储类。 建议使用以下存储类别。 但是，如果您不在群集上使用这些存储类，请确保指定一个具有同等定义的存储类。
存储器 注意 存储类
OpenShift Data Foundation 安装服务时，请指定文件存储和块存储。
  • 文件存储 ocs-storagecluster-cephfs
  • 块存储： ocs-storagecluster-ceph-rbd
IBM Fusion Data Foundation 安装服务时，请指定文件存储和块存储。
  • 文件存储 ocs-storagecluster-cephfs
  • 块存储： ocs-storagecluster-ceph-rbd
IBM Fusion Global Data Platform 安装服务时，请为文件存储和块存储指定相同的存储类。
  • 文件存储：

    以下任一存储类别

    • ibm-spectrum-scale-sc
    • ibm-storage-fusion-cp-sc
  • 块存储：

    以下任一存储类别

    • ibm-spectrum-scale-sc
    • ibm-storage-fusion-cp-sc
IBM Storage Scale Container Native 安装服务时，请为文件存储和块存储指定相同的存储类。
  • 文件存储 ibm-spectrum-scale-sc
  • 块存储： ibm-spectrum-scale-sc
Portworx 安装服务时， --storage_vendor=portworx 选项可确保服务使用正确的存储类。
  • 文件存储 portworx-rwx-gp3-sc
  • 块存储：
    • portworx-couchdb-sc
    • portworx-elastic-sc
    • portworx-gp3-sc
NFS 安装服务时，请为文件存储和块存储指定相同的存储类。
  • 文件存储 managed-nfs-storage
  • 块存储： managed-nfs-storage
Amazon Elastic 存储
安装服务时，您可以指定
  • 仅存储文件
  • 文件存储和块存储（推荐）

文件存储由 Amazon Elastic File System 提供。 块存储由 Amazon Elastic Block Store 提供。
  • 文件存储 efs-nfs-client
  • 块存储：

    以下任一存储类别

    • gp2-csi
    • gp3-csi
NetApp Trident 安装服务时，请为文件存储和块存储指定相同的存储类。
  • 文件存储 ontap-nas
  • 块存储： ontap-nas
Nutanix 不支持。 不适用。

开始之前

本任务假定满足以下前提条件：

系统需求
此任务假定群集满足 watsonx Code Assistant for Z 代码解释的最低要求。
在何处查找更多信息
如果此任务未完成，请参阅 系统要求。
此外，请确保您拥有适用于 watsonx Code Assistant for Z 代码解释的正确类型和数量的GPU。
在何处查找更多信息
如果此任务尚未完成，请参阅 GPU 要求。
工作站
此任务假定运行安装的工作站设置为客户端工作站，并具有以下命令行界面：
  • IBM Software Hub CLI：cpd-cli
  • OpenShift CLI：oc
  • Helm CLI：helm
在何处查找更多信息
如果此任务未完成，请参阅 设置客户端工作站。
控制平面
此任务假定 IBM Software Hub control plane 已安装。
在何处查找更多信息
如果这项任务没有完成，请参阅安装 IBM Software Hub 的实例。
专用容器注册表
如果您的环境使用私有容器注册表（例如，您的群集是 air-gapped），则此任务假定以下任务已完成：
  1. watsonx Code Assistant for Z 代码解释软件镜像到专用容器注册表。
    在何处查找更多信息
    如果此任务未完成，请参阅 将映像镜像到私有容器注册表。
  2. cpd-cli 被配置为从私有容器注册表中提取 olm-utils-v4 映像。
    在何处查找更多信息
    如果此任务尚未完成，请参阅从私有容器注册表拉取镜像 olm-utils-v4。
GPU 操作员
此任务假定已安装使用 GPU 所需的操作员。
在何处查找更多信息
如果此任务未完成，请参阅 为需要 GPU 的服务安装操作员。
Red Hat OpenShift AI
此任务假定已安装 Red Hat OpenShift AI 。
在何处查找更多信息
如果这项任务没有完成，请参阅安装 Red Hat OpenShift AI。
簇作用域资源
此任务假定集群作用域资源（如自定义资源定义、集群角色和集群角色绑定）已存在。
在何处查找更多信息
如果此任务尚未完成，请参阅 《为 Software HubIBM 平台和服务创建集群范围资源 》。
映像提取私钥
此任务假设包含实例镜像拉取凭据的密钥已存在。
在何处查找更多信息
如果此任务尚未完成，请参阅 《为实例创建镜像拉取密钥 Software HubIBM 》。

过程

完成以下任务，安装watsonx Code Assistant for ZCode Explanation：

  1. 安装服务
  2. 验证安装
  3. 下一步该做什么

安装服务

安装 "代码watsonx Code Assistant for Z解释 ：

  1. 将 cpd-cli 登录到 Red Hat OpenShift Container Platform 群集：
    ${CPDM_OC_LOGIN}
    请记住： CPDM_OC_LOGIN 是 cpd-cli manage login-to-ocp 命令的别名。
  2. 安装操作符和自定义资源用于 watsonx Code Assistant for Z 代码解释。

    运行的命令取决于群集中的存储设备。

    Red Hat OpenShift数据基金会存储 
    cpd-cli manage install-components \
--license_acceptance=true \
--components=wca_z_ce \
--release=${VERSION} \
--operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--image_pull_prefix=${IMAGE_PULL_PREFIX} \
--image_pull_secret=${IMAGE_PULL_SECRET}
    IBM Fusion Data Foundation 存储 
    cpd-cli manage install-components \
--license_acceptance=true \
--components=wca_z_ce \
--release=${VERSION} \
--operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--image_pull_prefix=${IMAGE_PULL_PREFIX} \
--image_pull_secret=${IMAGE_PULL_SECRET}
    IBM Fusion 全球数据平台存储
    请记住 When you use IBM Fusion Global Data Platform storage, both ${STG_CLASS_BLOCK} and ${STG_CLASS_FILE} point to the same storage class, typically ibm-spectrum-scale-sc or ibm-storage-fusion-cp-sc.
    cpd-cli manage install-components \
--license_acceptance=true \
--components=wca_z_ce \
--release=${VERSION} \
--operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--image_pull_prefix=${IMAGE_PULL_PREFIX} \
--image_pull_secret=${IMAGE_PULL_SECRET}
    IBM StorageScale 容器本地存储
    请记住 When you use IBM Storage Scale Container Native storage, both ${STG_CLASS_BLOCK} and ${STG_CLASS_FILE} point to the same storage class, typically ibm-spectrum-scale-sc.
    cpd-cli manage install-components \
--license_acceptance=true \
--components=wca_z_ce \
--release=${VERSION} \
--operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--image_pull_prefix=${IMAGE_PULL_PREFIX} \
--image_pull_secret=${IMAGE_PULL_SECRET}
    Portworx 存储器 
    cpd-cli manage install-components \
--license_acceptance=true \
--components=wca_z_ce \
--release=${VERSION} \
--operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--storage_vendor=portworx \
--image_pull_prefix=${IMAGE_PULL_PREFIX} \
--image_pull_secret=${IMAGE_PULL_SECRET}
    NFS 存储器
    请记住 When you use NFS storage, both ${STG_CLASS_BLOCK} and ${STG_CLASS_FILE} point to the same storage class, typically managed-nfs-storage.
    cpd-cli manage install-components \
--license_acceptance=true \
--components=wca_z_ce \
--release=${VERSION} \
--operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--image_pull_prefix=${IMAGE_PULL_PREFIX} \
--image_pull_secret=${IMAGE_PULL_SECRET}
    仅使用EFS存储AWS
    请记住：使用EFS存储时，"${STG_CLASS_BLOCK}和 "${STG_CLASS_FILE}都指向同一个存储类，通常是 "efs-nfs-client。
    cpd-cli manage install-components \
--license_acceptance=true \
--components=wca_z_ce \
--release=${VERSION} \
--operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--image_pull_prefix=${IMAGE_PULL_PREFIX} \
--image_pull_secret=${IMAGE_PULL_SECRET}
    带有EFS和EBS存储的AWS 
    cpd-cli manage install-components \
--license_acceptance=true \
--components=wca_z_ce \
--release=${VERSION} \
--operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--image_pull_prefix=${IMAGE_PULL_PREFIX} \
--image_pull_secret=${IMAGE_PULL_SECRET}
    NetApp Trident
    请记住 When you use NetApp Trident storage, both ${STG_CLASS_BLOCK} and ${STG_CLASS_FILE} point to the same storage class, typically ontap-nas.
    cpd-cli manage install-components \
--license_acceptance=true \
--components=wca_z_ce \
--release=${VERSION} \
--operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--image_pull_prefix=${IMAGE_PULL_PREFIX} \
--image_pull_secret=${IMAGE_PULL_SECRET}

验证安装

代码watsonx Code Assistant for Z解释 is installed when the install-components command returns:
[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=wca_z_ce

下一步操作

  1. 完成代码说明 watsonx Code Assistant for Z 的安装后设置。

完成上述步骤后， watsonx Code Assistant for Z Code Explanation 即可使用。