Creación de una instancia de servicio para servicios Watson de voz con el cpd-cli service-instance create comando

Información que necesita para completar esta tarea

Revise la siguiente información antes de crear una instancia de servicio para los Watson servicios de voz :

Requisitos de versión

Todos los componentes asociados a una instancia de IBM Software Hub deben instalarse o crearse en la misma versión. Por ejemplo, si los servicios de voz de Watson están instalados en la versión 5.3.1, debe crear la instancia del servicio en la versión 5.3.1.

Importante: Los servicios Watson de voz utilizan un número de versión diferente al de IBM Software Hub. Este tema incluye una tabla que muestra la versión de los Watson servicios de voz para cada actualización de IBM Software Hub. Utilice esta tabla para encontrar la versión correcta en función de la versión de IBM Software Hub que esté instalada.

Variables de entorno

Los comandos de esta tarea utilizan variables de entorno para que puedas ejecutarlos tal y como están escritos.

• Si no dispone del script que define las variables de entorno, consulte Configuración de las variables de entorno de instalación.
• Para utilizar las variables de entorno del script, debe obtener las variables de entorno antes de ejecutar los comandos de esta tarea. Por ejemplo, ejecute:

  source ./cpd_vars.sh

Antes de empezar

Esta tarea supone que se cumplen los siguientes requisitos previos:

Procedimiento

Complete las siguientes tareas para crear una instancia de servicio:

1. Creación de una instancia de servicio
2. Validación de que se ha creado la instancia del servicio
3. Qué hacer a continuación

Creación de una instancia de servicio

Para crear una instancia de servicio:

1. Cambie al directorio de su estación de trabajo donde desea crear el archivo JSON que define la carga útil de la instancia del servicio.
2. Configure las variables de entorno que se utilizan para rellenar la carga JSON para la instancia del servicio:
   1. Establezca la INSTANCE_NAME variable de entorno con el nombre único que desee utilizar como nombre para mostrar de la instancia del servicio:

      export INSTANCE_NAME="<display-name>"

      Este nombre se muestra en la página Instancias del cliente IBM Software Hub web.

      El nombre para mostrar es un string y puede contener caracteres alfanuméricos (a-z, A-Z, 0-9), guiones (-) y puntos (.).

      El nombre para mostrar puede tener un máximo de 10 caracteres.

   2. Establezca la INSTANCE_VERSION variable de entorno en la versión que corresponda a la versión de IBM Software Hub en su clúster:

      export INSTANCE_VERSION=<version>

      Utilice la siguiente tabla para determinar el valor adecuado:

      Versión de IBM Software Hub	Versión de instancia de servicio
      5.3.1	5.3.1
      5.3.0	5.3.0

   3. Establezca la SPEECH_CR variable de entorno con el nombre del recurso Watson Speech services personalizado:

      export SPEECH_CR=<resource-name>

      El nombre predeterminado es speech-cr. Sin embargo, es posible que tenga un nombre diferente dependiendo de si ha actualizado desde una versión anterior. Para comprobar el nombre del recurso personalizado, ejecute:

      oc get WatsonSpeech --namespace=${PROJECT_CPD_INST_OPERANDS}

3. Cree el speech-services-instance.json archivo de carga útil:

   cat << EOF > ./speech-services-instance.json
   { 
       "addon_type": "speech-to-text",
       "namespace": "${PROJECT_CPD_INST_OPERANDS}",
       "addon_version": "${INSTANCE_VERSION}",
       "display_name": "${INSTANCE_NAME}",
       "create_arguments": {
           "deployment_id": "${PROJECT_CPD_INST_OPERANDS}-${SPEECH_CR}",
           "parameters" : {
               "serviceId": "speech-to-text",
               "url": "https://${SPEECH_CR}-gdpr-data-deletion.${PROJECT_CPD_INST_OPERANDS}.svc.cluster.local:443/v3/service_instances",
               "watson": true
       }
     },
   }
   EOF

   Las siguientes variables de entorno utilizan los valores que ya están definidos en el script de variables de entorno de su instalación:

   • ${PROJECT_CPD_INST_OPERANDS}
4. Establezca la PAYLOAD_FILE variable de entorno con el nombre completo del archivo de carga JSON en su estación de trabajo:

   export PAYLOAD_FILE=<fully-qualified-JSON-file-name>

5. Cree la instancia del servicio a partir del archivo de carga útil:

   cpd-cli service-instance create \
   --profile=${CPD_PROFILE_NAME} \
   --from-source=${PAYLOAD_FILE}

Validación de que se ha creado la instancia del servicio

Para validar que se ha creado la instancia del servicio, ejecute el siguiente comando:

cpd-cli service-instance status ${INSTANCE_NAME} \
--profile=${CPD_PROFILE_NAME} \
--output=json

• Si el comando devuelve PROVISIONED, la instancia del servicio se ha creado correctamente.
• Si el comando devuelve PROVISION_IN_PROGRESS, espere unos minutos y vuelva a ejecutar el comando.
• Si el comando devuelve FAILED, revise los registros de los pods zen-core-api y para zen-watcher ver las posibles causas.

Qué hacer a continuación

La instancia del servicio está lista para usar. Para empezar a utilizar los servicios de voz de Watson, consulte los servicios de voz de Watson en Cloud Pak for Data.