Configurar contêineres do serviço de Fala

Os contêineres de Fala permitem que os clientes criem uma arquitetura de aplicativo de fala otimizada para aproveitar as funcionalidades de nuvem robustas e a localidade de borda.

O ambiente de runtime do contêiner de Fala é configurado usando argumentos do comando docker run. Esse contêiner tem algumas configurações obrigatórias e opcionais. As configurações específicas do contêiner são as configurações de cobrança.

Definições de configuração

O contêiner tem as seguintes configurações:

Configuração de configuração do ApiKey

A configuração ApiKey especifica a chave de recurso do Azure usada para rastrear informações de cobrança do contêiner. É necessário especificar um valor para o ApiKey e o valor deve ser uma chave válida para o recurso de Fala especificado para a configuração Billing.

Essa configuração pode ser localizada no seguinte local:

• Portal do Azure: Gerenciamento de Recursos de Fala, em Chaves

Configuração applicationInsights

A configuração ApplicationInsights permite que você adicione suporte a dados telemétricos do Azure Application Insights para seu contêiner. O Application Insights fornece um monitoramento detalhado do seu contêiner. Você pode monitorar facilmente seu contêiner quanto a disponibilidade, desempenho e uso. Você pode identificar e diagnosticar erros em seu contêiner rapidamente.

A tabela a seguir descreve as definições de configuração com suporte sob o ApplicationInsights seção.

Definição de configuração de cobrança

A configuração Billing especifica o URI de ponto de extremidade do recurso de Fala no Azure usado para medir informações de cobrança para o contêiner. Você precisa especificar um valor para esta definição de configuração e o valor deve ser um URI de ponto de extremidade válido para um recurso de Fala no Azure. O contêiner relata o uso a cada 10 a 15 minutos.

Essa configuração pode ser localizada no seguinte local:

• Portal do Azure: rotulado como Endpoint na página visão geral da Fala

Configuração de EULA

A configuração Eula indica que você aceitou a licença para o contêiner. Você deve especificar um valor para essa definição de configuração e o valor deve ser definido como accept.

Os contêineres dos serviços de IA do Azure estão licenciados de acordo com o seu contrato que rege o uso do Azure. Se você não tiver um contrato existente que rege o uso do Azure, você concorda que o seu contrato que rege o uso do Azure é o Contrato de Assinatura do Microsoft Online, que incorpora os Termos de Serviços Online . Para versões prévias, você também concorda com os Termos de Uso Adicionais para Versões Prévias do Microsoft Azure. Ao usar o contêiner, você concorda com estes termos.

Configurações de Fluentd

O Fluentd é um coletor de dados de software livre para registro em log unificado. As configurações do Fluentd gerenciam a conexão do contêiner com um servidor Fluentd. O contêiner inclui um provedor de registro em log do Fluentd, que permite que seu contêiner grave logs e, opcionalmente, dados de métrica para um servidor do Fluentd.

A tabela a seguir descreve as definições de configuração com suporte sob o Fluentd seção.

Configurações das credenciais de proxy HTTP

Se você precisar configurar um proxy HTTP para fazer solicitações de saída, use estes dois argumentos:

docker run --rm -it -p 5000:5000 \
--memory 2g --cpus 1 \
--mount type=bind,src=/home/azureuser/output,target=/output \
<registry-location>/<image-name> \
Eula=accept \
Billing=<endpoint> \
ApiKey=<api-key> \
HTTP_PROXY=<proxy-url> \
HTTP_PROXY_CREDS=<proxy-user>:<proxy-password> \

Configurações de log

As configurações Logging gerenciam o suporte ao registro em log do ASP.NET Core para o contêiner. Você pode usar as mesmas definições de configuração e valores para o contêiner usado em um aplicativo ASP.NET Core.

Os provedores de registro em log a seguir são suportados pelo contêiner:

Este comando de contêiner armazena informações de registro em log no formato JSON para a montagem de saída:

docker run --rm -it -p 5000:5000 \
--memory 2g --cpus 1 \
--mount type=bind,src=/home/azureuser/output,target=/output \
<registry-location>/<image-name> \
Eula=accept \
Billing=<endpoint> \
ApiKey=<api-key> \
Logging:Disk:Format=json \
Mounts:Output=/output

Este comando de contêiner mostra informações de depuração prefixadas com dbug enquanto o contêiner está em execução:

docker run --rm -it -p 5000:5000 \
--memory 2g --cpus 1 \
<registry-location>/<image-name> \
Eula=accept \
Billing=<endpoint> \
ApiKey=<api-key> \
Logging:Console:LogLevel:Default=Debug

Registro em log do Disk

O provedor de registro Disk suporta as seguintes configurações:

Para obter mais informações sobre como configurar o suporte ao registro em log do ASP.NET Core, consulte Configuração do arquivo de configurações.

Configurações de montagem

Use montagens de associação para ler e gravar dados do contêiner e para ele. Você pode especificar uma montagem de entrada ou saída especificando a opção --mount no comando docker run.

Os contêineres de Fala Padrão não usam montagens de entrada ou saída para armazenar dados de treinamento ou serviço. No entanto, os contêineres de fala personalizada dependem de montagens de volume.

A sintaxe exata do local da montagem do host varia de acordo com o sistema operacional do host. Além disso, a localização de montagem do computador host pode não estar acessível devido a um conflito entre as permissões usadas pela conta de serviço do Docker e as permissões da localização de montagem do host.

Configurações de montagem de volume

Os contêineres de fala personalizada usam montagens de volume para manter modelos personalizados. Você pode especificar uma montagem de volume adicionando a opção -v (ou --volume) ao comando docker run.

Os modelos personalizados são baixados na primeira vez que um novo modelo é ingerido como parte do comando docker run do contêiner de fala personalizada. As execuções sequenciais do mesmo ModelId para um contêiner de fala personalizada usam o modelo baixado anteriormente. Se a montagem de volume não for fornecida, não haverá persistência dos modelos personalizados.

A configuração de montagem de volume consiste em três campos : separados por cor:

1. O primeiro campo é o nome do volume no computador host, por exemplo, C:\input.
2. O segundo campo é o diretório no contêiner, por exemplo, /usr/local/models.
3. O terceiro campo (opcional) é uma lista de opções separada por vírgulas. Veja mais informações em Usar volumes.

Aqui temos um exemplo de montagem de volume que monta o diretório do computador host C:\input no diretório de contêineres /usr/local/models.

-v C:\input:/usr/local/models

Próximas etapas

• Reveja Como instalar e executar contêineres