Configurar recipientes de estiva de serviço de línguas

O serviço linguístico fornece a cada recipiente uma estrutura de configuração comum, para que possa configurar e gerir facilmente o armazenamento, registo e telemetria e as definições de segurança para os seus contentores. Este artigo aplica-se aos seguintes recipientes:

  • análise de sentimento
  • deteção de linguagem
  • extração de frase-chave
  • Análise de Texto para a saúde

Definições de configuração

O recipiente tem as seguintes definições de configuração:

Necessário Definição Objetivo
Yes ApiKey Rastreia informações de faturação.
No ApplicationInsights Permite adicionar Aplicação Azure Informações suporte de telemetria ao seu recipiente.
Yes Faturação Especifica o ponto final URI do recurso de serviço no Azure.
Yes Eula Indica que aceitou a licença para o contentor.
No Fluente Escreve registo e, opcionalmente, dados métricos para um servidor Fluentd.
No HTTP Proxy Configura um representante HTTP para fazer pedidos de saída.
No Registo Fornece ASP.NET Core suporte de registo para o seu recipiente.
No Montes Lê e escreve dados do computador anfitrião para o recipiente e do recipiente de volta para o computador anfitrião.

Importante

As ApiKeyconfigurações , Billinge configurações Eula são utilizadas em conjunto, e deve fornecer valores válidos para os três; caso contrário, o seu recipiente não arranca.

Definição de configuração ApiKey

A ApiKey definição especifica a chave de recursos Azure utilizada para rastrear as informações de faturação do recipiente. Tem de especificar um valor para a tecla e deve ser uma chave válida para o recurso idioma especificado para a definição de Billing configuração.

Configuração de AplicaçõesInsights

A ApplicationInsights definição permite-lhe adicionar Aplicação Azure Informações suporte de telemetria ao seu recipiente. A aplicação Informações fornece uma monitorização aprofundada do seu recipiente. Pode monitorizar facilmente o seu recipiente para disponibilidade, desempenho e utilização. Também pode identificar e diagnosticar rapidamente erros no seu recipiente.

A tabela seguinte descreve as definições de configuração suportadas na ApplicationInsights secção.

Obrigatório Name Tipo de dados Descrição
Não InstrumentationKey String A chave de instrumentação do pedido Informações exemplo para a qual são enviados dados de telemetria para o contentor. Para mais informações, consulte Informações de aplicação para ASP.NET Core.

Exemplo:
InstrumentationKey=123456789

Definição de configuração de faturação

A Billing definição especifica o ponto final URI do recurso idioma no Azure utilizado para medir as informações de faturação para o recipiente. Tem de especificar um valor para esta definição de configuração, e o valor deve ser um URI de ponto final válido para um recurso idioma no Azure. O recipiente relata o uso a cada 10 a 15 minutos.

Obrigatório Name Tipo de dados Descrição
Sim Billing String URI de faturação.

Definição de Eula

A Eula definição indica que aceitou a licença para o contentor. Tem de especificar um valor para esta definição de configuração e o valor deve ser definido para accept.

Obrigatório Name Tipo de dados Descrição
Sim Eula String Aceitação de licença

Exemplo:
Eula=accept

Os contentores dos Serviços Cognitivos são licenciados ao abrigo do seu acordo que rege o seu uso do Azure. Se não tiver um acordo existente que regule o seu uso do Azure, concorda que o seu acordo que rege a utilização do Azure é o Microsoft Online Subscription Agreement, que incorpora os Termos de Serviços Online. Para pré-visualizações, também concorda com os Termos Complementares de Utilização para pré-visualizações Microsoft Azure. Ao utilizar o recipiente, concorda com estes termos.

Configurações fluentes

Fluentd é um colecionador de dados de código aberto para registos de registos unificados. As Fluentd definições gerem a ligação do contentor a um servidor Fluentd . O recipiente inclui um fornecedor de registo fluente, que permite ao seu recipiente escrever registos e, opcionalmente, dados métricos para um servidor Fluentd.

A tabela seguinte descreve as definições de configuração suportadas na Fluentd secção.

