Konfigurera Language Understanding Docker-behållare

Language Understanding (Luis) container Runtime Environment konfigureras med hjälp av docker run kommando argumenten. LUIS har flera inställningar som krävs, tillsammans med några få valfria inställningar. Det finns flera exempel på kommandot. De maskinvaruspecifika inställningarna är ingångs monterings inställningar och fakturerings inställningar.

Konfigurationsinställningar

Den här behållaren har följande konfigurations inställningar:

Obligatorisk Inställning Syfte
Ja ApiKey Används för att spåra fakturerings information.
Inga ApplicationInsights Gör att du kan lägga till stöd för Azure Application Insights -telemetri till din behållare.
Ja Billing Anger slut punkts-URI för tjänst resursen på Azure.
Ja Villkoren Anger att du har accepterat licensen för behållaren.
Inga Fluent Skriv logg och, om du vill, Metric-data till en Fluent-Server.
Inga Http-proxy Konfigurera en HTTP-proxy för att göra utgående begär Anden.
Inga Loggning Tillhandahåller ASP.NET Core loggnings stöd för din behållare.
Ja Monterar Läs och Skriv data från värddatorn till behållare och från behållare tillbaka till värddatorn.

Viktigt

ApiKeyInställningarna, Billing och Eula används tillsammans och du måste ange giltiga värden för alla dessa tre. i annat fall startar inte behållaren. Mer information om hur du använder dessa konfigurations inställningar för att instansiera en behållare finns i fakturering.

ApiKey-inställning

ApiKeyInställningen anger den Azure-resurs nyckel som används för att spåra fakturerings information för behållaren. Du måste ange ett värde för ApiKey och värdet måste vara en giltig nyckel för den Cognitive Services resurs som angetts för Billing konfigurations inställningen.

Du hittar den här inställningen på följande platser:

  • Azure Portal: Cognitive Services resurs hantering under nycklar
  • LUIS Portal: Inställningar för nycklar och slut punkt .

Använd inte start nyckeln eller redigerings nyckeln.

ApplicationInsights-inställning

Med den ApplicationInsights här inställningen kan du lägga till stöd för Azure Application Insights -telemetri till din behållare. Application Insights ger detaljerad övervakning av din behållare. Du kan enkelt övervaka din behållare för tillgänglighet, prestanda och användning. Du kan också snabbt identifiera och diagnostisera fel i din behållare.

I följande tabell beskrivs de konfigurations inställningar som stöds i ApplicationInsights avsnittet.

Obligatorisk Name Datatyp Beskrivning
Nej InstrumentationKey Sträng Instrumentation-nyckeln för Application Insights-instansen som telemetridata för behållaren skickas till. Mer information finns i Application Insights för ASP.net Core.

Exempel:
InstrumentationKey=123456789

Fakturerings inställning

BillingInställningen anger slut punkts-URI för den Cognitive Services resursen på Azure som används för att mäta fakturerings information för behållaren. Du måste ange ett värde för den här konfigurations inställningen och värdet måste vara en giltig slut punkts-URI för en Cognitive Services -resurs på Azure. Behållar rapporteringen visar var 10 till 15: e minut.

Du hittar den här inställningen på följande platser:

  • Azure Portal: Cognitive Services översikt, etiketterad Endpoint
  • LUIS Portal: Inställningar för nycklar och slut punkt som en del av slut punktens URI.
Obligatorisk Name Datatyp Beskrivning
Ja Billing sträng URI för fakturerings slut punkt. Mer information om hur du skaffar fakturerings-URI: n finns i samla in obligatoriska parametrar. Mer information och en fullständig lista över regionala slut punkter finns i anpassade under domän namn för Cognitive Services.

Licens avtals inställning

EulaInställningen indikerar att du har accepterat licensen för behållaren. Du måste ange ett värde för den här konfigurations inställningen och värdet måste anges till accept .

Obligatorisk Name Datatyp Beskrivning
Ja Eula Sträng Licens godkännande

Exempel:
Eula=accept

Cognitive Services behållare licensieras enligt ditt avtal som reglerar din användning av Azure. Om du inte har ett befintligt avtal som styr din användning av Azure, samtycker du till att ditt avtal som reglerar användningen av Azure är prenumerationsavtal för Microsoft Online, som införlivar Online Services-villkoren. För för hands versionerna samtycker du även till kompletterande användnings villkor för Microsoft Azure för handsversionerna. Genom att använda den behållare som du samtycker till dessa villkor.

