Configurar contêineres do Docker do Tradutor
Os serviços de IA do Azure fornecem a cada contêiner uma estrutura de configuração comum. Você pode configurar facilmente seus contêineres de Tradução e criar a arquitetura de aplicativos de Tradução otimizada para recursos robustos de nuvem e localidade de borda.
O ambiente de runtime do contêiner de Tradutor é configurado usando argumentos do comando docker run. Há configurações obrigatórias e opcionais para este contêiner. As configurações específicas do contêiner obrigatórias são as configurações de cobrança.
Definições de configuração
O contêiner tem as seguintes configurações:
| Obrigatório | Configuração | Finalidade |
|---|---|---|
| Sim | ApiKey | Rastreia informações de cobrança. |
| Não | ApplicationInsights | Permite a adição de suporte telemétrico do Azure Application Insights para seu contêiner. |
| Sim | Billing | Especifica o URI do ponto de extremidade do recurso de serviços no Azure. |
| Sim | EULA | Indica que você aceitou o EULA (contrato de licença de usuário final) para o contêiner. |
| Não | Fluentd | Grava log e, opcionalmente, dados telemétricos em um servidor do Fluentd. |
| Não | Proxy HTTP | Configura um proxy HTTP para fazer solicitações de saída. |
| Não | Logging | Fornece suporte a registro de log do ASP.NET Core para seu contêiner. |
| Sim | Mounts | Lê e grava dados do computador host para o contêiner e do contêiner de volta para o computador host. |
Importante
As configurações ApiKey, Faturamento e EULA são usadas juntas e você deve fornecer valores válidos para todos os três; caso contrário, seu contêiner não será iniciado. Para obter mais informações sobre como usar essas configurações para instanciar um contêiner.
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 Tradução especificado para a configuração Billing.
Essa configuração pode ser localizada no seguinte local:
- Portal do Azure: gerenciamento de recursos de Tradutor, 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.
| Obrigatório | Nome | Tipo de dados | Descrição |
|---|---|---|---|
| Não | InstrumentationKey |
String | A chave de instrumentação da instância do Application Insights para o qual telemetria de dados para o contêiner são enviados. Para obter mais informações, consulte Application Insights para ASP.NET Core. Exemplo: InstrumentationKey=123456789 |
Definição de configuração de cobrança
A configuração Billing especifica o URI de ponto de extremidade do recurso de Tradutor 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 Tradutor 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: página visão geral do Tradutor rotulada
Endpoint
| Obrigatório | Nome | Tipo de dados | Descrição |
|---|---|---|---|
| Sim | Billing |
String | URI do ponto de extremidade de cobrança. Para mais informações sobre como obter o URI de cobrança, confira como coletar parâmetros necessários. Para obter mais informações e uma lista completa de pontos de extremidade regionais, confira Nomes de subdomínio personalizados para os serviços de IA do Azure. |
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.
| Obrigatório | Nome | Tipo de dados | Descrição |
|---|---|---|---|
| Sim | Eula |
String | Aceitação da licença Exemplo: Eula=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.
| Nome | Tipo de dados | Descrição |
|---|---|---|
Host |
String | O endereço IP ou o nome do host DNS do servidor Fluentd. |
Port |
Integer | A porta do servidor Fluentd. O valor padrão é 24224. |
HeartbeatMs |
Integer | O intervalo de pulsação, em milissegundos. Se nenhum tráfego de evento tiver sido enviado antes que esse intervalo expire, uma pulsação será enviada ao servidor Fluentd. O valor padrão é 60.000 milissegundos (1 minuto). |
SendBufferSize |
Integer | O espaço de buffer de rede, em bytes, alocado para operações de envio. O valor padrão é 32768 bytes (32 kilobytes). |
TlsConnectionEstablishmentTimeoutMs |
Integer | O tempo de limite, em milissegundos, para estabelecer uma conexão SSL/TLS com o servidor do Fluentd. O valor padrão é 10.000 milissegundos (10 segundos). Se UseTLS for definido como false, esse valor é ignorado. |
UseTLS |
Boolean | Indica se o contêiner deve usar SSL / TLS para se comunicar com o servidor Fluentd. O valor padrão é falso. |
Configurações de credenciais de proxy HTTP/HTTPS
Se você precisar configurar um proxy HTTP para fazer solicitações de saída, use estes dois argumentos:
| Nome | Tipo de dados | Descrição |
|---|---|---|
| HTTPS_PROXY | string | O URL do proxy, por exemplo, https://proxy:8888 |
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> \
HTTPS_PROXY=<proxy-url>
Configurações de log
Os contêineres do tradutor dão suporte aos seguintes provedores de log:
| Provedor | Finalidade |
|---|---|
| Console | O ASP.NET Core Console provedor de log. Todas as definições de configuração do ASP.NET Core e os valores padrão desse provedor de log são suportados. |
| Depurar | O ASP.NET Core Debug provedor de log. Todas as definições de configuração do ASP.NET Core e os valores padrão desse provedor de log são suportados. |
| Disco | O provedor de log do JSON. Esse provedor de log grava dados de log na montagem de saída. |
As configurações
Logginggerenciam 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.O
Logging.LogLevelespecifica o nível mínimo a ser registrado. A gravidade daLogLevelvaria de 0 a 6. Quando umLogLevelé especificado, o registro em log é habilitado para mensagens no nível especificado e superior: Rastreamento = 0, Depuração = 1, Informações = 2, Aviso = 3, Erro = 4, Crítico = 5, Nenhum = 6.Atualmente, os contêineres do Tradutor têm a capacidade de restringir logs no Aviso LogLevel ou superior.
A sintaxe de comando geral para registro em log é a seguinte:
-Logging:LogLevel:{Provider}={FilterSpecs}
O comando a seguir inicia o contêiner do Docker com o LogLevel definido como Aviso e o provedor de registro em log definidos como Console. Esse comando imprime eventos anômalos ou inesperados durante o fluxo do aplicativo para o console:
docker run --rm -it -p 5000:5000
-v /mnt/d/TranslatorContainer:/usr/local/models \
-e apikey={API_KEY} \
-e eula=accept \
-e billing={ENDPOINT_URI} \
-e Languages=en,fr,es,ar,ru \
-e Logging:LogLevel:Console="Warning"
mcr.microsoft.com/azure-cognitive-services/translator/text-translation:latest
Registro em log do Disk
O provedor de registro Disk suporta as seguintes configurações:
| Nome | Tipo de dados | Descrição |
|---|---|---|
Format |
String | O formato de saída para arquivos de log. Nota: Esse valor deve ser definido como json para ativar o provedor de registro. Se esse valor for especificado sem especificar também uma montagem de saída durante a instanciação de um contêiner, ocorrerá um erro. |
MaxFileSize |
Integer | O tamanho máximo, em megabytes (MB), de um arquivo de log. Quando o tamanho do arquivo de log atual atende ou excede esse valor, o provedor de log inicia um novo arquivo de log. Se -1 for especificado, o tamanho do arquivo de log será limitado apenas pelo tamanho máximo do arquivo, se houver, para a montagem de saída. O valor padrão é 1. |
Exemplo do provedor de disco
docker run --rm -it -p 5000:5000 \
--memory 2g --cpus 1 \
--mount type-bind,src=/home/azureuser/output,target=/output \
-e apikey={API_KEY} \
-e eula=accept \
-e billing={ENDPOINT_URI} \
-e Languages=en,fr,es,ar,ru \
Eula=accept \
Billing=<endpoint> \
ApiKey=<api-key> \
Logging:Disk:Format=json \
Mounts:Output=/output
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.