Configurare i contenitori Docker del servizio di linguaggio

Il servizio di linguaggio fornisce a ogni contenitore un framework di configurazione comune, in modo da poter configurare e gestire facilmente archiviazione, registrazione e telemetria e impostazioni di sicurezza per i contenitori. Questo articolo si applica ai contenitori seguenti:

  • Analisi del sentiment
  • Rilevamento lingua
  • Estrazione frasi chiave
  • Text Analytics for Health
  • Riepilogo
  • Riconoscimento delle entità denominate (NER)

Impostazioni di configurazione

Le impostazioni di configurazione del contenitore sono le seguenti:

Richiesto Impostazione Scopo
ApiKey Tiene traccia delle informazioni di fatturazione.
No ApplicationInsights Consente di aggiungere al contenitore il supporto per i dati di telemetria di Azure Application Insights.
Fatturazione Specifica l'URI dell'endpoint della risorsa del servizio in Azure.
Eula Indica che è stata accettata la licenza per il contenitore.
No Fluentd Scrive il log e, facoltativamente, i dati delle metriche in un server Fluentd.
No Proxy HTTP Configura un proxy HTTP per le richieste in uscita.
No Registrazione Fornisce il supporto di registrazione ASP.NET Core per il contenitore.
No Mounts Legge e scrive i dati dal computer host al contenitore e dal contenitore al computer host.

Importante

Le impostazioni ApiKey, Billing e Eula vengono usate insieme ed è necessario fornire valori validi per tutte e tre, altrimenti il contenitore non verrà avviato.

Impostazione di configurazione ApiKey

L'impostazione ApiKey specifica la chiave di risorsa di Azure utilizzata per tenere traccia delle informazioni di fatturazione per il contenitore. È necessario specificare un valore per la chiave e deve essere una chiave valida per la risorsa Lingua specificata per l'impostazione Billing di configurazione.

Impostazione ApplicationInsights

L'impostazione ApplicationInsights consente di aggiungere al contenitore il supporto per i dati di telemetria di Azure Application Insights. Application Insights offre funzionalità di monitoraggio avanzate del contenitore. È possibile monitorare con facilità la disponibilità, le prestazioni e l'utilizzo del contenitore. È anche possibile identificare e diagnosticare rapidamente gli errori nel contenitore.

La tabella seguente illustra le impostazioni di configurazione supportate nella sezione ApplicationInsights.

Obbligatorio Name Tipo di dati Descrizione
No InstrumentationKey Stringa Chiave di strumentazione dell'istanza di Application Insights a cui vengono inviati i dati di telemetria per il contenitore. Per altre informazioni, vedere Application Insights per ASP.NET Core.

Esempio:
InstrumentationKey=123456789

Impostazione di configurazione Billing

L'impostazione Billing specifica l'URI dell'endpoint della risorsa Lingua in Azure usata per misurare le informazioni di fatturazione per il contenitore. È necessario specificare un valore per questa impostazione di configurazione e il valore deve essere un URI dell'endpoint valido per una risorsa language in Azure. Il contenitore segnala l'utilizzo ogni 10-15 minuti.

Obbligatorio Name Tipo di dati Descrizione
Billing Stringa URI dell'endpoint di fatturazione.

Impostazione Eula

L'impostazione Eula indica che è stata accettata la licenza per il contenitore. È necessario specificare un valore per questa impostazione di configurazione e tale valore deve essere impostato su accept.

Obbligatorio Name Tipo di dati Descrizione
Eula Stringa Accettazione della licenza

Esempio:
Eula=accept

I contenitori dei servizi di intelligenza artificiale di Azure sono concessi in licenza con il contratto che regola l'uso di Azure. Se non si dispone di tale contratto, si acconsente che l'uso di Azure sia disciplinato dal Contratto di Sottoscrizione Microsoft Online, in cui sono incluse le condizioni per l'utilizzo dei Servizi Online. Per le anteprime si accettano inoltre le Condizioni Supplementari per l'Utilizzo delle Anteprime di Microsoft Azure. Con l'uso del contenitore si acconsente a rispettare tali condizioni.

Impostazioni Fluentd

Fluentd è un agente di raccolta dati open source per la registrazione unificata. Le impostazioni Fluentd gestiscono la connessione del contenitore a un server Fluentd. Il contenitore include un provider di registrazione di Fluentd che consente al contenitore di scrivere log e, facoltativamente, dati delle metriche in un server di Fluentd.

La tabella seguente illustra le impostazioni di configurazione supportate nella sezione Fluentd.

