Konfigurace kontejnerů Translator Dockeru
Služby Azure AI poskytují každému kontejneru společnou konfigurační architekturu. Kontejnery Služby Translator můžete snadno nakonfigurovat tak, aby se sestavila architektura aplikace Translator optimalizovaná pro robustní cloudové funkce a umístění hraničních zařízení.
Prostředí modulu runtime kontejneru Translator se konfiguruje pomocí docker run argumentů příkazu. Tento kontejner má požadovaná i volitelná nastavení. Požadovaná nastavení specifická pro kontejnery jsou nastavení fakturace.
Nastavení konfigurace
Kontejner má následující nastavení konfigurace:
| Požaduje se | Nastavení | Purpose |
|---|---|---|
| Ano | Klíč rozhraní API | Sleduje fakturační údaje. |
| No | ApplicationInsights | Umožňuje do kontejneru přidat Aplikace Azure lication Insights telemetrickou podporu. |
| Ano | Fakturace | Určuje identifikátor URI koncového bodu prostředku služby v Azure. |
| Ano | EULA | Označuje, že jste přijali licenční smlouvu s koncovým uživatelem (EULA) pro kontejner. |
| No | Fluentd | Zapisuje protokoly a volitelně data metrik na server Fluentd. |
| No | HTTP Proxy | Nakonfiguruje proxy server HTTP pro vytváření odchozích požadavků. |
| No | Protokolování | Poskytuje podporu protokolování ASP.NET Core pro váš kontejner. |
| Ano | Montuje | Čte a zapisuje data z hostitelského počítače do kontejneru a z kontejneru zpět do hostitelského počítače. |
Důležité
Nastavení ApiKey, Billing a EULA se používají společně a musíte zadat platné hodnoty pro všechny tři z nich. Jinak se váš kontejner nespustí. Další informace o použití těchto nastavení konfigurace k vytvoření instance kontejneru.
Nastavení konfigurace ApiKey
Nastavení ApiKey určuje klíč prostředku Azure použitý ke sledování fakturačních údajů pro kontejner. Musíte zadat hodnotu pro ApiKey a hodnota musí být platný klíč pro prostředek Translator určený pro Billing nastavení konfigurace.
Toto nastavení najdete na následujícím místě:
- Azure Portal: Správa prostředků Translatoru v části Klíče
Nastavení ApplicationInsights
Nastavení ApplicationInsights umožňuje do kontejneru přidat podporu telemetrie Aplikace Azure lication Insights. Application Insights poskytuje podrobné monitorování kontejneru. Kontejner můžete snadno monitorovat z hlediska dostupnosti, výkonu a využití. Můžete také rychle identifikovat a diagnostikovat chyby v kontejneru.
Následující tabulka popisuje nastavení konfigurace podporovaná ApplicationInsights v části.
| Požaduje se | Name | Datový typ | Popis |
|---|---|---|---|
| No | InstrumentationKey |
String | Instrumentační klíč instance Application Insights, do které se odesílají telemetrická data kontejneru. Další informace najdete v tématu Application Insights pro ASP.NET Core. Příklad: InstrumentationKey=123456789 |
Nastavení konfigurace fakturace
Nastavení Billing určuje identifikátor URI koncového bodu prostředku Translatoru v Azure, který se používá k měření fakturačních údajů kontejneru. Musíte zadat hodnotu pro toto nastavení konfigurace a hodnota musí být platným identifikátorem URI koncového bodu pro prostředek translatoru v Azure. Kontejner hlásí využití přibližně každých 10 až 15 minut.
Toto nastavení najdete na následujícím místě:
- Azure Portal: Stránka Přehled služby Translator s popiskem
Endpoint
| Požaduje se | Name | Datový typ | Popis |
|---|---|---|---|
| Ano | Billing |
String | Identifikátor URI koncového bodu fakturace Další informace o získání identifikátoru URI fakturace najdete v tématu shromáždění požadovaných parametrů. Další informace a úplný seznam regionálních koncových bodů najdete v tématu Vlastní subdomény pro služby Azure AI. |
Nastavení EULA
Nastavení Eula značí, že jste přijali licenci pro kontejner. Je nutné zadat hodnotu pro toto nastavení konfigurace a hodnota musí být nastavena na accept.
| Požaduje se | Name | Datový typ | Popis |
|---|---|---|---|
| Ano | Eula |
String | Přijetí licence Příklad: Eula=accept |
Kontejnery služeb Azure AI jsou licencované podle vaší smlouvy , která se řídí používáním Azure. Pokud nemáte stávající smlouvu, která se řídí používáním Azure, souhlasíte s tím, že vaše smlouva, která se řídí používáním Azure, je Smlouva o předplatném Microsoft Online, která zahrnuje podmínky online služeb. U verzí Preview souhlasíte také s dodatečnými podmínkami použití pro verze Preview Microsoft Azure. Použitím kontejneru souhlasíte s těmito podmínkami.
Nastavení fluentd
Fluentd je opensourcový kolektor dat pro jednotné protokolování. Nastavení Fluentd spravuje připojení kontejneru k serveru Fluentd . Kontejner obsahuje zprostředkovatele protokolování Fluentd, který kontejneru umožňuje zapisovat protokoly a volitelně data metrik na server Fluentd.
Následující tabulka popisuje nastavení konfigurace podporovaná Fluentd v části.
| Name | Datový typ | Popis |
|---|---|---|
Host |
String | IP adresa nebo název hostitele DNS serveru Fluentd. |
Port |
Celé číslo | Port serveru Fluentd. Výchozí hodnota je 24224. |
HeartbeatMs |
Celé číslo | Interval prezenčního signálu v milisekundách. Pokud se před vypršením tohoto intervalu neposílal žádný provoz událostí, odešle se na server Fluentd prezenčních signálů. Výchozí hodnota je 60000 milisekund (1 minuta). |
SendBufferSize |
Celé číslo | Prostor vyrovnávací paměti sítě v bajtech přidělený pro operace odesílání. Výchozí hodnota je 32768 bajtů (32 kilobajtů). |
TlsConnectionEstablishmentTimeoutMs |
Celé číslo | Časový limit v milisekundách pro navázání připojení SSL/TLS k serveru Fluentd. Výchozí hodnota je 1 0000 milisekund (10 sekund). Pokud UseTLS je nastavená hodnota false, tato hodnota se ignoruje. |
UseTLS |
Logická hodnota | Určuje, jestli má kontejner pro komunikaci se serverem Fluentd používat protokol SSL/TLS. Výchozí hodnota je false. |
Nastavení přihlašovacích údajů proxy serveru HTTP/HTTPS
Pokud potřebujete nakonfigurovat proxy server HTTP pro vytváření odchozích požadavků, použijte tyto dva argumenty:
| Name | Datový typ | Popis |
|---|---|---|
| HTTPS_PROXY | string | Adresa URL proxy serveru, například 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>
Nastavení protokolování
Kontejnery Služby Translator podporují následující zprostředkovatele protokolování:
| Poskytovatel | Účel |
|---|---|
| Konzola | Zprostředkovatel protokolování ASP.NET Core Console . Podporují se všechna nastavení konfigurace ASP.NET Core a výchozí hodnoty tohoto zprostředkovatele protokolování. |
| Debug | Zprostředkovatel protokolování ASP.NET Core Debug . Podporují se všechna nastavení konfigurace ASP.NET Core a výchozí hodnoty tohoto zprostředkovatele protokolování. |
| Disk | Zprostředkovatel protokolování JSON. Tento zprostředkovatel protokolování zapisuje data protokolu do připojení výstupu. |
Nastavení
Loggingspravují podporu protokolování ASP.NET Core pro váš kontejner. Pro kontejner, který používáte pro aplikaci ASP.NET Core, můžete použít stejná nastavení a hodnoty konfigurace.Určuje
Logging.LogLevelminimální úroveň, která se má protokolovat. Závažnost rozsahůLogLevelod 0 do 6.LogLevelPři zadání je protokolování povoleno pro zprávy na zadané úrovni a vyšší: Trace = 0, Debug = 1, Information = 2, Warning = 3, Error = 4, Critical = 5, None = 6.V současné době mají kontejnery Translator možnost omezit protokoly na úrovni protokolu upozornění nebo vyšší.
Obecná syntaxe příkazu pro protokolování je následující:
-Logging:LogLevel:{Provider}={FilterSpecs}
Následující příkaz spustí kontejner Dockeru s nastavenou LogLevel možností Upozornění a zprostředkovatel protokolování nastaveným na Konzolu. Tento příkaz vypíše neobvyklé nebo neočekávané události během toku aplikace do konzoly:
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
Protokolování disku
Disk Zprostředkovatel protokolování podporuje následující nastavení konfigurace:
| Name | Datový typ | Popis |
|---|---|---|
Format |
String | Výstupní formát souborů protokolu. Poznámka: Tato hodnota musí být nastavena na json povolení zprostředkovatele protokolování. Pokud je tato hodnota zadána bez zadání výstupního připojení při vytváření instance kontejneru, dojde k chybě. |
MaxFileSize |
Celé číslo | Maximální velikost souboru protokolu v megabajtech (MB). Pokud velikost aktuálního souboru protokolu splňuje nebo překročí tuto hodnotu, poskytovatel protokolování spustí nový soubor protokolu. Pokud je zadán parametr -1, je velikost souboru protokolu omezena pouze maximální velikostí souboru, pokud existuje, pro připojení výstupu. Výchozí hodnota je 1. |
Příklad poskytovatele disků
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
Další informace o konfiguraci podpory protokolování ASP.NET Core najdete v tématu Konfigurace souboru nastavení.
Nastavení připojení
Připojení vazby slouží ke čtení a zápisu dat do a z kontejneru. Vstupní připojení nebo výstupní připojení můžete zadat zadáním --mount možnosti v příkazu docker run .