A Language Service Docker-tárolóinak konfigurálása
A Language Service minden tárolóhoz egy általános konfigurációs keretrendszert biztosít, így egyszerűen konfigurálhatja és kezelheti a tárolók tárolási, naplózási és telemetriai beállításait, valamint biztonsági beállításait. Ez a cikk a következő tárolókra vonatkozik:
- Hangulatelemzés
- Nyelvfelismerés
- Kulcskifejezések kinyerése
- Egészségügyi Text Analytics
- Összegzés
- Nevesített entitások felismerése (NER)
Konfigurációs beállítások
A tároló konfigurációs beállításai a következők:
Required | 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ó licencét. |
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. |
Nem | 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 ApiKey
rendszer együtt használja a , Billing
és Eula
a beállításokat, és mind a háromhoz érvényes értékeket kell megadnia; ellenkező esetben a tároló nem indul el.
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 a kulcshoz, és érvényes kulcsnak kell lennie a konfigurációs beállításhoz megadott nyelvi erőforráshoz Billing
.
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 | Name | 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 nyelvi 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 nyelvi erőforráshoz. A tároló körülbelül 10–15 percenként jelenti a használatot.
Szükséges | Name | Adattípus | Leírás |
---|---|---|---|
Igen | Billing |
Sztring | Számlázási végpont URI-ja. |
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 | Name | 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 |
Integer | A Fluentd-kiszolgáló portja. Az alapértelmezett érték 24224. |
HeartbeatMs |
Integer | 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 |
Integer | 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 |
Integer | 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 |
Boolean | 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-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 |
---|---|---|
HTTP_PROXY | sztring | A használni kívánt proxy, például: http://proxy:8888 <proxy-url> |
HTTP_PROXY_CREDS | sztring | A proxyn való hitelesítéshez szükséges hitelesítő adatok, például username:password . Ennek az értéknek kisbetűsnek kell lennie. |
<proxy-user> |
sztring | A proxy felhasználója. |
<proxy-password> |
sztring | A proxyhoz <proxy-user> társított jelszó. |
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> \
Naplózási beállítások
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 tároló a következő naplózási szolgáltatókat támogatja:
Provider | 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. |
Ez a tárolóparancs JSON formátumban tárolja a naplózási adatokat a kimeneti csatlakoztatáshoz:
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
Ez a tárolóparancs a hibakeresési információkat jeleníti meg, a tároló futása közben előtaggal dbug
:
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
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 |
Integer | 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ó elindít egy új naplófájlt. 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. |
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.
A Nyelvi szolgáltatás tárolói nem használnak bemeneti vagy kimeneti csatlakoztatásokat a betanítási vagy szolgáltatásadatok tárolására.
A gazdagép csatlakoztatási helyének pontos szintaxisa a gazdagép operációs rendszerétől függően változik. Emellett előfordulhat, hogy a gazdaszámítógép csatlakoztatási helye nem érhető el a Docker szolgáltatásfiók által használt engedélyek és a gazdagép csatlakoztatási helyének engedélyei közötti ütközés miatt.
Optional | Név | Adattípus | Leírás |
---|---|---|---|
Nem engedélyezett | Input |
Sztring | A nyelvi szolgáltatás tárolói ezt nem használják. |
Optional | Output |
Sztring | A kimeneti csatlakoztatás célja. The default value is /output . Ez a naplók helye. Ide tartoznak a tárolónaplók. Példa: --mount type=bind,src=c:\output,target=/output |
Következő lépések
- További Azure AI-tárolók használata