Fluent-inställningar

Fluent är en data insamlare med öppen källkod för enhetlig loggning. FluentdInställningarna hanterar behållarens anslutning till en Fluent -Server. Behållaren innehåller en upplösnings leverantör som gör att din behållare kan skriva loggar och, om du vill, Metric-data till en ansvars bara server.

I följande tabell beskrivs de konfigurations inställningar som stöds i Fluentd avsnittet.

Name Datatyp Beskrivning
Host Sträng IP-adressen eller DNS-värdnamnet för den sammanslagna servern.
Port Integer Porten för den Fluent-servern.
Standardvärdet är 24224.
HeartbeatMs Integer Pulsslags intervallet, i millisekunder. Om ingen händelse trafik har skickats innan det här intervallet går ut skickas ett pulsslag till den distribuerade servern. Standardvärdet är 60000 millisekunder (1 minut).
SendBufferSize Integer Utrymmet för nätverket i byte allokerat för sändnings åtgärder. Standardvärdet är 32768 byte (32 kilobyte).
TlsConnectionEstablishmentTimeoutMs Integer Timeout, i millisekunder, för att upprätta en SSL/TLS-anslutning med den upprättade servern. Standardvärdet är 10000 millisekunder (10 sekunder).
Om UseTLS är inställt på falskt ignoreras värdet.
UseTLS Boolesk Anger om behållaren ska använda SSL/TLS för att kommunicera med den upprättade servern. Standardvärdet är false.

Inställningar för autentiseringsuppgifter för HTTP-proxy

Om du behöver konfigurera en HTTP-proxy för att göra utgående begär Anden använder du följande två argument:

Name Datatyp Beskrivning
HTTP_PROXY sträng Proxyservern som ska användas, till exempel http://proxy:8888
<proxy-url>
HTTP_PROXY_CREDS sträng Alla autentiseringsuppgifter som krävs för att autentisera mot proxyservern, till exempel username:password . Det här värdet måste vara i gemener.
<proxy-user> sträng Användaren för proxyservern.
<proxy-password> sträng Lösen ordet som är associerat med <proxy-user> för proxyservern.
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> \

Loggningsinställningar

LoggingInställningarna hanterar ASP.net Core loggnings stöd för din behållare. Du kan använda samma konfigurations inställningar och värden för din behållare som du använder för ett ASP.NET Core-program.

Följande loggnings leverantörer stöds av behållaren:

Leverantör Syfte
Konsol ASP.NET Core Console Logging-providern. Alla ASP.NET Core konfigurations inställningar och standardvärden för den här Logging-providern stöds.
Felsöka ASP.NET Core Debug Logging-providern. Alla ASP.NET Core konfigurations inställningar och standardvärden för den här Logging-providern stöds.
Disk JSON-Logging-providern. Den här loggnings leverantören skriver loggdata till utgående data montering.

Det här behållar kommandot lagrar loggnings information i JSON-format till utmatnings monteringen:

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

Det här behållar kommandot visar fel söknings information, föregåd av dbug , medan behållaren körs:

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

Disk loggning

DiskLogging-providern har stöd för följande konfigurations inställningar:

Name Datatyp Beskrivning
Format Sträng Utdataformat för loggfiler.
Obs: Värdet måste anges till json om du vill aktivera loggnings leverantören. Om det här värdet anges utan att även ange en utmatnings montering vid instansiering av en behållare uppstår ett fel.
MaxFileSize Integer Den maximala storleken i megabyte (MB) i en loggfil. När storleken på den aktuella logg filen uppfyller eller överskrider det värdet, startas en ny loggfil av Logging-providern. Om-1 anges begränsas logg filens storlek bara av den maximala fil storleken, om det finns någon, för den utgående monteringen. Standardvärdet är 1.

Mer information om hur du konfigurerar ASP.NET Core loggnings support finns i Inställningar fil konfiguration.

Monterings inställningar

Använd bind-monteringar för att läsa och skriva data till och från behållaren. Du kan ange en inmatnings montering eller utmatnings montering genom --mount att ange alternativet i kommandot Docker Run .

