Konfigurera Textanalys för docker-hälsocontainrar

Artikel
12/19/2023

Textanalys för hälsa ger varje container ett gemensamt konfigurationsramverk, så att du enkelt kan konfigurera och hantera lagring, loggning och telemetri samt säkerhetsinställningar för dina containrar. Flera exempel på docker-körningskommandon är också tillgängliga.

Konfigurationsinställningar

Containern har följande konfigurationsinställningar:

Obligatorisk	Inställning	Syfte
Ja	ApiKey	Spårar faktureringsinformation.
Inga	ApplicationInsights	Gör det möjligt att lägga till Azure Application Insights-telemetristöd i containern.
Ja	Billing	Anger slutpunkts-URI för tjänstresursen i Azure.
Ja	Eula	Anger att du har accepterat licensen för containern.
Inga	Fluentd	Skriver loggen och, om du vill, måttdata till en Fluentd-server.
Inga	HTTP-proxy	Konfigurerar en HTTP-proxy för att göra utgående begäranden.
Inga	Loggning	Ger ASP.NET Core loggningsstöd för din container.
Inga	Fästen	Läser och skriver data från värddatorn till containern och från containern tillbaka till värddatorn.

Viktigt

ApiKeyInställningarna , Billingoch Eula 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 de här konfigurationsinställningarna för att instansiera en container finns i Fakturering.

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 den språkresurs som angetts för konfigurationsinställningen Billing .

Den här inställningen finns på följande plats:

Azure Portal: Språkresurshantering under Nycklar och slutpunkt

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 ApplicationInsights avsnittet .

Obligatorisk	Name	Datatyp	Beskrivning
Nej	`InstrumentationKey`	Sträng	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`

Inställning för faktureringskonfiguration

Inställningen Billing anger slutpunkts-URI:n för språkresursen i 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 språkresurs i Azure. Containern rapporterar användning var 10:e till var 15:e minut.

Den här inställningen finns på följande plats:

Azure Portal: Språköversikt, märktEndpoint

Obligatorisk	Name	Datatyp	Beskrivning
Ja	`Billing`	Sträng	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 accepterat licensen för containern. Du måste ange ett värde för den här konfigurationsinställningen och värdet måste anges till accept.

Obligatorisk	Name	Datatyp	Beskrivning
Ja	`Eula`	Sträng	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.

Fluentd-inställningar

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åttdata till en Fluentd-server.

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

Name	Datatyp	Beskrivning
`Host`	Sträng	IP-adressen eller DNS-värdnamnet för Fluentd-servern.
`Port`	Integer	Fluentd-serverns port. 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 32768 byte (32 kilobyte).
`TlsConnectionEstablishmentTimeoutMs`	Integer	Tidsgränsen i millisekunder för att upprätta en SSL/TLS-anslutning med Fluentd-servern. Standardvärdet är 10 000 millisekunder (10 sekunder). Om `UseTLS` är inställt på false ignoreras det här värdet.
`UseTLS`	Boolesk	Anger om containern ska använda SSL/TLS för kommunikation med Fluentd-servern. Standardvärdet är false.

Inställningar för HTTP-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
HTTP_PROXY	sträng	Proxyn 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 proxyn, `username:password`till exempel . Det här värdet måste vara i gemener.
`<proxy-user>`	sträng	Användaren för proxyn.
`<proxy-password>`	sträng	Lösenordet som är associerat med `<proxy-user>` för proxyn.

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

Logging Instä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.

Följande loggningsproviders stöds av containern:

Leverantör	Syfte
Konsol	Den ASP.NET Core `Console` loggningsprovidern. Alla ASP.NET Core konfigurationsinställningar och standardvärden för den här loggningsprovidern stöds.
Felsöka	Den ASP.NET Core `Debug` loggningsprovidern. 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.

Det här containerkommandot lagrar loggningsinformation i JSON-format till utdatamonteringen:

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 \
Mounts:Output=/output

Det här containerkommandot visar felsökningsinformation, med prefixet dbug, medan containern 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

Diskloggning

Loggningsprovidern Disk stöder följande konfigurationsinställningar:

Name	Datatyp	Beskrivning
`Format`	Sträng	Utdataformatet för loggfiler. Observera: Det här värdet måste anges till `json` för att 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 startas en ny loggfil av loggningsprovidern. Om -1 anges begränsas loggfilens storlek endast av den maximala filstorleken, om någon, för utdatamonteringen. Standardvärdet är 1.

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 montering av indata eller utdata genom att --mount ange alternativet i kommandot docker run .

Textanalys för hälsocontainrar använder inte indata- eller utdatamonteringar för att lagra tränings- eller tjänstdata.

Den exakta syntaxen för värdmonteringsplatsen varierar beroende på värdoperativsystemet. Dessutom kanske värddatorns monteringsplats inte är tillgänglig på grund av en konflikt mellan behörigheter som används av Docker-tjänstkontot och behörigheterna för värdmonteringsplats.

Valfritt	Name	Datatyp	Beskrivning
Inte tillåten	`Input`	Sträng	Textanalys för hälsocontainrar använder inte detta.
Valfritt	`Output`	Sträng	Målet för utdatamonteringen. Standardvärdet är `/output`. Det här är platsen för loggarna. Detta inkluderar containerloggar. Exempel: `--mount type=bind,src=c:\output,target=/output`

Nästa steg

Läs Installera och köra containrar
Använda fler Azure AI-containrar

Dela via