Criando uma instância de serviço para os serviços Watson de fala com o cpd-cli service-instance create comando

Informações necessárias para concluir esta tarefa

Analise as seguintes informações antes de criar uma instância de serviço para os serviços Watson de fala :

Requisitos de Versão

Todos os componentes associados a uma instância do IBM Software Hub devem ser instalados ou criados na mesma versão. Por exemplo, se os serviços de voz d Watson estiverem instalados na versão 5.3.1, você deverá criar a instância do serviço na versão 5.3.1.

Importante: Os serviços Watson de fala utilizam um número de versão diferente do IBM Software Hub. Este tópico inclui uma tabela que mostra a versão Watson dos serviços de fala para cada atualização do IBM Software Hub. Use esta tabela para encontrar a versão correta com base na versão do IBM Software Hub que está instalada.

Variáveis de ambiente

Os comandos nesta tarefa utilizam variáveis de ambiente para que você possa executá-los exatamente como estão escritos.

• Se você não tiver o script que define as variáveis de ambiente, consulte Configurando as variáveis de ambiente de instalação.
• Para usar as variáveis de ambiente do script, você deve obter as variáveis de ambiente antes de executar os comandos nesta tarefa. Por exemplo, execute:

  source ./cpd_vars.sh

Antes de iniciar

Esta tarefa pressupõe que os seguintes pré-requisitos estejam cumpridos:

Procedimento

Conclua as seguintes tarefas para criar uma instância de serviço:

1. Criando uma instância de serviço
2. Validando se a instância do serviço foi criada
3. O que fazer a seguir

Criando uma instância de serviço

Para criar uma instância de serviço:

1. Mude para o diretório em sua estação de trabalho onde deseja criar o arquivo JSON que define a carga útil da instância do serviço.
2. Defina as variáveis de ambiente usadas para preencher a carga JSON para a instância do serviço:
   1. Defina a variável INSTANCE_NAME de ambiente como o nome exclusivo que você deseja usar como nome de exibição para a instância do serviço:

      export INSTANCE_NAME="<display-name>"

      Este nome é exibido na página Instâncias do cliente IBM Software Hub web.

      O nome de exibição é um string e pode conter caracteres alfanuméricos (a-z, A-Z, 0-9), traços (-) e pontos (.).

      O nome de exibição pode ter no máximo 10 caracteres.

   2. Defina a variável INSTANCE_VERSION de ambiente para a versão que corresponde à versão do IBM Software Hub seu cluster:

      export INSTANCE_VERSION=<version>

      Use a tabela a seguir para determinar o valor apropriado:

      Versão IBM Software Hub	Versão de Instância de Serviço
      5.3.1	5.3.1
      5.3.0	5.3.0

   3. Defina a variável SPEECH_CR de ambiente com o nome do recurso Watson Speech services personalizado:

      export SPEECH_CR=<resource-name>

      O nome padrão é speech-cr. No entanto, você pode ter um nome diferente, dependendo se você atualizou a partir de uma versão mais antiga. Para verificar o nome do recurso personalizado, execute:

      oc get WatsonSpeech --namespace=${PROJECT_CPD_INST_OPERANDS}

3. Crie o speech-services-instance.json arquivo 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

   As seguintes variáveis de ambiente utilizam os valores já definidos no script de variáveis de ambiente da sua instalação:

   • ${PROJECT_CPD_INST_OPERANDS}
4. Defina a variável PAYLOAD_FILE de ambiente como o nome completo do arquivo de carga JSON em sua estação de trabalho:

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

5. Crie a instância do serviço a partir do arquivo de carga útil:

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

Validando se a instância do serviço foi criada

Para validar que a instância do serviço foi criada, execute o seguinte comando:

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

• Se o comando retornar PROVISIONED, a instância do serviço foi criada com sucesso.
• Se o comando retornar PROVISION_IN_PROGRESS, aguarde alguns minutos e execute o comando novamente.
• Se o comando retornar FAILED, verifique os logs dos pods zen-core-apizen-watcher e para possíveis causas.

O quê fazer em seguida

A instância do serviço está pronta para uso. Para começar a usar os serviços de fala do Watson, consulte Watson Serviços de fala no Cloud Pak for Data.