Translator Docker-tárolók konfigurálása
Az Azure AI-szolgáltatások minden tárolóhoz közös konfigurációs keretrendszert biztosítanak. A Translator-tárolókat egyszerűen konfigurálhatja úgy, hogy robusztus felhőbeli képességekre és peremhálózatra optimalizált Translator-alkalmazásarchitektúrát hozzon létre.
A Translator tároló futtatókörnyezete a docker run
parancsargumentumok használatával van konfigurálva. Ez a tároló kötelező és opcionális beállításokkal is rendelkezik. A szükséges tárolóspecifikus beállítások a számlázási beállítások.
Konfigurációs beállítások
A tároló konfigurációs beállításai a következők:
Kötelező | Beállítás | Cél |
---|---|---|
Igen | ApiKey | Nyomon követi a számlázási adatokat. |
Nem | ApplicationInsights | Lehetővé teszi Azure-alkalmazás Elemzések telemetriai támogatás hozzáadását a tárolóhoz. |
Igen | Számlázás | Az Azure-beli szolgáltatáserőforrás végponti URI-ját adja meg. |
Igen | EULA | Azt jelzi, hogy elfogadta a tároló végfelhasználói licencszerződését (EULA). |
Nem | Fluentd | Napló- és metrikaadatokat ír egy Fluentd-kiszolgálóra. |
Nem | HTTP-proxy | HTTP-proxyt konfigurál kimenő kérések végrehajtásához. |
Nem | Logging | ASP.NET Alapvető naplózási támogatást biztosít a tárolóhoz. |
Igen | Tartók | Adatokat olvas be és ír a gazdaszámítógépről a tárolóba, majd a tárolóból vissza a gazdaszámítógépre. |
Fontos
A rendszer együtt használja az ApiKey, a Számlázás és az EULA beállításait, és mindháromhoz érvényes értékeket kell megadnia; ellenkező esetben a tároló nem indul el. További információ arról, hogy ezek a konfigurációs beállítások használatával példányosíthat-e egy tárolót.
ApiKey konfigurációs beállítás
A ApiKey
beállítás megadja a tároló számlázási adatainak nyomon követéséhez használt Azure-erőforráskulcsot. Meg kell adnia egy értéket az ApiKey számára, és az értéknek érvényes kulcsnak kell lennie a konfigurációs beállításhoz megadott Translator-erőforráshozBilling
.
Ez a beállítás a következő helyen található:
- Azure Portal: Translator-erőforrás-kezelés a Kulcsok területen
Alkalmazás Elemzések beállítás
A ApplicationInsights
beállítással Azure-alkalmazás Elemzések telemetriai támogatást adhat a tárolóhoz. Az alkalmazás Elemzések a tároló részletes monitorozását biztosítja. A tárolót egyszerűen monitorozhatja a rendelkezésre állás, a teljesítmény és a használat szempontjából. Emellett gyorsan azonosíthatja és diagnosztizálhatja a tároló hibáit.
Az alábbi táblázat a szakaszban támogatott ApplicationInsights
konfigurációs beállításokat ismerteti.
Szükséges | Név | Adattípus | Leírás |
---|---|---|---|
Nem | InstrumentationKey |
Sztring | Az alkalmazás eszközkulcsa Elemzések példány, amelyre a tároló telemetriai adatait küldi. További információ: Application Elemzések for ASP.NET Core. Példa: InstrumentationKey=123456789 |
Számlázási konfigurációs beállítás
A Billing
beállítás megadja az Azure-beli Translator-erőforrás végponti URI-ját, amely a tároló számlázási adatainak mérésére szolgál. Meg kell adnia egy értéket ehhez a konfigurációs beállításhoz, és az értéknek érvényes végponti URI-nak kell lennie egy Azure-beli Translator-erőforráshoz . A tároló körülbelül 10–15 percenként jelenti a használatot.
Ez a beállítás a következő helyen található:
- Azure Portal: Translator overview page labeled
Endpoint
Szükséges | Név | Adattípus | Leírás |
---|---|---|---|
Igen | Billing |
Sztring | Számlázási végpont URI-ja. A számlázási URI beszerzéséről további információt a szükséges paraméterek összegyűjtésében talál. További információkért és a regionális végpontok teljes listájáért tekintse meg az Azure AI-szolgáltatások egyéni altartományneveit. |
EULA-beállítás
A Eula
beállítás azt jelzi, hogy elfogadta a tároló licencét. Ehhez a konfigurációs beállításhoz meg kell adnia egy értéket, az értéknek pedig a következőre accept
kell lennie.
Szükséges | Név | Adattípus | Leírás |
---|---|---|---|
Igen | Eula |
Sztring | Licenc elfogadása Példa: Eula=accept |
Az Azure AI-szolgáltatások tárolóinak licencelése az Ön szerződése alapján, az Azure használatára vonatkozik. Ha nem rendelkezik az Azure használatára vonatkozó meglévő szerződéssel, elfogadja, hogy az Azure használatára vonatkozó szerződése a Microsoft Online Előfizetési Szerződés, amely tartalmazza az online szolgáltatási feltételeket. Az előzetes verziók esetében ön elfogadja a Microsoft Azure Előzetes verzióra vonatkozó kiegészítő használati feltételeket is. A tároló használatával elfogadja ezeket a feltételeket.
Fluentd-beállítások
A Fluentd egy nyílt forráskódú adatgyűjtő az egységes naplózáshoz. A Fluentd
beállítások kezelik a tároló fluentd-kiszolgálóhoz való kapcsolatát. A tároló tartalmaz egy Fluentd naplózási szolgáltatót, amely lehetővé teszi, hogy a tároló naplókat írjon, és opcionálisan metrikaadatokat írjon egy Fluentd-kiszolgálóra.
Az alábbi táblázat a szakaszban támogatott Fluentd
konfigurációs beállításokat ismerteti.
Név | Adattípus | Leírás |
---|---|---|
Host |
Sztring | A Fluentd-kiszolgáló IP-címe vagy DNS-állomásneve. |
Port |
Egész | A Fluentd-kiszolgáló portja. Az alapértelmezett érték 24224. |
HeartbeatMs |
Egész | A szívverési időköz ezredmásodpercben. Ha az időköz lejárta előtt nem küldött eseményforgalmat, a rendszer szívverést küld a Fluentd-kiszolgálónak. Az alapértelmezett érték 60000 ezredmásodperc (1 perc). |
SendBufferSize |
Egész | A küldési műveletekhez lefoglalt hálózati pufferterület bájtban. Az alapértelmezett érték 32768 bájt (32 kilobájt). |
TlsConnectionEstablishmentTimeoutMs |
Egész | Ezredmásodpercben az időtúllépés a Fluentd-kiszolgálóval létesített SSL-/TLS-kapcsolat létrehozásához. Az alapértelmezett érték 10000 ezredmásodperc (10 másodperc). Ha UseTLS hamis értékre van állítva, a rendszer figyelmen kívül hagyja ezt az értéket. |
UseTLS |
Logikai | Azt jelzi, hogy a tárolónak SSL/TLS protokollt kell-e használnia a Fluentd-kiszolgálóval való kommunikációhoz. Az alapértelmezett érték: hamis. |
HTTP/HTTPS-proxy hitelesítő adatainak beállításai
Ha HTTP-proxyt kell konfigurálnia a kimenő kérések végrehajtásához, használja az alábbi két argumentumot:
Név | Adattípus | Leírás |
---|---|---|
HTTPS_PROXY | húr | A proxy URL-címe, például: 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>
Naplózási beállítások
A Translator-tárolók a következő naplózási szolgáltatókat támogatják:
Szolgáltató | Cél |
---|---|
Console | A ASP.NET Core Console naplózási szolgáltató. A naplózási szolgáltató összes ASP.NET alapkonfigurációs beállítása és alapértelmezett értéke támogatott. |
Debug | A ASP.NET Core Debug naplózási szolgáltató. A naplózási szolgáltató összes ASP.NET alapkonfigurációs beállítása és alapértelmezett értéke támogatott. |
Disk | A JSON-naplózási szolgáltató. Ez a naplózási szolgáltató naplóadatokat ír a kimeneti csatlakoztatáshoz. |
A
Logging
beállítások kezelik a tároló ASP.NET Core naplózási támogatását. Ugyanazokat a konfigurációs beállításokat és értékeket használhatja a tárolóhoz, amelyeket egy ASP.NET Core-alkalmazáshoz használ.A
Logging.LogLevel
naplózandó minimális szintet adja meg. A súlyosságLogLevel
0 és 6 között van. Ha aLogLevel
megadott érték meg van adva, a naplózás engedélyezve van a megadott és magasabb szintű üzenetekhez: Nyomkövetés = 0, Hibakeresés = 1, Információ = 2, Figyelmeztetés = 3, Hiba = 4, Kritikus = 5, Nincs = 6.A Translator-tárolók jelenleg a figyelmeztetési naplószinten vagy annál magasabb szinten korlátozhatják a naplókat.
A naplózás általános parancsszintaxisa a következő:
-Logging:LogLevel:{Provider}={FilterSpecs}
Az alábbi parancs elindítja a Docker-tárolót a Figyelmeztetés és naplózás LogLevel
szolgáltató beállítása konzolra. Ez a parancs rendellenes vagy váratlan eseményeket nyomtat ki a konzolra irányuló alkalmazásfolyamat során:
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
Lemeznaplózás
A Disk
naplózási szolgáltató a következő konfigurációs beállításokat támogatja:
Név | Adattípus | Leírás |
---|---|---|
Format |
Sztring | A naplófájlok kimeneti formátuma. Megjegyzés: Ezt az értéket úgy kell beállítani, hogy json engedélyezze a naplózási szolgáltatót. Ha ez az érték anélkül van megadva, hogy kimeneti csatlakoztatást is megad a tároló példányosítása közben, hiba történik. |
MaxFileSize |
Egész | A naplófájl maximális mérete megabájtban (MB). Ha az aktuális naplófájl mérete eléri vagy meghaladja ezt az értéket, a naplózási szolgáltató új naplófájlt indít el. Ha -1 van megadva, a naplófájl méretét csak a kimeneti csatlakoztatás maximális fájlmérete korlátozza. Az alapértelmezett érték 1. |
Példa lemezszolgáltatóra
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
A ASP.NET Core naplózási támogatásának konfigurálásáról további információt Gépház fájlkonfigurációban talál.
Csatlakoztatási beállítások
A kötés csatlakoztatásával adatokat olvashat és írhat a tárolóba és onnan. A docker-futtatási --mount
parancs beállításának megadásával bemeneti csatlakoztatást vagy kimeneti csatlakoztatást is megadhat.
Következő lépések
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: