Configurer les conteneurs Docker Translator
Les Azure AI services fournissent une infrastructure de configuration commune à chaque conteneur. Vous pouvez facilement configurer vos conteneurs Translator qui vous permettent de créer une architecture d’application Translator optimisée pour tirer parti des fonctionnalités robustes du cloud et de la localité en périphérie.
L’environnement d’exécution de conteneur Translator est configuré à l’aide des arguments de la commande docker run. Ce conteneur a des paramètres obligatoires et facultatifs. Les paramètres requis propres aux conteneurs correspondent aux paramètres de facturation.
Paramètres de configuration
Le conteneur a les paramètres de configuration suivants :
| Obligatoire | Paramètre | Objectif |
|---|---|---|
| Oui | ApiKey | Assure le suivi des informations de facturation. |
| Non | ApplicationInsights | Permet d’ajouter la prise en charge télémétrique Azure Application Insights à votre conteneur. |
| Oui | Billing | Spécifie l’URI de point de terminaison de la ressource de service sur Azure. |
| Oui | EULA | Indique que vous avez accepté le contrat de licence de l’utilisateur(-trice) final (EULA) pour le conteneur. |
| Non | Fluentd | Écrit les données des journaux et, éventuellement, des métriques, sur un serveur Fluentd. |
| Non | Proxy HTTP | Configure un proxy HTTP pour effectuer des requêtes sortantes. |
| Non | Logging | Fournit la prise en charge de la journalisation ASP.NET Core pour votre conteneur. |
| Oui | Mounts | Lit et écrit des données de l’ordinateur hôte sur le conteneur, et du conteneur sur l’ordinateur hôte. |
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. Obtenez plus d’informations sur l’instanciation d’un conteneur à l’aide de ces paramètres de configuration.
Paramètre de configuration ApiKey
Le paramètre ApiKey spécifie la clé de ressource Azure utilisée pour effectuer le suivi des informations de facturation pour le conteneur. Vous devez spécifier une valeur pour ApiKey, qui doit être une clé valide pour la ressource Translator spécifiée dans le paramètre de configuration Billing.
Vous trouverez ce paramètre à l’emplacement suivant :
- Portail Azure : Gestion des ressources Translator, sous Clés
Paramètre ApplicationInsights
Le paramètre ApplicationInsights vous permet d’ajouter la prise en charge de la télémétrie Azure Application Insights à votre conteneur. Application Insights assure une supervision approfondie de votre conteneur. Vous pouvez facilement superviser la disponibilité, les performances et l’utilisation de votre conteneur. De plus, vous pouvez identifier et diagnostiquer rapidement les erreurs dans votre conteneur.
Le tableau suivant décrit les paramètres de configuration pris en charge sous la section ApplicationInsights.
| Obligatoire | Nom | Type de données | Description |
|---|---|---|---|
| Non | InstrumentationKey |
String | Clé d’instrumentation de l’instance Application Insights à laquelle les données de télémétrie du conteneur sont envoyées. Pour plus d’informations, consultez Application Insights pour ASP.NET Core. Exemple : InstrumentationKey=123456789 |
Paramètre de configuration Billing
Le paramètre Billing permet de spécifier l’URI de point de terminaison de la ressource Translator sur Azure servant à mesurer les informations de facturation du conteneur. Vous devez affecter à ce paramètre de configuration une valeur correspondant à un URI de point de terminaison valide pour une ressource Translator sur Azure. Le conteneur crée des rapports sur l’utilisation toutes les 10 à 15 minutes.
Vous trouverez ce paramètre à l’emplacement suivant :
- Portail Azure : page Vue d’ensemble de Translator, avec l’étiquette
Endpoint
| Requis | Nom | Type de données | Description |
|---|---|---|---|
| Oui | Billing |
String | URI de point de terminaison de facturation. Pour plus d’informations sur la façon d’obtenir l’URI de facturation, consultez Collecte des paramètres requis. Pour plus d’informations et afin d’obtenir une liste complète des points de terminaison régionaux, consultez Noms personnalisés de sous-domaine pour Azure AI services. |
Paramètre EULA
Le paramètre Eula indique que vous avez accepté la licence pour le conteneur. Vous devez attribuer à ce paramètre de configuration une valeur qui doit être définie sur accept.
| Obligatoire | Nom | Type de données | Description |
|---|---|---|---|
| Oui | Eula |
String | Acceptation de la licence Exemple : Eula=accept |
Les conteneurs Azure AI services sont accordés sous licence selon les termes d’un contrat qui régit votre utilisation d’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. Pour les préversions, vous acceptez également les conditions d’utilisation supplémentaires des préversions Microsoft Azure. En utilisant le conteneur, vous acceptez les termes du contrat.
Paramètres Fluentd
Fluentd est un collecteur de données open source pour la journalisation unifiée. Les paramètres Fluentd gèrent la connexion du conteneur à un serveur Fluentd. 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.
Le tableau suivant décrit les paramètres de configuration pris en charge sous la section Fluentd.
| Name | Type de données | Description |
|---|---|---|
Host |
String | Adresse IP ou nom d’hôte DNS du serveur Fluentd. |
Port |
Integer | Port du serveur Fluentd. La valeur par défaut est 24224. |
HeartbeatMs |
Integer | Intervalle de pulsation, en millisecondes. Si aucun trafic d’événement n’est envoyé avant l’expiration de cet intervalle, une pulsation est envoyée au serveur Fluentd. La valeur par défaut est de 60 000 millisecondes (1 minute). |
SendBufferSize |
Integer | Espace de mémoire tampon réseau, en octets, alloué pour les opérations d’envoi. La valeur par défaut est de 32 768 octets (32 kilo-octets). |
TlsConnectionEstablishmentTimeoutMs |
Integer | Délai d’attente, en millisecondes, pour établir une connexion SSL/TLS avec le serveur Fluentd. La valeur par défaut est de 10 000 millisecondes (10 secondes). Si UseTLS est défini sur false, cette valeur est ignorée. |
UseTLS |
Boolean | Indique si le conteneur doit utiliser SSL/TLS pour communiquer avec le serveur Fluentd. La valeur par défaut est false (Faux). |
Paramètres des informations d’identification du proxy HTTP/HTTPS
Si vous devez configurer un proxy HTTP pour effectuer des requêtes sortantes, utilisez les deux arguments suivants :
| Name | Type de données | Description |
|---|---|---|
| HTTPS_PROXY | string | URL du proxy, par exemple, https://proxy:8888 |
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> \
HTTPS_PROXY=<proxy-url>
Paramètres de journalisation
Les conteneurs Translator prennent en charge les fournisseurs de journalisation suivants :
| Fournisseur | Objectif |
|---|---|
| Console | Fournisseur de journalisation Console ASP.NET Core. Tous les paramètres de configuration ASP.NET Core et les valeurs par défaut de ce fournisseur de journalisation sont pris en charge. |
| Déboguer | Fournisseur de journalisation Debug ASP.NET Core. Tous les paramètres de configuration ASP.NET Core et les valeurs par défaut de ce fournisseur de journalisation sont pris en charge. |
| Disque | Fournisseur de journalisation JSON. Ce fournisseur de journalisation écrit les données de journal dans le montage de sortie. |
Les paramètres
Logginggèrent la prise en charge de la journalisation ASP.NET Core pour votre conteneur. Vous pouvez utiliser pour votre conteneur les mêmes paramètres et valeurs de configuration que ceux d’une application ASP.NET Core.Le
Logging.LogLevelspécifie le niveau minimal à consigner. La gravité duLogLevelest comprise entre 0 et 6. Lorsqu’unLogLevelest spécifié, la journalisation est activée pour les messages au niveau spécifié et supérieur : Trace = 0, Débogage = 1, Informations = 2, Avertissement = 3, Erreur = 4, Critique = 5, Aucun = 6.Actuellement, les conteneurs Translator ont la possibilité de restreindre les journaux d’activité au niveau LogLevel Avertissement ou plus élevé.
La syntaxe de commande générale pour la journalisation est la suivante :
-Logging:LogLevel:{Provider}={FilterSpecs}
La commande suivante démarre le conteneur Docker avec la LogLevel défini sur Avertissement et le fournisseur de journalisation défini sur Console. Cette commande imprime des événements anormaux ou inattendus pendant le flux d’application vers la console :
docker run --rm -it -p 5000:5000
-v /mnt/d/TranslatorContainer:/usr/local/models \
-e apikey={API_KEY} \
-e eula=accept \
-e billing={ENDPOINT_URI} \
-e Languages=en,fr,es,ar,ru \
-e Logging:LogLevel:Console="Warning"
mcr.microsoft.com/azure-cognitive-services/translator/text-translation:latest
Journalisation Disk
Le fournisseur de journalisation Disk prend en charge les paramètres de configuration suivants :
| Name | Type de données | Description |
|---|---|---|
Format |
String | Format de sortie des fichiers journaux. Remarque : Cette valeur doit être définie sur json pour activer le fournisseur de journalisation. 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. |
MaxFileSize |
Integer | Taille maximale, en mégaoctets (Mo), d’un fichier journal. Dès que la taille du fichier journal actif atteint ou dépasse cette valeur, le fournisseur de journalisation démarre un nouveau fichier journal. 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. La valeur par défaut est 1. |
Exemple de fournisseur de disques
docker run --rm -it -p 5000:5000 \
--memory 2g --cpus 1 \
--mount type-bind,src=/home/azureuser/output,target=/output \
-e apikey={API_KEY} \
-e eula=accept \
-e billing={ENDPOINT_URI} \
-e Languages=en,fr,es,ar,ru \
Eula=accept \
Billing=<endpoint> \
ApiKey=<api-key> \
Logging:Disk:Format=json \
Mounts:Output=/output
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.
Paramètres de montage
Utilisez des montages de liaisons pour lire et écrire des données vers et à partir du conteneur. Vous pouvez spécifier un montage d’entrée ou de sortie en spécifiant l’option --mount dans la commande docker run.