Configurar contêineres do Docker de OCR de leitura

Você pode configurar o ambiente de tempo de execução do contêiner do Azure AI Vision Read OCR usando os argumentos de docker run comando. Este contêiner tem várias configurações necessárias, juntamente com algumas configurações opcionais. Vários exemplos do comando estão disponíveis. As configurações específicas do contêiner são as configurações de faturamento.

Definições de configuração

O contêiner tem as seguintes definições de configuração:

O contêiner também tem as seguintes definições de configuração específicas do contêiner:

Definição de configuração ApiKey

A ApiKey configuração especifica a chave de recurso Visão usada para controlar as informações de faturamento do contêiner. Você deve especificar um valor para ApiKey e o valor deve ser uma chave válida para o recurso Vision especificado para a definição de Billing configuração.

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

• Portal do Azure: Gerenciamento de Recursos de Serviços de IA do Azure, em Chaves

Configuração do ApplicationInsights

A ApplicationInsights configuração permite que você adicione suporte à telemetria do Azure Application Insights ao seu contêiner. O Application Insights fornece monitoramento detalhado do seu contêiner. Você pode facilmente monitorar seu contêiner quanto à disponibilidade, desempenho e uso. Você também pode identificar e diagnosticar rapidamente erros em seu contêiner.

A tabela a seguir descreve as definições de configuração suportadas ApplicationInsights na seção .

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

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

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

• Portal do Azure: Visão geral dos serviços de IA do Azure, rotulada Endpoint

Lembre-se de adicionar o vision/<version> roteamento ao URI do ponto de extremidade, conforme mostrado na tabela a seguir.

Configuração de Eula

A Eula configuração 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 de serviços de IA do Azure são licenciados sob seu contrato que rege seu uso do Azure. Se não tiver um contrato existente que regule a sua utilização do Azure, concorda que o seu 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 visualizações, você também concorda com os Termos de Uso Suplementares para Visualizações do Microsoft Azure. Ao usar o contêiner, você concorda com estes termos.

Configurações fluentes

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

A tabela a seguir descreve as definições de configuração suportadas Fluentd na seção .

Configurações de 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> \

Definições de registo

As Logging configurações gerenciam ASP.NET suporte de log principal para seu contêiner. Você pode usar as mesmas definições de configuração e valores para seu contêiner que você usa para um aplicativo ASP.NET Core.

Os seguintes provedores de log são suportados pelo contêiner:

Este comando container armazena informações de 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 container 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

Registo de discos

O Disk provedor de log suporta as seguintes definições de configuração:

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

Configurações de montagem

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

Os contêineres do Azure AI Vision não usam montagens de entrada ou saída para armazenar dados de treinamento ou serviço.

A sintaxe exata do local de montagem do host varia dependendo do sistema operacional do host. Além disso, o local 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 de local de montagem do host.

Exemplo de comandos de execução do docker

Os exemplos a seguir usam as definições de configuração para ilustrar como escrever e usar docker run comandos. Uma vez em execução, o contêiner continua a ser executado até que você o pare .

• Caractere de continuação de linha: Os comandos do Docker nas seções a seguir usam a barra invertida, \, como um caractere de continuação de linha. Substitua ou remova isso com base nos requisitos do sistema operacional do host.
• Ordem dos argumentos: não altere a ordem dos argumentos, a menos que esteja muito familiarizado com os contêineres do Docker.

Substitua {argument_name} pelos seus próprios valores:

Exemplos de Docker de contêiner

Os exemplos do Docker a seguir são para o contêiner Read OCR.

docker run --rm -it -p 5000:5000 --memory 16g --cpus 8 \
mcr.microsoft.com/azure-cognitive-services/vision/read:3.2-model-2022-04-30 \
Eula=accept \
Billing={ENDPOINT_URI} \
ApiKey={API_KEY}

docker run --rm -it -p 5000:5000 --memory 16g --cpus 8 \
mcr.microsoft.com/azure-cognitive-services/vision/read:3.2-model-2022-04-30 \
Eula=accept \
Billing={ENDPOINT_URI} \
ApiKey={API_KEY}
Logging:Console:LogLevel:Default=Information

docker run --rm -it -p 5000:5000 --memory 16g --cpus 8 \
mcr.microsoft.com/azure-cognitive-services/vision/read:2.0-preview \
Eula=accept \
Billing={ENDPOINT_URI} \
ApiKey={API_KEY}

docker run --rm -it -p 5000:5000 --memory 16g --cpus 8 \
mcr.microsoft.com/azure-cognitive-services/vision/read:2.0-preview \
Eula=accept \
Billing={ENDPOINT_URI} \
ApiKey={API_KEY}
Logging:Console:LogLevel:Default=Information

Próximos passos

• Consulte Como instalar e executar contêineres.