Configurer des conteneurs Docker VisageConfigure Face Docker containers

L’environnement d’exécution de conteneur Visage est configuré à l’aide des arguments de la commande docker run.The Face container runtime environment is configured using the docker run command arguments. Ce conteneur a plusieurs paramètres obligatoires et quelques paramètres facultatifs.This container has several required settings, along with a few optional settings. Plusieurs exemples de commande sont disponibles.Several examples of the command are available. Les paramètres propres aux conteneurs correspondent aux paramètres de facturation.The container-specific settings are the billing settings.

Paramètres de configurationConfiguration settings

Le conteneur a les paramètres de configuration suivants :The container has the following configuration settings:

ObligatoireRequired ParamètreSetting ObjectifPurpose
OUIYes ApiKeyApiKey Assure le suivi des informations de facturation.Tracks billing information.
NonNo ApplicationInsightsApplicationInsights Permet d’ajouter la prise en charge de la télémétrie Azure Application Insights à votre conteneur.Enables adding Azure Application Insights telemetry support to your container.
OUIYes BillingBilling Spécifie l’URI de point de terminaison de la ressource de service sur Azure.Specifies the endpoint URI of the service resource on Azure.
OUIYes EulaEula Indique que vous avez accepté la licence pour le conteneur.Indicates that you've accepted the license for the container.
NonNo FluentdFluentd Écrit les données des journaux et, éventuellement, des métriques, sur un serveur Fluentd.Writes log and, optionally, metric data to a Fluentd server.
NonNo Proxy HTTPHttp Proxy Configure un proxy HTTP pour effectuer des requêtes sortantes.Configures an HTTP proxy for making outbound requests.
NonNo LoggingLogging Fournit la prise en charge de la journalisation ASP.NET Core pour votre conteneur.Provides ASP.NET Core logging support for your container.
NonNo MountsMounts Lit et écrit des données de l’ordinateur hôte sur le conteneur, et du conteneur sur l’ordinateur hôte.Reads and writes data from the host computer to the container and from the container back to the host computer.

Important

Les paramètres ApiKey, Billing et Eula sont utilisés conjointement, et vous devez fournir des valeurs valides pour les trois ; à défaut, votre conteneur ne démarrera pas.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. Pour plus d’informations sur l’instanciation d’un conteneur à l’aide de ces paramètres de configuration, consultez Facturation.For more information about using these configuration settings to instantiate a container, see Billing.

Paramètre de configuration ApiKeyApiKey configuration setting

Le paramètre ApiKey spécifie la clé de ressource Azure utilisée pour effectuer le suivi des informations de facturation pour le conteneur.The ApiKey setting specifies the Azure resource key used to track billing information for the container. Vous devez donner une valeur à ApiKey, qui doit être une clé valide pour la ressource Cognitive Services spécifiée dans le paramètre de configuration Billing.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.

Vous trouverez ce paramètre à l’emplacement suivant :This setting can be found in the following place:

  • Portail Azure : Gestion des ressources Cognitive Services, sous ClésAzure portal: Cognitive Services Resource Management, under Keys

Paramètre ApplicationInsightsApplicationInsights setting

Le paramètre ApplicationInsights vous permet d’ajouter la prise en charge de la télémétrie Azure Application Insights à votre conteneur.The ApplicationInsights setting allows you to add Azure Application Insights telemetry support to your container. Application Insights assure une supervision approfondie de votre conteneur.Application Insights provides in-depth monitoring of your container. Vous pouvez facilement superviser la disponibilité, les performances et l’utilisation de votre conteneur.You can easily monitor your container for availability, performance, and usage. De plus, vous pouvez identifier et diagnostiquer rapidement les erreurs dans votre conteneur.You can also quickly identify and diagnose errors in your container.

Le tableau suivant décrit les paramètres de configuration pris en charge sous la section ApplicationInsights.The following table describes the configuration settings supported under the ApplicationInsights section.

