使用 命令 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)”权限。
你需要在什么时候完成这项任务?
仅当您希望通过 命令 cpd-cli service-instance createcpd-cli 创建服务实例时,才执行此任务。
创建服务实例的替代方法
  • 来自网页客户端。 有关更多信息,请阅从 Web watsonx Assistant 客户端创建服务实例。
  • 通过调用 /v3/service_instances REST API。 有关更多信息, 参阅《 watsonx Assistant 通过编程方式创建服务实例》。

完成此任务所需的信息

在为创建服务实例 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(can_provision) 权限的用户。

如果此任务尚未完成,请阅创建配置文件以使用 cpd-cli 管理命令。

过程

完成以下任务以创建服务实例:

  1. 创建服务实例
  2. 验证服务实例是否已创建
  3. 下一步该做什么

创建服务实例

要创建服务实例:

  1. 切换到工作站上您希望创建定义服务实例有效负载的 JSON 文件的目录。
  2. 设置用于填充服务实例 JSON 负载的环境变量:
    1. INSTANCE_NAME 环境变量设置为要用作服务实例显示名称的唯一名称:
      export INSTANCE_NAME="<display-name>"

      此名称显示在 Web IBM Software Hub 客户端的实例页面上。

      显示名称是一个字符串 string ,可以包含字母数字字符(a-z、A-Z、0-9)、连字符(-)和句点(.)。

      显示名称最多可包含10个字符。

    2. INSTANCE_VERSION 环境变量设置 IBM Software Hub 为与集群中版本对应的版本:
      export INSTANCE_VERSION=<version>

      请使用下表确定相应的数值:

      IBM Software Hub 版本 服务实例版本
      5.3.1 5.3.1
      5.3.0 5.3.0
  3. 创建有效 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}
  4. PAYLOAD_FILE 环境变量设置为工作站上 JSON 有效负载文件的完全限定名称:
    export PAYLOAD_FILE=<fully-qualified-JSON-file-name>
  5. 从有效负载文件创建服务实例:
    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-watcher zen-core-api 容器的日志以排查可能原因。

下一步操作

服务实例已准备就绪,可供使用。 作为服务实例的管理员,您可以授予其他用户访问该实例的权限。