Configurer des conteneurs Docker Reconnaître le texteConfigure Recognize Text Docker containers

L’environnement d’exécution de conteneur Reconnaître le texte est configuré à l’aide des arguments de la commande docker run.The Recognize Text 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 Cognitive Services utilisée pour effectuer le suivi des informations de facturation pour le conteneur.The ApiKey setting specifies the Azure Cognitive Services 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 vision/v1.0 à l’URI de point de terminaison, comme dans le tableau suivant.Remember to add the vision/v1.0 routing to the endpoint URI as shown in the following table.

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/vision/v1.0

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 Vision par ordinateur n’utilisent pas de montage d’entrée ou de sortie pour stocker des données d’entraînement ou de service.The Computer Vision 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 Vision par ordinateur n’utilisent pas cet élément.Computer Vision 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.

Pensez à ajouter le routage vision/v1.0 à l’URI de point de terminaison, comme dans le tableau suivant.Remember to add the vision/v1.0 routing to the endpoint URI as shown in the following table.

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 de facturation, région comprise.The billing endpoint value including region. https://westcentralus.api.cognitive.microsoft.com/vision/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 de conteneur Docker Reconnaître le texteRecognize text container Docker examples

Les exemples Docker suivants s’appliquent au conteneur Reconnaître le texte.The following Docker examples are for the recognize text container.

Exemple de baseBasic example

docker run --rm -it -p 5000:5000 --memory 4g --cpus 1 \
containerpreview.azurecr.io/microsoft/cognitive-services-recognize-text \
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-recognize-text \
Eula=accept \
Billing={ENDPOINT_URI} \
ApiKey={API_KEY} \
Logging:Console:LogLevel:Default=Information

Étapes suivantesNext steps