ObligatoireRequired NomName Type de donnéesData type DescriptionDescription
NonNo InstrumentationKey ChaîneString Clé d’instrumentation de l’instance Application Insights à laquelle les données de télémétrie du conteneur sont envoyées.The instrumentation key of the Application Insights instance to which telemetry data for the container is sent. Pour plus d’informations, consultez Application Insights pour ASP.NET Core.For more information, see Application Insights for ASP.NET Core.

Exemple :Example:
InstrumentationKey=123456789

Paramètre de configuration BillingBilling configuration setting

Le paramètre Billing permet de spécifier l’URI de point de terminaison de la ressource Cognitive Services sur Azure servant à effectuer l’analyse des informations de facturation du conteneur.The Billing setting specifies the endpoint URI of the Cognitive Services resource on Azure used to meter billing information for the container. Vous devez donner une valeur à ce paramètre de configuration, qui doit être un URI de point de terminaison valide pour une ressource Cognitive Services dans 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. Le conteneur crée des rapports sur l’utilisation toutes les 10 à 15 minutes.The container reports usage about every 10 to 15 minutes.

Vous trouverez ce paramètre à l’emplacement suivant :This setting can be found in the following place:

  • Portail Azure : Vue d’ensemble Cognitive Services, étiquetée EndpointAzure portal: Cognitive Services Overview, labeled Endpoint

Pensez à ajouter le routage Visage à l’URI de point de terminaison, comme dans l’exemple suivant.Remember to add the Face routing to the endpoint URI as shown in the example.

ObligatoireRequired NomName Type de donnéesData type DescriptionDescription
OUIYes Billing ChaîneString URI du point de terminaison de facturationBilling endpoint URI

Exemple :Example:
Billing=https://westcentralus.api.cognitive.microsoft.com/face/v1.0

Paramètres de configuration CloudAICloudAI configuration settings

Les paramètres de configuration de la section CloudAI fournissent des options de conteneur propres à votre conteneur.The configuration settings in the CloudAI section provide container-specific options unique to your container. Les paramètres et les objets suivants sont pris en charge pour le conteneur Visage dans la section CloudAIThe following settings and objects are supported for the Face container in the CloudAI section

NomName Type de donnéesData type DescriptionDescription
Storage ObjectObject Scénario de stockage utilisé par le conteneur Visage.The storage scenario used by the Face container. Pour plus d’informations sur les scénarios de stockage et les paramètres associés pour les objets Storage, consultez Paramètres de scénario de stockage.For more information about storage scenarios and associated settings for the Storage object, see Storage scenario settings

Paramètres de scénario de stockageStorage scenario settings

Le conteneur Visage stocke des données d’objet blob, de cache, de métadonnées et de file d’attente, selon ce qui est stocké.The Face container stores blob, cache, metadata, and queue data, depending on what's being stored. Par exemple, les index et résultats d’entraînement d’un grand groupe de personnes sont stockés sous forme de données d’objet blob.For example, training indexes and results for a large person group are stored as blob data. Le conteneur Visage offre deux scénarios de stockage différents quand il interagit avec ces types de données et les stocke :The Face container provides two different storage scenarios when interacting with and storing these types of data:

  • MémoireMemory
    Les quatre types de données sont stockés en mémoire.All four types of data are stored in memory. Ils ne sont ni distribués ni persistants.They're not distributed, nor are they persistent. Si le conteneur Visage est arrêté ou supprimé, toutes les données contenues dans le stockage de ce conteneur sont détruites.If the Face container is stopped or removed, all of the data in storage for that container is destroyed.
    Il s’agit du scénario de stockage par défaut du conteneur Visage.This is the default storage scenario for the Face container.
  • AzureAzure
    Le conteneur Visage utilise Stockage Azure et Azure Cosmos DB pour répartir ces quatre types de données dans le stockage persistant.The Face container uses Azure Storage and Azure Cosmos DB to distribute these four types of data across persistent storage. Les données d’objet blob et de file d’attente sont gérées par Stockage Azure.Blob and queue data is handled by Azure Storage. Les métadonnées et les données de cache sont gérées par Azure Cosmos DB.Metadata and cache data is handled by Azure Cosmos DB. Si le conteneur Visage est arrêté ou supprimé, toutes les données se trouvant dans le stockage de ce conteneur restent stockées dans Stockage Azure et 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.
    Les ressources utilisées par le scénario de stockage Azure imposent les conditions supplémentaires suivantes :The resources used by the Azure storage scenario have the following additional requirements
    • La ressource Stockage Azure doit utiliser le type de compte StorageV2.The Azure Storage resource must use the StorageV2 account kind
    • La ressource Azure Cosmos DB doit utiliser l'API Azure Cosmos DB pour MongoDBThe Azure Cosmos DB resource must use the Azure Cosmos DB's API for MongoDB

