Configurar Análise de Texto para contentores docker de estado de funcionamento

  • Artigo

Análise de Texto para o estado de funcionamento fornece a cada contentor uma estrutura de configuração comum, para que possa configurar e gerir facilmente o armazenamento, o registo e a telemetria e as definições de segurança dos contentores. Estão também disponíveis vários comandos de execução do Docker de exemplo .

Definições de configuração

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

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

Importante

As ApiKeydefinições , Billinge Eula são utilizadas em conjunto e tem de fornecer valores válidos para os três. Caso contrário, o contentor não será iniciado. Para obter mais informações sobre como utilizar estas definições de configuração para instanciar um contentor, veja Faturação.

Definição de configuração ApiKey

A ApiKey definição especifica a chave de recurso do Azure utilizada para controlar as informações de faturação do contentor. Tem de especificar um valor para a ApiKey e o valor tem de ser uma chave válida para o recurso Idioma especificado para a definição de Billing configuração.

Esta definição pode ser encontrada no seguinte local:

  • portal do Azure: Gestão de recursos de idiomas, em Chaves e ponto final

Definição do ApplicationInsights

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

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 da instância do Application Insights para a qual são enviados dados telemétricos para o contentor. Para obter mais informações, veja Application Insights para ASP.NET Core.

Exemplo:
InstrumentationKey=123456789

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

A Billing definição especifica o URI do ponto final do recurso Idioma no Azure utilizado para medir as informações de faturação do contentor. Tem de especificar um valor para esta definição de configuração e o valor tem de ser um URI de ponto final válido para um recurso de Idioma no Azure. O contentor comunica a utilização a cada 10 a 15 minutos.

Esta definição pode ser encontrada no seguinte local:

  • portal do Azure: Descrição Geral do Idioma, etiquetadaEndpoint
Obrigatório Name Tipo de dados Descrição
Sim Billing String URI do ponto final de faturação. Para obter mais informações sobre como obter o URI de faturação, veja Reunir os parâmetros necessários. Para obter mais informações e uma lista completa dos pontos finais regionais, veja Nomes de subdomínio personalizados para serviços de IA do Azure.

Definição de Eula

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

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

Exemplo:
Eula=accept

Os contentores dos serviços de IA do Azure são licenciados ao abrigo do contrato que rege a sua utilização do Azure. Se não tiver um contrato existente que regule a sua utilização do Azure, concorda que o contrato que rege a utilização do Azure é o Contrato de Subscrição Online da Microsoft, que incorpora os Termos dos Serviços Online. Para pré-visualizações, também concorda com os Termos de Utilização Suplementares para Pré-visualizações do Microsoft Azure. Ao utilizar o contentor, concorda com estes termos.

Definições fluentes

Fluentd é um recoletor de dados open source para registos unificados. As Fluentd definições gerem a ligação do contentor a um servidor Fluentd . O contentor inclui um fornecedor de registo Fluentd, que permite ao contentor escrever registos e, opcionalmente, dados de métricas num servidor Fluentd.

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

Name Tipo de dados Description
Host String O endereço IP ou o nome do 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 de heartbeat, em milissegundos. Se não tiver sido enviado tráfego de eventos antes de este intervalo expirar, será enviado um heartbeat para o servidor Fluentd. O valor predefinido é 60000 milissegundos (1 minuto).
SendBufferSize Número inteiro O espaço de memória intermédia de rede, em bytes, alocado para operações de envio. O valor predefinido é 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 é 10000 milissegundos (10 segundos).
Se UseTLS estiver definido como falso, este valor é ignorado.
UseTLS Booleano Indica se o contentor deve utilizar SSL/TLS para comunicar com o servidor Fluentd. O valor predefinido é false.

Definições de credenciais de proxy http

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

Name Tipo de dados Descrição
HTTP_PROXY string O proxy a utilizar, por exemplo, http://proxy:8888
<proxy-url>
HTTP_PROXY_CREDS string Todas as credenciais necessárias para autenticar no proxy, por exemplo, username:password. Este valor tem de estar em minúsculas.
<proxy-user> string O utilizador do proxy.
<proxy-password> string A palavra-passe associada <proxy-user> ao proxy. 
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 para o contentor. Pode utilizar as mesmas definições e valores de configuração para o contentor que utiliza para uma aplicação ASP.NET Core.

Os seguintes fornecedores de registo são suportados pelo contentor:

Fornecedor Objetivo
Consola O fornecedor de registo ASP.NET CoreConsole. São suportadas todas as definições de configuração ASP.NET Core e os valores predefinidos para este fornecedor de registos.
Depurar O fornecedor de registo ASP.NET CoreDebug. São suportadas todas as definições de configuração ASP.NET Core e os valores predefinidos para este fornecedor de registos.
Disco O fornecedor de registoS JSON. Este fornecedor de registos escreve dados de registo na montagem de saída.

Este comando de contentor armazena informações de registo 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 contentor mostra informações de depuração, com o prefixo dbug, enquanto o contentor 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

Registo de discos

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

Name Tipo de dados Description
Format String O formato de saída dos ficheiros de registo.
Nota: Este valor tem de ser definido para json ativar o fornecedor de registos. Se este valor for especificado sem especificar também uma montagem de saída ao instanciar um contentor, ocorre um erro.
MaxFileSize Número inteiro O tamanho máximo, em megabytes (MB), de um ficheiro de registo. Quando o tamanho do ficheiro de registo atual cumpre ou excede este valor, um novo ficheiro de registo é iniciado pelo fornecedor de registos. Se -1 for especificado, o tamanho do ficheiro de registo é limitado apenas pelo tamanho máximo do ficheiro, se existir, para a montagem de saída. O valor predefinido é 1.

Para obter mais informações sobre como configurar ASP.NET Core suporte de registo, veja Configuração do ficheiro definições.

Definições de montagem

Utilize montagens de enlace para ler e escrever dados de e para o contentor. Pode especificar uma montagem de entrada ou montagem de saída ao especificar a opção --mount no comando docker run .

Análise de Texto para contentores de estado de funcionamento não utilizam montagens de entrada ou saída para armazenar dados de preparação ou de serviço.

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

Opcional Name Tipo de dados Descrição
Não permitido Input String Análise de Texto para contentores de estado de funcionamento não o utilizem.
Opcional Output String O destino da montagem 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