Konfigurera Translator Docker-containrar
Azure AI-tjänster ger varje container ett gemensamt konfigurationsramverk. Du kan enkelt konfigurera dina Translator-containrar för att skapa Translator-programarkitektur optimerad för robusta molnfunktioner och gränslokalitet.
Translator Container Runtime-miljön konfigureras med hjälp av kommandoargumentendocker run. Den här containern har både obligatoriska och valfria inställningar. De nödvändiga containerspecifika inställningarna är faktureringsinställningarna.
Konfigurationsinställningar
Containern har följande konfigurationsinställningar:
| Obligatoriskt | Inställning | Syfte |
|---|---|---|
| Ja | ApiKey | Spårar faktureringsinformation. |
| Nej | ApplicationInsights | Gör det möjligt att lägga till telemetriskt stöd för Azure Application Insights i containern. |
| Ja | Billing | Anger slutpunkts-URI för tjänstresursen i Azure. |
| Ja | EULA | Anger att du har godkänt licensavtalet för slutanvändare (EULA) för containern. |
| Nej | Fluentd | Skriver logg och, om du vill, måttdata till en Fluentd-server. |
| Nej | HTTP-proxy | Konfigurerar en HTTP-proxy för att göra utgående begäranden. |
| Nej | Loggning | Tillhandahåller ASP.NET Core-loggningsstöd för din container. |
| Ja | Fästen | Läser och skriver data från värddatorn till containern och från containern tillbaka till värddatorn. |
Viktigt!
ApiKey-, fakturerings- och EULA-inställningarna används tillsammans och du måste ange giltiga värden för alla tre. Annars startar inte containern. Mer information om hur du använder dessa konfigurationsinställningar för att instansiera en container.
Konfigurationsinställning för ApiKey
Inställningen ApiKey anger den Azure-resursnyckel som används för att spåra faktureringsinformation för containern. Du måste ange ett värde för ApiKey och värdet måste vara en giltig nyckel för Translator-resursen som angetts för konfigurationsinställningenBilling.
Den här inställningen finns på följande plats:
- Azure-portalen: Translator-resurshantering under Nycklar
ApplicationInsights-inställning
Med ApplicationInsights inställningen kan du lägga till telemetristöd för Azure Application Insights i containern. Application Insights ger djupgående övervakning av din container. Du kan enkelt övervaka din container för tillgänglighet, prestanda och användning. Du kan också snabbt identifiera och diagnostisera fel i containern.
I följande tabell beskrivs de konfigurationsinställningar som stöds i avsnittet ApplicationInsights .
| Obligatoriskt | Name | Datatyp | beskrivning |
|---|---|---|---|
| Nej | InstrumentationKey |
String | Instrumentationsnyckeln för Application Insights-instansen som telemetridata för containern skickas till. Mer information finns i Application Insights för ASP.NET Core. Exempel: InstrumentationKey=123456789 |
Konfigurationsinställning för fakturering
Inställningen Billing anger slutpunkts-URI för Translator-resurseni Azure som används för att mäta faktureringsinformation för containern. Du måste ange ett värde för den här konfigurationsinställningen och värdet måste vara en giltig slutpunkts-URI för en Translator-resurs i Azure. Containern rapporterar användning var 10:e till 15:e minut.
Den här inställningen finns på följande plats:
- Azure-portalen: Translator Overview-sidan märkt
Endpoint
| Obligatoriskt | Name | Datatyp | beskrivning |
|---|---|---|---|
| Ja | Billing |
String | URI för faktureringsslutpunkt. Mer information om hur du hämtar fakturerings-URI finns i samla in obligatoriska parametrar. Mer information och en fullständig lista över regionala slutpunkter finns i Anpassade underdomännamn för Azure AI-tjänster. |
Eula-inställning
Inställningen Eula anger att du har godkänt licensen för containern. Du måste ange ett värde för den här konfigurationsinställningen och värdet måste vara inställt på accept.
| Obligatoriskt | Name | Datatyp | beskrivning |
|---|---|---|---|
| Ja | Eula |
String | Godkännande av licens Exempel: Eula=accept |
Azure AI-tjänstcontainrar licensieras enligt ditt avtal som styr din användning av Azure. Om du inte har ett befintligt avtal som styr din användning av Azure godkänner du att ditt avtal som styr användningen av Azure är Microsoft Online-prenumerationsavtalet, som innehåller villkoren för onlinetjänster. För förhandsversioner godkänner du även de kompletterande användningsvillkoren för Förhandsversioner av Microsoft Azure. Genom att använda containern godkänner du dessa villkor.
Inställningar för Fluentd
Fluentd är en datainsamlare med öppen källkod för enhetlig loggning. Fluentd Inställningarna hanterar containerns anslutning till en Fluentd-server. Containern innehåller en Fluentd-loggningsprovider som gör att din container kan skriva loggar och, om du vill, mätdata till en Fluentd-server.
I följande tabell beskrivs de konfigurationsinställningar som stöds i avsnittet Fluentd .
| Name | Datatyp | beskrivning |
|---|---|---|
Host |
String | IP-adressen eller DNS-värdnamnet för Fluentd-servern. |
Port |
Integer | Porten för Fluentd-servern. Standardvärdet är 24224. |
HeartbeatMs |
Integer | Pulsslagsintervallet i millisekunder. Om ingen händelsetrafik har skickats innan det här intervallet upphör att gälla skickas ett pulsslag till Fluentd-servern. Standardvärdet är 6 0000 millisekunder (1 minut). |
SendBufferSize |
Integer | Nätverksbuffertutrymmet, i byte, allokerat för sändningsåtgärder. Standardvärdet är 32 768 byte (32 kilobyte). |
TlsConnectionEstablishmentTimeoutMs |
Integer | Tidsgränsen i millisekunder för att upprätta en SSL/TLS-anslutning med Fluentd-servern. Standardvärdet är 1 0000 millisekunder (10 sekunder). Om UseTLS värdet är inställt på false ignoreras det här värdet. |
UseTLS |
Booleskt | Anger om containern ska använda SSL/TLS för kommunikation med Fluentd-servern. Standardvärdet är "false". |
Inställningar för HTTP/HTTPS-proxyautentiseringsuppgifter
Om du behöver konfigurera en HTTP-proxy för att göra utgående begäranden använder du följande två argument:
| Name | Datatyp | beskrivning |
|---|---|---|
| HTTPS_PROXY | sträng | Proxy-URL:en, till exempel 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>
Loggningsinställningar
Translator-containrar stöder följande loggningsproviders:
| Provider | Syfte |
|---|---|
| Konsol | ASP.NET Core-loggningsprovidern Console . Alla ASP.NET Core-konfigurationsinställningar och standardvärden för den här loggningsprovidern stöds. |
| Debug | ASP.NET Core-loggningsprovidern Debug . Alla ASP.NET Core-konfigurationsinställningar och standardvärden för den här loggningsprovidern stöds. |
| Disk | JSON-loggningsprovidern. Den här loggningsprovidern skriver loggdata till utdatamonteringen. |
LoggingInställningarna hanterar ASP.NET Core-loggningsstöd för din container. Du kan använda samma konfigurationsinställningar och värden för din container som du använder för ett ASP.NET Core-program.Logging.LogLevelAnger den lägsta nivån som ska loggas. Allvarlighetsgraden för intervallenLogLevelfrån 0 till 6. När enLogLevelhar angetts aktiveras loggning för meddelanden på den angivna nivån och högre: Trace = 0, Debug = 1, Information = 2, Warning = 3, Error = 4, Critical = 5, None = 6.För närvarande har Translator-containrar möjlighet att begränsa loggar på Varningsloggnivå eller senare.
Den allmänna kommandosyntaxen för loggning är följande:
-Logging:LogLevel:{Provider}={FilterSpecs}
Följande kommando startar Docker-containern med inställningen LogLevelVarning och loggningsprovider inställd på Konsol. Det här kommandot skriver ut avvikande eller oväntade händelser under programflödet till konsolen:
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
Diskloggning
Loggningsprovidern Disk stöder följande konfigurationsinställningar:
| Name | Datatyp | beskrivning |
|---|---|---|
Format |
String | Utdataformatet för loggfiler. Obs! Det här värdet måste anges för att json aktivera loggningsprovidern. Om det här värdet anges utan att ange en utdatamontering vid instansiering av en container uppstår ett fel. |
MaxFileSize |
Integer | Den maximala storleken i mb för en loggfil. När storleken på den aktuella loggfilen uppfyller eller överskrider det här värdet startar loggningsprovidern en ny loggfil. Om -1 anges begränsas loggfilens storlek endast av den maximala filstorleken, om någon, för utdatamonteringen. Standardvärdet är 1. |
Exempel på diskprovider
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
Mer information om hur du konfigurerar ASP.NET Core-loggningsstöd finns i Inställningar filkonfiguration.
Monteringsinställningar
Använd bindningsmonteringar för att läsa och skriva data till och från containern. Du kan ange en indatamontering eller utdatamontering genom att --mount ange alternativet i kommandot docker run .