使用 命令 cpd-cli
service-instance
createwatsonx Assistant 为 创建服务实例
安装完成后,您必须在操作数项目 watsonx Assistant 中创建至少一个 watsonx Assistant 服务实例。 若您是用户 IBM® Software
Hub ,可使用命令 cpd-cli
service-instance
create 将创建服务实例的过程编写为脚本。
- 谁需要完成这项任务?
- 要使用 创建
cpd-cli服务实例,您必须在 中拥有“创建服务 IBM Software Hub实例(can_provision)”权限。
完成此任务所需的信息
在为创建服务实例 watsonx Assistant 之前,请先查看以下信息:
- 版本需求
与实例 IBM Software Hub 相关的所有组件必须在同一版本中安装或创建。 例如,如果 watsonx Assistant 安装在版本 上 5.3.1 ,则必须在版本 上创建 5.3.1 服务实例。
- 环境变量
本任务中的命令使用环境变量,因此您可以完全按照所写的命令运行。
- 若您尚未拥有定义环境变量的脚本,请参阅 《设置安装环境变量》。
- 要使用脚本中的环境变量,必须在本任务中运行命令之前加载这些环境变量。 例如,运行以下命令:
source ./cpd_vars.sh
开始之前
此任务要求满足以下先决条件:
| 预备条件 | 在何处查找更多信息 |
|---|---|
| watsonx Assistant 已安装。 | 如果此任务尚未完成,请参阅安装部分 watsonx Assistant。 |
命令行 cpd-cli 界面安装在您将用于创建服务实例的工作站上。 |
如果此任务尚未完成,请参阅设置客户端工作站。 |
| 您已在工作站上创建了一个 IBM Software
Hub 用户配置文件,您将通过该工作站创建服务实例。 该配置文件必须关联到具有在 中创建服务实例 IBM Software
Hub( |
如果此任务尚未完成,请参阅创建配置文件以使用 cpd-cli 管理命令。 |
过程
完成以下任务以创建服务实例:
创建服务实例
要创建服务实例:
- 切换到工作站上您希望创建定义服务实例有效负载的 JSON 文件的目录。
- 设置用于填充服务实例 JSON 负载的环境变量:
- 将
INSTANCE_NAME环境变量设置为要用作服务实例显示名称的唯一名称:export INSTANCE_NAME="<display-name>"此名称显示在 Web IBM Software Hub 客户端的实例页面上。
显示名称是一个字符串
string,可以包含字母数字字符(a-z、A-Z、0-9)、连字符(-)和句点(.)。显示名称最多可包含10个字符。
- 将
INSTANCE_VERSION环境变量设置 IBM Software Hub 为与集群中版本对应的版本:export INSTANCE_VERSION=<version>请使用下表确定相应的数值:
IBM Software Hub 版本 服务实例版本 5.3.1 5.3.1 5.3.0 5.3.0
- 将
- 创建有效
assistant-instance.json负载文件:cat << EOF > ./assistant-instance.json{ "addon_type": "assistant", "display_name": "${INSTANCE_NAME}", "namespace": "${PROJECT_CPD_INST_OPERANDS}", "addon_version": "${INSTANCE_VERSION}", "create_arguments": { "deployment_id": "${PROJECT_CPD_INST_OPERANDS}-wa", "parameters": { "serviceId": "assistant", "url": "https://wa-store.${PROJECT_CPD_INST_OPERANDS}.svc.cluster.local:443/csb/v2/service_instances", "watson": true } } } EOF以下环境变量将使用您安装环境变量脚本中已定义的值:${PROJECT_CPD_INST_OPERANDS}
- 将
PAYLOAD_FILE环境变量设置为工作站上 JSON 有效负载文件的完全限定名称:export PAYLOAD_FILE=<fully-qualified-JSON-file-name> - 从有效负载文件创建服务实例:
cpd-cli service-instance create \ --profile=${CPD_PROFILE_NAME} \ --from-source=${PAYLOAD_FILE}
验证服务实例是否已创建
要验证服务实例是否已创建,请运行以下命令:
cpd-cli service-instance status ${INSTANCE_NAME} \
--profile=${CPD_PROFILE_NAME} \
--output=json
- 如果命令返回
PROVISIONED成功,则服务实例创建成功。 - 如果命令返回
PROVISION_IN_PROGRESS错误,请等待几分钟后再次运行该命令。 - 如果命令
FAILED返回错误,请检查 和zen-watcherzen-core-api容器的日志以排查可能原因。