Megosztás a következőn keresztül:

Translator Docker-tárolók konfigurálása

  • Cikk

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 acceptkell 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ág LogLevel 0 és 6 között van. Ha a LogLevel 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

További információ az Azure AI-tárolókról