Les scénarios de stockage et les paramètres de configuration associés sont gérés par l’objet Storage, sous la section de configuration CloudAI.The storage scenarios and associated configuration settings are managed by the Storage object, under the CloudAI configuration section. Les paramètres de configuration suivants sont disponibles dans l’objet Storage :The following configuration settings are available in the Storage object:

NomName Type de donnéesData type DescriptionDescription
StorageScenario ChaîneString Scénario de stockage pris en charge par le conteneur.The storage scenario supported by the container. Les valeurs disponibles sont les suivantes :The following values are available
Memory - Valeur par défaut.Memory - Default value. Le conteneur utilise un stockage non persistant, non réparti et en mémoire pour une utilisation temporaire sur un nœud unique.Container uses non-persistent, non-distributed and in-memory storage, for single-node, temporary usage. Si le conteneur est arrêté ou supprimé, son stockage est détruit.If the container is stopped or removed, the storage for that container is destroyed.
Azure - Le conteneur utilise des ressources Azure pour le stockage.Azure - Container uses Azure resources for storage. Si le conteneur est arrêté ou supprimé, son stockage est conservé.If the container is stopped or removed, the storage for that container is persisted.
ConnectionStringOfAzureStorage ChaîneString Chaîne de connexion de la ressource Stockage Azure utilisée par le conteneur.The connection string for the Azure Storage resource used by the container.
Ce paramètre s’applique uniquement si Azure est spécifié pour le paramètre de configuration StorageScenario.This setting applies only if Azure is specified for the StorageScenario configuration setting.
ConnectionStringOfCosmosMongo ChaîneString Chaîne de connexion MongoDB de la ressource Azure Cosmos DB utilisée par le conteneur.The MongoDB connection string for the Azure Cosmos DB resource used by the container.
Ce paramètre s’applique uniquement si Azure est spécifié pour le paramètre de configuration StorageScenario.This setting applies only if Azure is specified for the StorageScenario configuration setting.

Par exemple, la commande suivante spécifie le scénario de stockage Azure et fournit des exemples de chaîne de connexion pour les ressources Stockage Azure et Cosmos DB utilisées pour stocker les données du conteneur Visage.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"

Le scénario de stockage est géré séparément des montages d’entrée et de sortie.The storage scenario is handled separately from input mounts and output mounts. Vous pouvez spécifier une combinaison de ces caractéristiques pour un seul conteneur.You can specify a combination of those features for a single container. Par exemple, la commande suivante définit un montage de liaison Docker sur le dossier D:\Output de la machine hôte comme montage de sortie, puis instancie un conteneur à partir de l’image conteneur Visage, les fichiers journaux étant enregistrés au format JSON sur le montage de sortie.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. De même, la commande spécifie le scénario de stockage Azure et fournit des exemples de chaîne de connexion pour les ressources Stockage Azure et Cosmos DB utilisées pour stocker les données du conteneur Visage.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"

