Configure recipientes De Estivador de RostoConfigure Face Docker containers

O ambiente de tempo de execução do recipiente Face é configurado utilizando os argumentos de docker run comando.The Face container runtime environment is configured using the docker run command arguments. Este recipiente tem várias configurações necessárias, juntamente com algumas configurações opcionais.This container has several required settings, along with a few optional settings. Vários exemplos do comando estão disponíveis.Several examples of the command are available. As definições específicas do recipiente são as definições de faturação.The container-specific settings are the billing settings.

Definições de configuraçãoConfiguration settings

O recipiente tem as seguintes definições de configuração:The container has the following configuration settings:

NecessárioRequired DefiniçãoSetting ObjetivoPurpose
SimYes ApiKeyApiKey Rastreia a informação de faturação.Tracks billing information.
NãoNo ApplicationInsightsApplicationInsights Permite adicionar suporte de telemetria Azure Application Insights ao seu recipiente.Enables adding Azure Application Insights telemetry support to your container.
SimYes FaturaçãoBilling Especifica o ponto final URI do recurso de serviço no Azure.Specifies the endpoint URI of the service resource on Azure.
SimYes EulaEula Indica que aceitou a licença para o contentor.Indicates that you've accepted the license for the container.
NãoNo FluenteFluentd Escreve registo e, opcionalmente, dados métricos para um servidor Fluente.Writes log and, optionally, metric data to a Fluentd server.
NãoNo HTTP ProxyHTTP Proxy Configura um proxy HTTP para fazer pedidos de saída.Configures an HTTP proxy for making outbound requests.
NãoNo RegistoLogging Fornece ASP.NET suporte de exploração madeireira Core para o seu recipiente.Provides ASP.NET Core logging support for your container.
NãoNo MontesMounts Lê e escreve dados do computador hospedeiro para o recipiente e do recipiente de volta para o computador hospedeiro.Reads and writes data from the host computer to the container and from the container back to the host computer.

Importante

As ApiKey Billingdefinições Eula e as configurações são utilizadas em conjunto, e deve fornecer valores válidos para todos os três; caso contrário, o seu recipiente não arranca.The ApiKey, Billing, and Eula settings are used together, and you must provide valid values for all three of them; otherwise your container won't start. Para obter mais informações sobre a utilização destas definições de configuração para instantaneamente um recipiente, consulte a Faturação.For more information about using these configuration settings to instantiate a container, see Billing.

Definição de configuração ApiKeyApiKey configuration setting

A ApiKey definição especifica a chave de recursos Azure utilizada para rastrear as informações de faturação do recipiente.The ApiKey setting specifies the Azure resource key used to track billing information for the container. Deve especificar um valor para o ApiKey e o valor deve ser uma Billing chave válida para o recurso dos Serviços Cognitivos especificado para a definição de configuração.You must specify a value for the ApiKey and the value must be a valid key for the Cognitive Services resource specified for the Billing configuration setting.

Esta definição pode ser encontrada no seguinte local:This setting can be found in the following place:

  • Portal Azure: Cognitive Services Resource Management, under KeysAzure portal: Cognitive Services Resource Management, under Keys

Definição de ApplicationInsightsApplicationInsights setting

A ApplicationInsights definição permite-lhe adicionar suporte de telemetria Azure Application Insights ao seu recipiente.The ApplicationInsights setting allows you to add Azure Application Insights telemetry support to your container. A Aplicação Insights fornece uma monitorização aprofundada do seu recipiente.Application Insights provides in-depth monitoring of your container. Pode monitorizar facilmente o seu recipiente para disponibilidade, desempenho e utilização.You can easily monitor your container for availability, performance, and usage. Também pode identificar e diagnosticar rapidamente erros no seu recipiente.You can also quickly identify and diagnose errors in your container.

A tabela seguinte descreve as definições de configuração suportadas por baixo da ApplicationInsights secção.The following table describes the configuration settings supported under the ApplicationInsights section.

NecessárioRequired NomeName Tipo de dadosData type DescriçãoDescription
NãoNo InstrumentationKey StringString A chave de instrumentação da instância de Insights de Aplicação para a qual são enviados dados de telemetria para o contentor.The instrumentation key of the Application Insights instance to which telemetry data for the container is sent. Para mais informações, consulte os Insights de Aplicação para ASP.NET Core.For more information, see Application Insights for ASP.NET Core.

