Konfigurieren von Docker-Containern für die Textübersetzung
Azure KI Services stellen jedem Container ein gemeinsames Konfigurationsframework bereit. Sie können Ihre Übersetzer-Container problemlos konfigurieren und eine Übersetzer-Anwendungsarchitektur erstellen, die sowohl von widerstandsfähigen Cloudfunktionen als auch von der Edgeposition profitieren kann.
Die Laufzeitumgebung für Container für die Textübersetzung wird über die Argumente des Befehls docker run konfiguriert. Für diesen Container gibt es sowohl erforderliche als auch optionale Einstellungen. Die erforderlichen containerspezifischen Einstellungen sind die für die Abrechnung.
Konfigurationseinstellungen
Der Container hat die folgenden Konfigurationseinstellungen:
| Erforderlich | Einstellung | Zweck |
|---|---|---|
| Ja | ApiKey | Nachverfolgen von Abrechnungsinformationen |
| Nein | ApplicationInsights | Ermöglicht das Hinzufügen von Unterstützung für Azure Application Insights-Telemetriedaten in Ihrem Container. |
| Ja | Abrechnung | Gibt den Endpunkt-URI der Dienstressource in Azure an. |
| Ja | ENDBENUTZER-LIZENZVERTRAG | Gibt an, dass Sie den Endbenutzer-Lizenzvertrag (EULA) für den Container akzeptiert haben. |
| No | Fluentd | Schreibt Protokoll- und optional auch Metrikdaten auf einen Fluentd-Server. |
| Nein | HTTP-Proxy | Konfiguriert einen HTTP-Proxy für ausgehende Anforderungen. |
| Nein | Logging | Bietet Unterstützung für die ASP.NET Core-Protokollierung für Ihren Container. |
| Ja | Mounts | Liest und schreibt Daten vom Hostcomputer in den Container und umgekehrt. |
Wichtig
Die Einstellungen ApiKey, Billing und EULA werden gemeinsam verwendet, und Sie müssen gültige Werte für alle drei angeben, da der Container andernfalls nicht startet. Weitere Informationen zum Instanziieren eines Containers mithilfe dieser Konfigurationseinstellungen.
Konfigurationseinstellung „ApiKey“
Die ApiKey-Einstellung gibt den Schlüssel der Azure-Ressourcen an, mit dem die Abrechnungsinformationen für den Container verfolgt werden. Sie müssen einen Wert für „ApiKey“ angeben. Bei diesem Wert muss es sich um einen gültigen Schlüssel für die Translator-Ressource handeln, die für die Konfigurationseinstellung Billing angegeben wurde.
Diese Einstellung finden Sie hier:
- Azure-Portal: Ressourcenverwaltung für die Textübersetzung, unter Schlüssel
ApplicationInsights-Einstellung
Die ApplicationInsights-Einstellung ermöglicht das Hinzufügen von Unterstützung für Azure Application Insights-Telemetriedaten in Ihrem Container. Application Insights ermöglicht eine tief greifende Überwachung Ihrer Container. Sie können ganz einfach die Verfügbarkeit, Leistung und Nutzung Ihrer Container überwachen. Außerdem können Sie schnell Fehler in Ihrem Container erkennen und diagnostizieren.
In der folgenden Tabelle werden die Konfigurationseinstellungen beschrieben, die unter dem Abschnitt ApplicationInsights unterstützt werden.
| Erforderlich | Name | Datentyp | BESCHREIBUNG |
|---|---|---|---|
| Nein | InstrumentationKey |
String | Der Instrumentierungsschlüssel der Application Insights-Instanz, an die Telemetriedaten für den Container gesendet werden. Weitere Informationen finden Sie unter Application Insights für ASP.NET Core. Beispiel: InstrumentationKey=123456789 |
Konfigurationseinstellung „Billing“
Die Einstellung Billing gibt den Endpunkt-URI der Translator-Ressource in Azure an, der zum Messen der Abrechnungsinformationen für den Container verwendet wird. Sie müssen einen Wert für diese Konfigurationseinstellung angeben, und bei dem Wert muss es sich um einen gültigen URI-Endpunkt für eine Translator-Ressource in Azure handeln. Der Container meldet die Nutzung etwa alle 10 bis 15 Minuten.
Diese Einstellung finden Sie hier:
- Azure-Portal: Übersichtsseite für die Textübersetzung mit der Bezeichnung
Endpoint
| Erforderlich | Name | Datentyp | Beschreibung |
|---|---|---|---|
| Ja | Billing |
String | URI des Abrechnungsendpunkts. Weitere Informationen zum Erhalt eines Abrechnungs-URI finden Sie unter Ermitteln erforderlicher Parameter. Weitere Informationen und eine vollständige Liste mit regionalen Endpunkten finden Sie unter Benutzerdefinierte Unterdomänennamen für Azure KI Services. |
Eula-Einstellung
Die Eula-Einstellung gibt an, dass Sie die Lizenz für den Container akzeptiert haben. Sie müssen einen Wert für diese Konfigurationseinstellung angeben, und der Wert muss auf accept festgelegt werden.
| Erforderlich | Name | Datentyp | Beschreibung |
|---|---|---|---|
| Ja | Eula |
String | Zustimmung zur Lizenz Beispiel: Eula=accept |
Azure KI Services-Container werden im Rahmen Ihres Vertrags lizenziert, der Ihre Nutzung von Azure regelt. Wenn Sie über keine Vereinbarung zur Nutzung von Azure verfügen, bestätigen Sie, dass Ihre Vereinbarung zur Nutzung von Azure der Microsoft Online-Abonnementvertrag ist, der die Nutzungsbedingungen für Onlinedienste umfasst. Für Vorschauversionen stimmen Sie auch den ergänzenden Nutzungsbedingungen für Microsoft Azure-Vorschauversionen zu. Durch die Nutzung von Containern stimmen Sie diesen Bedingungen zu.
Fluentd-Einstellungen
Fluentd ist ein Open-Source-Datensammler für die einheitliche Protokollierung. Die Fluentd-Einstellungen verwalten die Verbindung des Containers mit einem Fluentd-Server. Der Container enthält einen Fluentd-Protokollanbieter, der es Ihrem Container ermöglicht, Protokolldaten (und optional auch Metrikdaten) auf einen Fluentd-Server zu schreiben.
In der folgenden Tabelle werden die Konfigurationseinstellungen beschrieben, die unter dem Abschnitt Fluentd unterstützt werden.
| Name | Datentyp | Beschreibung |
|---|---|---|
Host |
String | Die IP-Adresse oder der DNS-Hostname des Fluentd-Servers. |
Port |
Integer | Der Port des Fluentd-Servers. Standardwert: 24224 |
HeartbeatMs |
Integer | Das Heartbeatintervall in Millisekunden. Wurde bis zum Ablauf dieses Intervalls kein Ereignisdatenverkehr gesendet, wird ein Heartbeat an den Fluentd-Server gesendet. Standardwert: 60.000 Millisekunden (eine Minute) |
SendBufferSize |
Integer | Der für Sendevorgänge zugeordnete Netzwerkpufferspeicher (in Byte). Standardwert: 32.768 Byte (32 KB) |
TlsConnectionEstablishmentTimeoutMs |
Integer | Das Timeout (in Millisekunden) für die Herstellung einer SSL/TLS-Verbindung mit dem Fluentd-Server. Der Standardwert beträgt 10.000 Millisekunden (zehn Sekunden). Wenn UseTLS auf FALSE festgelegt ist, wird dieser Wert ignoriert. |
UseTLS |
Boolean | Gibt an, ob der Container für die Kommunikation mit dem Fluentd-Server SSL/TLS verwenden soll. Der Standardwert ist false. |
HTTP/HTTPS-Proxyanmeldeinformationen
Wenn Sie einen HTTP-Proxy für ausgehende Anforderungen konfigurieren müssen, verwenden Sie diese zwei Argumente:
| Name | Datentyp | Beschreibung |
|---|---|---|
| HTTPS_PROXY | Zeichenfolge | Die Proxy-URL, z. B. 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>
Logging-Einstellungen
Übersetzercontainer unterstützen die folgenden Protokollierungsanbieter:
| Anbieter | Zweck |
|---|---|
| Konsole | Der ASP.NET Core-Protokollierungsanbieter Console. Alle ASP.NET Core-Konfigurationseinstellungen und Standardwerte für diesen Protokollanbieter werden unterstützt. |
| Debuggen | Der ASP.NET Core-Protokollierungsanbieter Debug. Alle ASP.NET Core-Konfigurationseinstellungen und Standardwerte für diesen Protokollanbieter werden unterstützt. |
| Datenträger | Der JSON-Protokollanbieter. Dieser Protokollanbieter schreibt Protokolldaten in die Ausgabeeinbindung. |
Die
Logging-Einstellungen dienen zur Verwaltung der ASP.NET Core-Protokollierungsunterstützung für Ihren Container. Sie können für Ihren Container die gleichen Konfigurationseinstellungen und Werte verwenden wie für eine ASP.NET Core-Anwendung.Logging.LogLevelgibt die Mindestebene an, die protokolliert werden soll. Der Schweregrad derLogLevelBereiche von 0 bis 6. Wenn eineLogLevelAngabe erfolgt, wird die Protokollierung für Nachrichten auf der angegebenen Ebene und höher aktiviert: Trace = 0, Debug = 1, Information = 2, Warnung = 3, Fehler = 4, Kritisch = 5, None = 6.Derzeit haben Translator-Container die Möglichkeit, Protokolle auf das Warnung LogLevel oder höher einzuschränken.
Die allgemeine Befehlssyntax für die Protokollierung lautet wie folgt:
-Logging:LogLevel:{Provider}={FilterSpecs}
Der folgende Befehl startet den Docker-Container mit LogLevel auf Warnung und Protokollierungsanbieter auf Konsole gestellt. Dieser Befehl druckt während des Anwendungsflusses anomale oder unerwartete Ereignisse in der Konsole:
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
Datenträgerprotokollierung
Der Protokollanbieter Disk unterstützt folgende Konfigurationseinstellungen:
| Name | Datentyp | Beschreibung |
|---|---|---|
Format |
String | Das Ausgabeformat für Protokolldateien. Hinweis: Dieser Wert muss auf json festgelegt werden, um den Protokollanbieter zu aktivieren. Wenn dieser Wert bei der Containerinstanziierung angegeben wird, ohne eine Ausgabeeinbindung anzugeben, tritt ein Fehler auf. |
MaxFileSize |
Integer | Die maximale Größe einer Protokolldatei (in MB). Wenn die Größe der aktuellen Protokolldatei diesen Wert erreicht oder übersteigt, erstellt der Protokollanbieter eine neue Protokolldatei. Bei Angabe von „-1“ wird die Größe der Protokolldatei nur durch die maximal zulässige Dateigröße für die Ausgabeeinbindung begrenzt (sofern vorhanden). Der Standardwert ist 1. |
Beispiel für Datenträgeranbieter
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
Weitere Informationen zum Konfigurieren der ASP.NET Core-Protokollierungsunterstützung finden Sie unter Protokollierung in ASP.NET Core.
Einbindungseinstellungen
Verwenden Sie Bindungsbereitstellungen zum Lesen und Schreiben von Daten im Container. Sie können eine Eingabe- oder Ausgabebereitstellung über die Option --mount im Befehl docker run angeben.