Paramètre EulaEula setting

Le paramètre Eula indique que vous avez accepté la licence pour le conteneur.The Eula setting indicates that you've accepted the license for the container. Vous devez attribuer à ce paramètre de configuration une valeur qui doit être définie sur accept.You must specify a value for this configuration setting, and the value must be set to accept.

ObligatoireRequired NomName Type de donnéesData type DescriptionDescription
OUIYes Eula ChaîneString Acceptation de la licenceLicense acceptance

Exemple :Example:
Eula=accept

Les conteneurs Cognitive Services sont accordés sous licence selon les termes d’un contrat qui régit votre utilisation d’Azure.Cognitive Services containers are licensed under your agreement governing your use of Azure. Si vous ne disposez pas d’un contrat existant régissant votre utilisation d’Azure, vous acceptez que votre utilisation d’Azure soit régie par le Contrat d’abonnement à Microsoft Online, qui intègre les conditions des services en ligne.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. Pour les préversions, vous acceptez également les conditions d’utilisation supplémentaires des préversions Microsoft Azure.For previews, you also agree to the Supplemental Terms of Use for Microsoft Azure Previews. En utilisant le conteneur, vous acceptez les termes du contrat.By using the container you agree to these terms.

Paramètres FluentdFluentd settings

Fluentd est un collecteur de données open source pour la journalisation unifiée.Fluentd is an open-source data collector for unified logging. Les paramètres Fluentd gèrent la connexion du conteneur à un serveur Fluentd.The Fluentd settings manage the container's connection to a Fluentd server. Le conteneur comprend un fournisseur de journalisation Fluentd qui permet à votre conteneur d’écrire des données de journaux d’activité et, éventuellement, de métriques, sur un serveur Fluentd.The container includes a Fluentd logging provider, which allows your container to write logs and, optionally, metric data to a Fluentd server.

Le tableau suivant décrit les paramètres de configuration pris en charge sous la section Fluentd.The following table describes the configuration settings supported under the Fluentd section.

NomName Type de donnéesData type DescriptionDescription
Host ChaîneString Adresse IP ou nom d’hôte DNS du serveur Fluentd.The IP address or DNS host name of the Fluentd server.
Port EntierInteger Port du serveur Fluentd.The port of the Fluentd server.
La valeur par défaut est 24224.The default value is 24224.
HeartbeatMs EntierInteger Intervalle de pulsation, en millisecondes.The heartbeat interval, in milliseconds. Si aucun trafic d’événement n’est envoyé avant l’expiration de cet intervalle, une pulsation est envoyée au serveur Fluentd.If no event traffic has been sent before this interval expires, a heartbeat is sent to the Fluentd server. La valeur par défaut est de 60 000 millisecondes (1 minute).The default value is 60000 milliseconds (1 minute).
SendBufferSize EntierInteger Espace de mémoire tampon réseau, en octets, alloué pour les opérations d’envoi.The network buffer space, in bytes, allocated for send operations. La valeur par défaut est de 32 768 octets (32 kilo-octets).The default value is 32768 bytes (32 kilobytes).
TlsConnectionEstablishmentTimeoutMs EntierInteger Délai d’attente, en millisecondes, pour établir une connexion SSL/TLS avec le serveur Fluentd.The timeout, in milliseconds, to establish a SSL/TLS connection with the Fluentd server. La valeur par défaut est de 10 000 millisecondes (10 secondes).The default value is 10000 milliseconds (10 seconds).
Si UseTLS est défini sur false, cette valeur est ignorée.If UseTLS is set to false, this value is ignored.
UseTLS BooleanBoolean Indique si le conteneur doit utiliser SSL/TLS pour communiquer avec le serveur Fluentd.Indicates whether the container should use SSL/TLS for communicating with the Fluentd server. La valeur par défaut est false.The default value is false.