Exemplo:Example:
InstrumentationKey=123456789

Definição de configuração de faturaçãoBilling configuration setting

A Billing definição especifica o ponto final URI do recurso Serviços Cognitivos em Azure usado para medir informações de faturação para o recipiente.The Billing setting specifies the endpoint URI of the Cognitive Services resource on Azure used to meter billing information for the container. Deve especificar um valor para esta configuração, e o valor deve ser um uri de ponto final válido para um recurso de Serviços Cognitivos no Azure.You must specify a value for this configuration setting, and the value must be a valid endpoint URI for a Cognitive Services resource on Azure. O recipiente reporta o uso a cada 10 a 15 minutos.The container reports usage about every 10 to 15 minutes.

Esta definição pode ser encontrada no seguinte local:This setting can be found in the following place:

  • Portal Azure: Visão geral dos serviços cognitivos, rotuladaEndpointAzure portal: Cognitive Services Overview, labeled Endpoint

Lembre-se de adicionar o encaminhamento face ao ponto final URI, como mostra o exemplo.Remember to add the Face routing to the endpoint URI as shown in the example.

NecessárioRequired NomeName Tipo de dadosData type DescriçãoDescription
SimYes Billing StringString Ponto final de faturação URI.Billing endpoint URI. Para obter mais informações sobre a obtenção do URI de faturação, consulte a recolha de parâmetros necessários.For more information on obtaining the billing URI, see gathering required parameters. Para mais informações e uma lista completa de pontos finais regionais, consulte nomes de subdomínio personalizado para Serviços Cognitivos.For more information and a complete list of regional endpoints, see Custom subdomain names for Cognitive Services.

Definições de configuração cloudAICloudAI configuration settings

As definições CloudAI de configuração na secção fornecem opções específicas do recipiente únicas para o seu recipiente.The configuration settings in the CloudAI section provide container-specific options unique to your container. As seguintes definições e objetos são CloudAI suportados para o recipiente Face na secçãoThe following settings and objects are supported for the Face container in the CloudAI section

NomeName Tipo de dadosData type DescriçãoDescription
Storage ObjetoObject O cenário de armazenamento usado pelo recipiente Face.The storage scenario used by the Face container. Para obter mais informações sobre cenários Storage de armazenamento e configurações associadas para o objeto, consulte as definições do cenário de armazenamentoFor more information about storage scenarios and associated settings for the Storage object, see Storage scenario settings

Configurações do cenário de armazenamentoStorage scenario settings

O contentor Face armazena blob, cache, metadados e dados de fila, dependendo do que está a ser armazenado.The Face container stores blob, cache, metadata, and queue data, depending on what's being stored. Por exemplo, os índices de formação e os resultados para um grupo de pessoas numerosas são armazenados como dados blob.For example, training indexes and results for a large person group are stored as blob data. O recipiente Face fornece dois cenários de armazenamento diferentes ao interagir e armazenar este tipo de dados:The Face container provides two different storage scenarios when interacting with and storing these types of data:

  • MemóriaMemory
    Todos os quatro tipos de dados são armazenados na memória.All four types of data are stored in memory. Não são distribuídos, nem persistentes.They're not distributed, nor are they persistent. Se o recipiente Face for parado ou removido, todos os dados armazenados para esse recipiente são destruídos.If the Face container is stopped or removed, all of the data in storage for that container is destroyed.
    Este é o cenário de armazenamento padrão para o recipiente Face.This is the default storage scenario for the Face container.
  • AzureAzure
    O recipiente Face utiliza o Azure Storage e o Azure Cosmos DB para distribuir estes quatro tipos de dados através de armazenamento persistente.The Face container uses Azure Storage and Azure Cosmos DB to distribute these four types of data across persistent storage. Os dados de blob e fila são tratados pelo Armazenamento Azure.Blob and queue data is handled by Azure Storage. Os dados de metadados e cache são tratados pela Azure Cosmos DB.Metadata and cache data is handled by Azure Cosmos DB. Se o recipiente Face for parado ou removido, todos os dados armazenados para esse contentor permanecem armazenados em Azure Storage e Azure Cosmos DB.If the Face container is stopped or removed, all of the data in storage for that container remains stored in Azure Storage and Azure Cosmos DB.
    Os recursos utilizados pelo cenário de armazenamento do Azure têm os seguintes requisitos adicionaisThe resources used by the Azure storage scenario have the following additional requirements
    • O recurso de armazenamento Azure deve usar o tipo de conta StorageV2The Azure Storage resource must use the StorageV2 account kind
    • O recurso Azure Cosmos DB deve usar a API do Azure Cosmos DB para MongoDBThe Azure Cosmos DB resource must use the Azure Cosmos DB's API for MongoDB