Name Tipo di dati Descrizione
Host Stringa Indirizzo IP o nome host DNS del server Fluentd.
Port Intero Porta del server Fluentd.
Il valore predefinito è 24224.
HeartbeatMs Intero Intervallo di heartbeat, espresso in millisecondi. Se prima della scadenza di questo intervallo è non stato inviato alcun traffico dell'evento, viene inviato un heartbeat al server Fluentd. Il valore predefinito è 60000 millisecondi (1 minuto).
SendBufferSize Intero Spazio di buffer di rete, espresso in byte, allocato per le operazioni di invio. Il valore predefinito è 32768 byte (32 kilobyte).
TlsConnectionEstablishmentTimeoutMs Intero Timeout, espresso in millisecondi, per stabilire una connessione SSL/TLS con il server Fluentd. Il valore predefinito è 10000 millisecondi (10 secondi).
Se UseTLS è impostato su false, questo valore viene ignorato.
UseTLS Boolean Indica se il contenitore deve usare SSL/TLS per comunicare con il server Fluentd. Il valore predefinito è false.

Impostazioni delle credenziali del proxy HTTP

Se è necessario configurare un proxy HTTP per eseguire le richieste in uscita, usare questi due argomenti:

Name Tipo di dati Descrizione
HTTP_PROXY stringa Il proxy da usare, ad esempio, http://proxy:8888
<proxy-url>
HTTP_PROXY_CREDS stringa Tutte le credenziali necessarie per l'autenticazione nel proxy, username:passwordad esempio . Questo valore deve essere in lettere minuscole.
<proxy-user> stringa L'utente per il proxy.
<proxy-password> stringa La password associata a <proxy-user> per il proxy.
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> \

Impostazioni di registrazione

Le impostazioni Logging gestiscono il supporto di registrazione di ASP.NET Core per il contenitore. È possibile usare le stesse impostazioni di configurazione e gli stessi valori per il contenitore che si usano per un'applicazione ASP.NET Core.

I provider di registrazione seguenti sono supportati dal contenitore:

Provider Scopo
Console Provider di registrazione Console di ASP.NET Core. Tutti i valori predefiniti e le impostazioni di configurazione di ASP.NET Core per questo provider di registrazione sono supportati.
Debug Provider di registrazione Debug di ASP.NET Core. Tutti i valori predefiniti e le impostazioni di configurazione di ASP.NET Core per questo provider di registrazione sono supportati.
Disco Provider di registrazione JSON. Questo provider di registrazione scrive i dati di log nel montaggio di output.

Questo comando del contenitore archivia informazioni di registrazione nel formato JSON al montaggio di output:

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

Questo comando del contenitore visualizza informazioni di debug, con il prefisso dbug, durante l'esecuzione del contenitore:

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

Registrazione su disco

Il provider di registrazione Disk supporta le impostazioni di configurazione seguenti:

Name Tipo di dati Descrizione
Format Stringa Formato di output dei file di log.
Nota: per abilitare il provider di registrazione, questo valore deve essere impostato su json. Se questo valore viene specificato senza specificare anche un montaggio di output durante la creazione di un'istanza di un contenitore, si verifica un errore.
MaxFileSize Intero Dimensione massima, espressa in megabyte (MB), di un file di log. Quando la dimensione del file di log corrente corrisponde a questo valore o lo supera, il provider di registrazione avvia un nuovo file di log. Se viene specificato -1, la dimensione del file di log è limitata solo dalla dimensione massima del file del montaggio di output eventualmente presente. Il valore predefinito è 1.

Per altre informazioni sulla configurazione del supporto di registrazione di ASP.NET Core, vedere Registrazione in ASP.NET Core.

Impostazioni di montaggio

Usare montaggi di associazione per leggere e scrivere dati da e verso il contenitore. È possibile specificare un montaggio di input o di output specificando l'opzione --mount nel comando docker run.

I contenitori del servizio di linguaggio non usano montaggi di input o output per archiviare i dati di training o di servizio.

La sintassi esatta della posizione di montaggio host varia a seconda del sistema operativo host. Inoltre, il percorso di montaggio del computer host potrebbe non essere accessibile a causa di un conflitto tra le autorizzazioni utilizzate dall'account del servizio docker e le autorizzazioni del percorso di montaggio dell'host.

Facoltativo Name Tipo di dati Descrizione
Non consentito Input Stringa I contenitori del servizio di linguaggio non usano questa opzione.
Facoltativo Output Stringa Destinazione del montaggio di output. Il valore predefinito è /output. Questo è il percorso dei log. Include i log dei contenitori.

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

Passaggi successivi