Paramètres des informations d'identification du proxy HTTPHttp proxy credentials settings

Si vous devez configurer un proxy HTTP pour effectuer des requêtes sortantes, utilisez les deux arguments suivants :If you need to configure an HTTP proxy for making outbound requests, use these two arguments:

NomName Type de donnéesData type DescriptionDescription
HTTP_PROXYHTTP_PROXY stringstring Le proxy à utiliser, par exemple, http://proxy:8888The proxy to use, for example, http://proxy:8888
<proxy-url>
HTTP_PROXY_CREDSHTTP_PROXY_CREDS stringstring Les informations d’identification nécessaires pour s’authentifier auprès du proxy, par exemple, username:password.Any credentials needed to authenticate against the proxy, for example, username:password.
<proxy-user> stringstring L’utilisateur pour le proxy.The user for the proxy.
<proxy-password> stringstring Le mot de passe associé à <proxy-user> pour le proxy.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> \

Paramètres de journalisationLogging settings

Les paramètres Logging gèrent la prise en charge de la journalisation ASP.NET Core pour votre conteneur.The Logging settings manage ASP.NET Core logging support for your container. Vous pouvez utiliser pour votre conteneur les mêmes paramètres et valeurs de configuration que ceux d’une application ASP.NET Core.You can use the same configuration settings and values for your container that you use for an ASP.NET Core application.

Le conteneur prend en charge les fournisseurs de journalisation suivants :The following logging providers are supported by the container:

FournisseurProvider ObjectifPurpose
ConsoleConsole Fournisseur de journalisation Console ASP.NET Core.The ASP.NET Core Console logging provider. Tous les paramètres de configuration ASP.NET Core et les valeurs par défaut de ce fournisseur de journalisation sont pris en charge.All of the ASP.NET Core configuration settings and default values for this logging provider are supported.
DéboguerDebug Fournisseur de journalisation Debug ASP.NET Core.The ASP.NET Core Debug logging provider. Tous les paramètres de configuration ASP.NET Core et les valeurs par défaut de ce fournisseur de journalisation sont pris en charge.All of the ASP.NET Core configuration settings and default values for this logging provider are supported.
DisqueDisk Fournisseur de journalisation JSON.The JSON logging provider. Ce fournisseur de journalisation écrit les données de journal dans le montage de sortie.This logging provider writes log data to the output mount.

Cette commande de conteneur stocke des informations de journalisation au format JSON dans le montage de sortie :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

Cette commande de conteneur affiche des informations de débogage, avec le préfixe dbug, tandis que le conteneur s’exécute :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

Journalisation DiskDisk logging

Le fournisseur de journalisation Disk prend en charge les paramètres de configuration suivants :The Disk logging provider supports the following configuration settings:

NomName Type de donnéesData type DescriptionDescription
Format ChaîneString Format de sortie des fichiers journaux.The output format for log files.
Remarque : Cette valeur doit être json pour activer le fournisseur de journalisation.Note: This value must be set to json to enable the logging provider. Si cette valeur est spécifiée sans que le montage de sortie soit aussi spécifié pendant l’instanciation d’un conteneur, une erreur se produit.If this value is specified without also specifying an output mount while instantiating a container, an error occurs.
MaxFileSize EntierInteger Taille maximale, en mégaoctets (Mo), d’un fichier journal.The maximum size, in megabytes (MB), of a log file. Dès que la taille du fichier journal actif atteint ou dépasse cette valeur, un nouveau fichier journal est commencé par le fournisseur de journalisation.When the size of the current log file meets or exceeds this value, a new log file is started by the logging provider. Si la valeur -1 est spécifiée, la taille du fichier journal est limitée uniquement par la taille de fichier maximale, le cas échéant, pour le montage de sortie.If -1 is specified, the size of the log file is limited only by the maximum file size, if any, for the output mount. La valeur par défaut est 1.The default value is 1.