Os cenários de armazenamento e as configurações de configuração associadas são geridos pelo Storage objeto, sob a secção de CloudAI configuração.The storage scenarios and associated configuration settings are managed by the Storage object, under the CloudAI configuration section. As seguintes definições Storage de configuração estão disponíveis no objeto:The following configuration settings are available in the Storage object:

NomeName Tipo de dadosData type DescriçãoDescription
StorageScenario StringString O cenário de armazenamento suportado pelo recipiente.The storage scenario supported by the container. Os seguintes valores estão disponíveisThe following values are available
Memory- Valor por defeito.Memory - Default value. O recipiente utiliza armazenamento não persistente, não distribuído e em memória, para uso temporário de nó único.Container uses non-persistent, non-distributed and in-memory storage, for single-node, temporary usage. Se o recipiente for parado ou removido, o armazenamento desse recipiente é destruído.If the container is stopped or removed, the storage for that container is destroyed.
Azure- O contentor utiliza recursos Azure para armazenamento.Azure - Container uses Azure resources for storage. Se o recipiente for parado ou removido, o armazenamento desse recipiente é permanecido.If the container is stopped or removed, the storage for that container is persisted.
ConnectionStringOfAzureStorage StringString A corda de ligação para o recurso de armazenamento Azure utilizado pelo recipiente.The connection string for the Azure Storage resource used by the container.
Esta definição só Azure se aplica StorageScenario se for especificada para a definição de configuração.This setting applies only if Azure is specified for the StorageScenario configuration setting.
ConnectionStringOfCosmosMongo StringString A cadeia de ligação MongoDB para o recurso Azure Cosmos DB utilizado pelo recipiente.The MongoDB connection string for the Azure Cosmos DB resource used by the container.
Esta definição só Azure se aplica StorageScenario se for especificada para a definição de configuração.This setting applies only if Azure is specified for the StorageScenario configuration setting.

Por exemplo, o seguinte comando especifica o cenário de armazenamento Azure e fornece cordas de ligação de amostra para os recursos de Armazenamento Azure e Cosmos DB utilizados para armazenar dados para o recipiente Face.For example, the following command specifies the Azure storage scenario and provides sample connection strings for the Azure Storage and Cosmos DB resources used to store data for the Face container.

docker run --rm -it -p 5000:5000 --memory 4g --cpus 1 containerpreview.azurecr.io/microsoft/cognitive-services-face Eula=accept Billing=https://westcentralus.api.cognitive.microsoft.com/face/v1.0 ApiKey=0123456789 CloudAI:Storage:StorageScenario=Azure CloudAI:Storage:ConnectionStringOfCosmosMongo="mongodb://samplecosmosdb:0123456789@samplecosmosdb.documents.azure.com:10255/?ssl=true&replicaSet=globaldb" CloudAI:Storage:ConnectionStringOfAzureStorage="DefaultEndpointsProtocol=https;AccountName=sampleazurestorage;AccountKey=0123456789;EndpointSuffix=core.windows.net"

O cenário de armazenamento é manuseado separadamente dos suportes de entrada e dos suportes de saída.The storage scenario is handled separately from input mounts and output mounts. Pode especificar uma combinação dessas características para um único recipiente.You can specify a combination of those features for a single container. Por exemplo, o seguinte comando define um D:\Output suporte de encaixe do Docker à pasta na máquina hospedeira como a montagem de saída, em seguida, instantaneamente um recipiente da imagem do recipiente Face, guardando ficheiros de registo no formato JSON para o suporte de saída.For example, the following command defines a Docker bind mount to the D:\Output folder on the host machine as the output mount, then instantiates a container from the Face container image, saving log files in JSON format to the output mount. O comando também especifica o cenário de armazenamento Azure e fornece cordas de conexão de amostra para os recursos de Armazenamento Azure e Cosmos DB utilizados para armazenar dados para o recipiente Face.The command also specifies the Azure storage scenario and provides sample connection strings for the Azure Storage and Cosmos DB resources used to store data for the Face container.