LUIS-behållaren använder inte indata eller utmatnings montering för att lagra utbildning eller tjänst data.

Den exakta syntaxen för värd monterings platsen varierar beroende på värd operativ systemet. Dessutom kanske värd datornsmonterings plats inte är tillgänglig på grund av en konflikt mellan behörigheter som används av Docker-tjänstkontot och värd monterings platsens behörigheter.

I följande tabell beskrivs de inställningar som stöds.

Obligatorisk Name Datatyp Beskrivning
Ja Input Sträng Målet för den inmatade monteringen. Standardvärdet är /input. Det här är platsen för LUIS.

Exempel:
--mount type=bind,src=c:\input,target=/input
Inga Output Sträng Målet för utmatnings monteringen. Standardvärdet är /output. Detta är platsen för loggarna. Detta inkluderar LUIS-frågemeddelanden och behållar loggar.

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

Exempel på Docker-körnings kommandon

I följande exempel används konfigurations inställningarna för att illustrera hur du skriver och använder docker run kommandon. När den körs fortsätter behållaren att köras tills du stoppar den.

  • I de här exemplen används katalogen från C: enheten för att undvika eventuella behörighets konflikter i Windows. Om du behöver använda en speciell katalog som indatalistan kan du behöva ge Docker-tjänstens behörighet.
  • Ändra inte ordningen på argumenten om du inte är bekant med Docker-behållare.
  • Om du använder ett annat operativ system använder du rätt konsol/Terminal, kommandosyntax för montering och linje fortsättnings text för systemet. Dessa exempel förutsätter en Windows-konsol med ett linje fortsättnings steg ^ . Eftersom behållaren är ett Linux-operativsystem använder mål-Mount en syntax för en mappvy i Linux-typ.

Ersätt {argument_name} med dina egna värden:

Platshållare Värde Format eller exempel
{API_KEY} Resursens slut punkts nyckel LUIS på sidan med Azure- LUIS nycklar. xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
{ENDPOINT_URI} Värdet för fakturerings slut punkten är tillgängligt på sidan Azure- LUIS Översikt. Se samla in obligatoriska parametrar för explicita exempel.

Anteckning

Nya resurser som skapats efter den 1 juli 2019 kommer att använda anpassade under domän namn. Mer information och en fullständig lista över regionala slut punkter finns i anpassade under domän namn för Cognitive Services.

Viktigt

EulaAlternativen, Billing och ApiKey måste anges för att köra behållaren, annars startar inte behållaren. Mer information finns i fakturering. ApiKey-värdet är nyckeln på sidan nycklar och slut punkter i Luis-portalen och finns också på sidan med Azures Cognitive Services resurs nycklar.

Basic-exempel

I följande exempel finns minsta möjliga argument för att köra behållaren:

docker run --rm -it -p 5000:5000 --memory 4g --cpus 2 ^
--mount type=bind,src=c:\input,target=/input ^
--mount type=bind,src=c:\output,target=/output ^
mcr.microsoft.com/azure-cognitive-services/luis:latest ^
Eula=accept ^
Billing={ENDPOINT_URL} ^
ApiKey={API_KEY}

ApplicationInsights-exempel

I följande exempel anges argumentet ApplicationInsights för att skicka telemetri till Application Insights medan behållaren körs:

docker run --rm -it -p 5000:5000 --memory 6g --cpus 2 ^
--mount type=bind,src=c:\input,target=/input ^
--mount type=bind,src=c:\output,target=/output ^
mcr.microsoft.com/azure-cognitive-services/luis:latest ^
Eula=accept ^
Billing={ENDPOINT_URL} ^
ApiKey={API_KEY} ^
InstrumentationKey={INSTRUMENTATION_KEY}

Loggnings exempel

Följande kommando anger loggnings nivån, Logging:Console:LogLevel , för att konfigurera loggnings nivån till Information .

docker run --rm -it -p 5000:5000 --memory 6g --cpus 2 ^
--mount type=bind,src=c:\input,target=/input ^
--mount type=bind,src=c:\output,target=/output ^
mcr.microsoft.com/azure-cognitive-services/luis:latest ^
Eula=accept ^
Billing={ENDPOINT_URL} ^
ApiKey={API_KEY} ^
Logging:Console:LogLevel:Default=Information

Nästa steg