Pour plus d’informations sur la configuration de la prise en charge de la journalisation ASP.NET Core, consultez Configuration d’un fichier de paramètres.For more information about configuring ASP.NET Core logging support, see Settings file configuration.

Paramètres de montageMount settings

Utilisez des montages de liaisons pour lire et écrire des données vers et à partir du conteneur.Use bind mounts to read and write data to and from the container. Vous pouvez spécifier un montage d’entrée ou de sortie en spécifiant l’option --mount dans la commande docker run.You can specify an input mount or output mount by specifying the --mount option in the docker run command.

Les conteneurs Visage n’utilisent pas de montage d’entrée ou de sortie pour stocker des données d’entraînement ou de service.The Face containers don't use input or output mounts to store training or service data.

La syntaxe exacte de l’emplacement de montage d’hôte varie en fonction du système d’exploitation hôte.The exact syntax of the host mount location varies depending on the host operating system. De plus, l’emplacement de montage de l’ordinateur hôte peut ne pas être accessible en raison d’un conflit entre les autorisations utilisées par le compte de service Docker et les autorisations de l’emplacement de montage de l’hôte.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.

FacultatifOptional NomName Type de donnéesData type DescriptionDescription
Non autoriséNot allowed Input ChaîneString Les conteneurs Visage n’utilisent pas cet élément.Face containers do not use this.
FacultatifOptional Output ChaîneString Cible du montage de sortie.The target of the output mount. La valeur par défaut est /output.The default value is /output. Il s’agit de l’emplacement des journaux d’activité.This is the location of the logs. Les journaux d’activité de conteneur sont inclus.This includes container logs.

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

Exemples de commandes docker runExample docker run commands

Les exemples suivants utilisent les paramètres de configuration pour illustrer comment écrire et utiliser des commandes docker run.The following examples use the configuration settings to illustrate how to write and use docker run commands. Une fois en cours d’exécution, le conteneur continue à s’exécuter jusqu’à ce que vous l’arrêtiez.Once running, the container continues to run until you stop it.

  • Caractère de continuation de ligne : Les commandes Docker dans les sections suivantes utilisent la barre oblique inverse, \, comme caractère de continuation de ligne.Line-continuation character: The Docker commands in the following sections use the back slash, \, as a line continuation character. Remplacez-la ou supprimez-la en fonction des exigences de votre système d’exploitation hôte.Replace or remove this based on your host operating system's requirements.
  • Ordre des arguments : Ne changez pas l’ordre des arguments, sauf si vous avez une connaissance approfondie des conteneurs Docker.Argument order: Do not change the order of the arguments unless you are very familiar with Docker containers.

Remplacez {argument_name} par vos propres valeurs :Replace {argument_name} with your own values:

PlaceholderPlaceholder ValeurValue Format ou exempleFormat or example
{API_KEY}{API_KEY} Clé de point de terminaison de la ressource Cognitive Services.The endpoint key of the Cognitive Services resource. xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
{ENDPOINT_URI}{ENDPOINT_URI} Valeur de point de terminaison, routage de visage et région compris.The endpoint value including region and face routing. https://westcentralus.api.cognitive.microsoft.com/face/v1.0

Important

Vous devez spécifier les options Eula, Billing et ApiKey pour exécuter le conteneur, sinon il ne démarrera pas.The Eula, Billing, and ApiKey options must be specified to run the container; otherwise, the container won't start. Pour plus d'informations, consultez Facturation.For more information, see Billing. La valeur ApiKey est la Clé de la page Clés des ressources Azure Cognitive Services.The ApiKey value is the Key from the Azure Cognitive Services Resource keys page.

Exemples Docker de conteneurs VisageFace container Docker examples

Les exemples Docker suivants s’appliquent au conteneur Visage.The following Docker examples are for the face container.

Exemple de baseBasic 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} 

Exemple de journalisationLogging 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

Étapes suivantesNext steps