docker run --rm -it -p 5000:5000 --memory 4g --cpus 1 --mount type=bind,source=D:\Output,destination=/output containerpreview.azurecr.io/microsoft/cognitive-services-face Eula=accept Billing=https://westcentralus.api.cognitive.microsoft.com/face/v1.0 ApiKey=0123456789 Logging:Disk:Format=json CloudAI:Storage:StorageScenario=Azure CloudAI:Storage:ConnectionStringOfCosmosMongo="mongodb://samplecosmosdb:0123456789@samplecosmosdb.documents.azure.com:10255/?ssl=true&replicaSet=globaldb" CloudAI:Storage:ConnectionStringOfAzureStorage="DefaultEndpointsProtocol=https;AccountName=sampleazurestorage;AccountKey=0123456789;EndpointSuffix=core.windows.net"

Cenário eulaEula setting

A Eula definição indica que aceitou a licença para o contentor.The Eula setting indicates that you've accepted the license for the container. Deve especificar um valor para esta configuração e accepto valor deve ser definido para .You must specify a value for this configuration setting, and the value must be set to accept.

NecessárioRequired NomeName Tipo de dadosData type DescriçãoDescription
SimYes Eula StringString Aceitação da licençaLicense acceptance

Exemplo:Example:
Eula=accept

Os recipientes dos Serviços Cognitivos são licenciados ao abrigo do seu acordo que rege a sua utilização do Azure.Cognitive Services containers are licensed under your agreement governing your use of Azure. Se não tiver um acordo existente que regule a sua utilização do Azure, concorda que o seu acordo que rege a utilização do Azure é o Acordo de Subscrição Onlineda Microsoft , que incorpora os Termos dos Serviços Online.If you do not have an existing agreement governing your use of Azure, you agree that your agreement governing use of Azure is the Microsoft Online Subscription Agreement, which incorporates the Online Services Terms. Para pré-visualizações, também concorda com os Termos Suplementares de Utilização para pré-visualizaçõesdo Microsoft Azure .For previews, you also agree to the Supplemental Terms of Use for Microsoft Azure Previews. Ao utilizar o recipiente, concorda com estes termos.By using the container you agree to these terms.

Configurações fluentesFluentd settings

Fluentd é um colecionador de dados de código aberto para a exploração madeireira unificada.Fluentd is an open-source data collector for unified logging. As Fluentd definições gerem a ligação do recipiente a um servidor Fluente.The Fluentd settings manage the container's connection to a Fluentd server. O recipiente inclui um fornecedor de registos fluente, que permite ao seu recipiente escrever registos e, opcionalmente, dados métricos para um servidor Fluente.The container includes a Fluentd logging provider, which allows your container to write logs and, optionally, metric data to a Fluentd server.

A tabela seguinte descreve as definições de configuração suportadas por baixo da Fluentd secção.The following table describes the configuration settings supported under the Fluentd section.

NomeName Tipo de dadosData type DescriçãoDescription
Host StringString O endereço IP ou o nome de anfitrião dNS do servidor Fluentd.The IP address or DNS host name of the Fluentd server.
Port Número inteiroInteger A porta do servidor Fluentd.The port of the Fluentd server.
O valor padrão é 24224.The default value is 24224.
HeartbeatMs Número inteiroInteger O intervalo do batimento cardíaco, em milissegundos.The heartbeat interval, in milliseconds. Se nenhum tráfego de eventos tiver sido enviado antes deste intervalo expirar, um batimento cardíaco é enviado para o servidor Fluentd.If no event traffic has been sent before this interval expires, a heartbeat is sent to the Fluentd server. O valor predefinido é de 60000 milissegundos (1 minuto).The default value is 60000 milliseconds (1 minute).
SendBufferSize Número inteiroInteger O espaço tampão da rede, em bytes, atribuído para operações de envio.The network buffer space, in bytes, allocated for send operations. O valor predefinido é de 32768 bytes (32 quilobytes).The default value is 32768 bytes (32 kilobytes).
TlsConnectionEstablishmentTimeoutMs Número inteiroInteger O tempo de tempo, em milissegundos, para estabelecer uma ligação SSL/TLS com o servidor Fluentd.The timeout, in milliseconds, to establish a SSL/TLS connection with the Fluentd server. O valor predefinido é de 10000 milissegundos (10 segundos).The default value is 10000 milliseconds (10 seconds).
Se UseTLS for definido como falso, este valor é ignorado.If UseTLS is set to false, this value is ignored.
UseTLS BooleanoBoolean Indica se o recipiente deve utilizar SSL/TLS para comunicar com o servidor Fluentd.Indicates whether the container should use SSL/TLS for communicating with the Fluentd server. O valor predefinido é false.The default value is false.