Name Tipo de dados Descrição
Host String O endereço IP ou o nome de anfitrião DNS do servidor Fluentd.
Port Número inteiro A porta do servidor Fluentd.
O valor predefinido é 24224.
HeartbeatMs Número inteiro O intervalo do batimento cardíaco, em milissegundos. Se não tiver sido enviado tráfego de eventos antes de este intervalo expirar, é enviado um batimento cardíaco para o servidor Fluentd. O valor predefinido é de 60000 milissegundos (1 minuto).
SendBufferSize Número inteiro O espaço tampão da rede, em bytes, alocado para operações de envio. O valor predefinido é de 32768 bytes (32 quilobytes).
TlsConnectionEstablishmentTimeoutMs Número inteiro O tempo limite, em milissegundos, para estabelecer uma ligação SSL/TLS com o servidor Fluentd. O valor predefinido é de 10000 milissegundos (10 segundos).
Se UseTLS for definido como falso, este valor é ignorado.
UseTLS Booleano Indica se o recipiente deve utilizar SSL/TLS para comunicar com o servidor Fluentd. O valor predefinido é false.

Definições de credenciais de procuração http

Se precisar de configurar um representante HTTP para fazer pedidos de saída, utilize estes dois argumentos:

Name Tipo de dados Descrição
HTTP_PROXY string O representante para usar, por exemplo, http://proxy:8888
<proxy-url>
HTTP_PROXY_CREDS string Quaisquer credenciais necessárias para autenticar contra o representante, por exemplo, username:password. Este valor deve ser em minúsculas.
<proxy-user> string O utilizador do representante.
<proxy-password> string A palavra-passe associada <proxy-user> ao representante.
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> \

Definições de registo

As Logging definições gerem ASP.NET Core suporte de registo do seu recipiente. Pode utilizar as mesmas definições e valores de configuração para o seu recipiente que utiliza para uma aplicação ASP.NET Core.

Os seguintes prestadores de serviços de exploração madeireira são suportados pelo contentor:

Fornecedor Objetivo
Consola O fornecedor de registo de ASP.NET CoreConsole. Todas as definições de configuração ASP.NET Core e valores predefinidos para este fornecedor de registos são suportados.
Depurar O fornecedor de registo de ASP.NET CoreDebug. Todas as definições de configuração ASP.NET Core e valores predefinidos para este fornecedor de registos são suportados.
Disco O provedor de registo JSON. Este fornecedor de registos escreve dados de registo para o suporte de saída.

Este comando de contentor armazena informações no formato JSON para o suporte 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 do contentor mostra informações de depurar, prefixadas com dbug, enquanto o contentor está em funcionamento:

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

Registo de discos

O Disk fornecedor de registos suporta as seguintes definições de configuração:

Name Tipo de dados Descrição
Format String O formato de saída para ficheiros de registo.
Nota: Este valor deve ser definido para json permitir ao fornecedor de registos. Se este valor for especificado sem especificar também um suporte de saída durante a instantânea de um recipiente, ocorre um erro.
MaxFileSize Número inteiro O tamanho máximo, em megabytes (MB), de um ficheiro de log. Quando o tamanho do ficheiro de registo atual se encontra ou excede este valor, um novo ficheiro de registo é iniciado pelo fornecedor de registo. Se for especificado -1, o tamanho do ficheiro de registo é limitado apenas pelo tamanho máximo do ficheiro, se houver, para o suporte de saída. O valor predefinido é 1.

Para obter mais informações sobre a configuração ASP.NET Core suporte de registo, consulte Definições configuração do ficheiro.

Configurações de montagem

Utilize suportes de ligação para ler e escrever dados de e para o recipiente. Pode especificar um suporte de entrada ou de saída especificando a opção --mount no comando de execução do estivador .

Os recipientes de serviço de idioma não utilizam suportes de entrada ou saída para armazenar dados de treino ou de serviço.

A sintaxe exata da localização do suporte do hospedeiro varia consoante o sistema operativo hospedeiro. Além disso, a localização do suporte do computador anfitrião pode não estar acessível devido a um conflito entre permissões usadas pela conta de serviço do estivador e as permissões de localização do anfitrião.

Opcional Name Tipo de dados Descrição
Não permitido Input String Os recipientes de serviço linguístico não o utilizam.
Opcional Output String O alvo do suporte de saída. O valor predefinido é /output. Esta é a localização dos registos. Isto inclui registos de contentores.

Exemplo:
--mount type=bind,src=c:\output,target=/output

Passos seguintes