Definições de credenciais de procuração httpHttp proxy credentials settings

Se precisar de configurar um proxy HTTP para fazer pedidos de saída, utilize estes dois argumentos:If you need to configure an HTTP proxy for making outbound requests, use these two arguments:

NomeName Tipo de dadosData type DescriçãoDescription
HTTP_PROXYHTTP_PROXY stringstring O representante a usar, por exemplo,http://proxy:8888The proxy to use, for example, http://proxy:8888
<proxy-url>
HTTP_PROXY_CREDSHTTP_PROXY_CREDS stringstring Quaisquer credenciais necessárias para autenticar contra o representante, por exemplo, nome de utilizador:palavra-passe.Any credentials needed to authenticate against the proxy, for example, username:password.
<proxy-user> stringstring O utilizador do representante.The user for the proxy.
<proxy-password> stringstring A senha associada <proxy-user> ao representante.The password associated with <proxy-user> for the 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 registoLogging settings

As Logging definições gerem ASP.NET suporte de registo core para o seu recipiente.The Logging settings manage ASP.NET Core logging support for your container. Pode utilizar as mesmas definições e valores de configuração para o seu recipiente que utiliza para uma aplicação core ASP.NET.You can use the same configuration settings and values for your container that you use for an ASP.NET Core application.

Os seguintes fornecedores de exploração madeireira são apoiados pelo contentor:The following logging providers are supported by the container:

FornecedorProvider ObjetivoPurpose
ConsolaConsole O fornecedor Console de exploração madeireira ASP.NET Core.The ASP.NET Core Console logging provider. Todas as configurações de configuração ASP.NET Core e valores predefinidos para este fornecedor de registo são suportados.All of the ASP.NET Core configuration settings and default values for this logging provider are supported.
DepurarDebug O fornecedor Debug de exploração madeireira ASP.NET Core.The ASP.NET Core Debug logging provider. Todas as configurações de configuração ASP.NET Core e valores predefinidos para este fornecedor de registo são suportados.All of the ASP.NET Core configuration settings and default values for this logging provider are supported.
DiskDisk O fornecedor de registo sondo JSON.The JSON logging provider. Este fornecedor de registo escreve dados de registo para o suporte de saída.This logging provider writes log data to the output mount.

Este comando de contentorarma armazena informações de registo no formato JSON para o suporte de saída:This container command stores logging information in the JSON format to the output mount:

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

Este comando de contentores mostra informações de depuração, pré-fixadas com, dbugenquanto o recipiente está em funcionamento:This container command shows debugging information, prefixed with dbug, while the container is running:

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

Exploração de discosDisk logging

O Disk fornecedor de registo suporta as seguintes definições de configuração:The Disk logging provider supports the following configuration settings:

NomeName Tipo de dadosData type DescriçãoDescription
Format StringString O formato de saída para ficheiros de registo.The output format for log files.
Nota: Este valor deve json ser definido para permitir o prestador de registos.Note: This value must be set to json to enable the logging provider. Se este valor for especificado sem especificar também um suporte de saída enquanto se instantaneamente um recipiente, ocorre um erro.If this value is specified without also specifying an output mount while instantiating a container, an error occurs.
MaxFileSize Número inteiroInteger O tamanho máximo, em megabytes (MB), de um ficheiro de registo.The maximum size, in megabytes (MB), of a log file. Quando o tamanho do ficheiro de registo atual se encontra ou excede este valor, um novo ficheiro de registo é iniciado pelo fornecedor de registo.When the size of the current log file meets or exceeds this value, a new log file is started by the logging provider. Se -1 for especificado, o tamanho do ficheiro de registo é limitado apenas pelo tamanho máximo do ficheiro, se houver, para o suporte de saída.If -1 is specified, the size of the log file is limited only by the maximum file size, if any, for the output mount. O valor predefinido é 1.The default value is 1.

Para obter mais informações sobre a configuração ASP.NET suporte de registo core, consulte a configuração do ficheiro Definições.For more information about configuring ASP.NET Core logging support, see Settings file configuration.

Configurações do monteMount settings

Utilize suportes de ligação para ler e escrever dados de e para o recipiente.Use bind mounts to read and write data to and from the container. Pode especificar um suporte de entrada ou --mount montagem de saída especificando a opção no comando de execução do estivador.You can specify an input mount or output mount by specifying the --mount option in the docker run command.

Os recipientes Face não utilizam suportes de entrada ou saída para armazenar dados de treino ou de serviço.The Face containers don't use input or output mounts to store training or service data.

A sintaxe exata da localização do suporte do hospedeiro varia consoante o sistema operativo do hospedeiro.The exact syntax of the host mount location varies depending on the host operating system. Além disso, a localização do suporte do computador hospedeiropode não estar acessível devido a um conflito entre permissões utilizadas pela conta de serviço Docker e as permissões de localização do suporte do hospedeiro.Additionally, the host computer's mount location may not be accessible due to a conflict between permissions used by the Docker service account and the host mount location permissions.

OpcionalOptional NomeName Tipo de dadosData type DescriçãoDescription
Não permitidoNot allowed Input StringString Os recipientes faciais não usam isto.Face containers do not use this.
OpcionalOptional Output StringString O alvo do suporte de saída.The target of the output mount. O valor predefinido é /output.The default value is /output. Esta é a localização dos registos.This is the location of the logs. Isto inclui troncos de contentores.This includes container logs.

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

Comandos de execução de estivadores exemploExample docker run commands

Os exemplos seguintes utilizam as definições docker run de configuração para ilustrar como escrever e utilizar comandos.The following examples use the configuration settings to illustrate how to write and use docker run commands. Uma vez em funcionamento, o recipiente continua a funcionar até o parar.Once running, the container continues to run until you stop it.

  • Personagem de continuação da linha: Os comandos \do Docker nas seguintes secções usam o corte traseiro, como um personagem de continuação da linha.Line-continuation character: The Docker commands in the following sections use the back slash, \, as a line continuation character. Substitua ou remova isto com base nos requisitos do sistema operativo do hospedeiro.Replace or remove this based on your host operating system's requirements.
  • Ordem de argumentação: Não altere a ordem dos argumentos a menos que esteja muito familiarizado com os contentores do Docker.Argument order: Do not change the order of the arguments unless you are very familiar with Docker containers.

Substitua {argument_name} com os seus próprios valores:Replace {argument_name} with your own values:

Marcador de posiçãoPlaceholder ValorValue Formato ou exemploFormat or example
{API_KEY}{API_KEY} A chave final Face do recurso na Face página Azure Keys.The endpoint key of the Face resource on the Azure Face Keys page. xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
{ENDPOINT_URI}{ENDPOINT_URI} O valor final da faturação está Face disponível na página de visão geral do Azure.The billing endpoint value is available on the Azure Face Overview page. Consulte a recolha de parâmetros necessários para exemplos explícitos.See gathering required parameters for explicit examples.

Nota

Os novos recursos criados após 1 de julho de 2019, usarão nomes de subdomínios personalizados.New resources created after July 1, 2019, will use custom subdomain names. Para obter mais informações e uma lista completa de pontos finais regionais, consulte os nomes de subdomínio personalizados para serviços cognitivos.For more information and a complete list of regional endpoints, see Custom subdomain names for Cognitive Services.

Importante

A Eula Billing, ApiKey e as opções devem ser especificadas para executar o recipiente; caso contrário, o contentor não vai começar.The Eula, Billing, and ApiKey options must be specified to run the container; otherwise, the container won't start. Para mais informações, consulte billing.For more information, see Billing. O valor ApiKey Key é a Cognitive Services chave da página de teclas Azure Resource.The ApiKey value is the Key from the Azure Cognitive Services Resource keys page.

Face container Exemplos de DockerFace container Docker examples

Os seguintes exemplos do Docker são para o recipiente facial.The following Docker examples are for the face container.

Exemplo básicoBasic example

docker run --rm -it -p 5000:5000 --memory 4g --cpus 1 \
containerpreview.azurecr.io/microsoft/cognitive-services-face \
Eula=accept \
Billing={ENDPOINT_URI} \
ApiKey={API_KEY} 

Exemplo de registoLogging example

docker run --rm -it -p 5000:5000 --memory 4g --cpus 1 containerpreview.azurecr.io/microsoft/cognitive-services-face \
Eula=accept \
Billing={ENDPOINT_URI} ApiKey={API_KEY} \
Logging:Console:LogLevel:Default=Information

Passos seguintesNext steps