Olvasási OCR Docker-tárolók konfigurálása

  • Cikk

Az Azure AI Vision Read OCR-tároló futtatókörnyezetét a docker run parancsargumentumok használatával konfigurálhatja. Ez a tároló számos kötelező beállítással és néhány választható beállítással rendelkezik. A parancsra számos példa érhető el. A 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:

Szükséges 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 ApiKeyrendszer 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. A tárolók példányosításához a konfigurációs beállítások használatával kapcsolatos további információkért lásd a Számlázás című témakört.

A tároló a következő tárolóspecifikus konfigurációs beállításokat is tartalmazza:

Szükséges Beállítás Cél
Nem ReadEngineConfig:ResultExpirationPeriod Csak 2.0-s tárolók. Az eredmény lejárati ideje órákban. Az alapértelmezett érték 48 óra. A beállítás megadja, hogy a rendszer mikor törölje a felismerési eredményeket. Ha például resultExpirationPeriod=1a rendszer a folyamat után 1 órával törli a felismerési eredményt. Ha resultExpirationPeriod=0, a rendszer törli a felismerési eredményt az eredmény lekérése után.
Nem Gyorsítótár:Redis Csak 2.0-s tárolók. Lehetővé teszi a Redis Storage számára az eredmények tárolását. Gyorsítótárra van szükség , ha több olvasási OCR-tárolót helyeznek el egy terheléselosztó mögött.
Nem Üzenetsor:RabbitMQ Csak 2.0-s tárolók. Engedélyezi a RabbitMQ-t a feladatok továbbításához. Ez a beállítás akkor hasznos, ha több olvasási OCR-tárolót helyeznek el egy terheléselosztó mögött.
Nem Queue:Azure:QueueVisibilityTimeoutInMilliseconds Csak v3.x tárolók. Az az idő, amikor egy üzenet láthatatlanná válik, amikor egy másik feldolgozó feldolgozta azt.
Nem Storage::D ocumentStore::MongoDB Csak 2.0-s tárolók. Engedélyezi a MongoDB-t az állandó találatok tárolásához.
Nem Storage:ObjectStore:AzureBlob:Csatlakozás ionString Csak v3.x tárolók. Azure Blob Storage kapcsolati sztring.
Nem Tárolás:TimeToLiveInDays Csak v3.x tárolók. Az eredmény lejárati ideje napokban. A beállítás megadja, hogy a rendszer mikor törölje a felismerési eredményeket. Az alapértelmezett érték 2 nap, ami azt jelenti, hogy az adott időszaknál hosszabb ideig élő eredmények nem garantáltan sikeresen lekérhetők. Az érték egész szám, és 1 nap és 7 nap között kell lennie.
Nem StorageTimeToLiveInMinutes v3.2-model-2021-09-30-preview és új tárolók. Az eredmény lejárati ideje percekben. A beállítás megadja, hogy a rendszer mikor törölje a felismerési eredményeket. Az alapértelmezett érték 2 nap (2880 perc), ami azt jelenti, hogy az adott időszaknál hosszabb ideig élő eredmények nem garantáltan sikeresen lekérhetők. Az érték egész szám, és 60 perc és 7 nap között kell lennie (10080 perc).
Nem Feladat:MaxRunningTimeSpanInMinutes Csak v3.x tárolók. Egyetlen kérelem maximális futási ideje. Az alapértelmezett érték 60 perc.
Nem EnableSyncNTPServer Csak v3.x tárolók, kivéve a 3.2-model-2021-09-30-preview és újabb tárolókat. Engedélyezi az NTP-kiszolgáló szinkronizálási mechanizmusát, amely biztosítja a rendszeridő és a várt feladat futásideje közötti szinkronizálást. Vegye figyelembe, hogy ehhez külső hálózati forgalom szükséges. Az alapértelmezett érték true.
Nem NTPServerAddress Csak v3.x tárolók, kivéve a 3.2-model-2021-09-30-preview és újabb tárolókat. NTP-kiszolgáló a szinkronizálás idejére. Az alapértelmezett érték time.windows.com.
Nem Csatlakoztatások:Megosztott Csak v3.x tárolók. A felismerési eredmény tárolására szolgáló helyi mappa. Az alapértelmezett érték /share. Ha a tárolót az Azure Blob Storage használata nélkül futtatja, javasoljuk, hogy csatlakoztassa a kötetet ehhez a mappához, hogy elegendő hely legyen a felismerési eredményekhez.

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 Vision-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 Vision-erőforráshoz Billing .

Ez a beállítás a következő helyen található:

  • Azure Portal: Azure AI-szolgáltatások erőforrás-kezelése 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 a tároló számlázási adatainak mérésére használt Azure AI-szolgáltatási erőforrás végponti URI-ját az Azure-ban. 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 AI-szolgáltatási erőforráshoz az Azure-ban. 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: Az Azure AI-szolgáltatások áttekintése, címkézett Endpoint

Ne felejtse el hozzáadni az vision/<version> útválasztást a végpont URI-hoz az alábbi táblázatban látható módon.

Szükséges Név Adattípus Leírás
Igen Billing Sztring Számlázási végpont URI-ja

Példa:
Billing=https://westcentralus.api.cognitive.microsoft.com/vision/v3.2

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-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 húr A használni kívánt proxy, például: http://proxy:8888
<proxy-url>
HTTP_PROXY_CREDS húr 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> húr A proxy felhasználója.
<proxy-password> húr 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:

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.

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 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ó 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.

Az Azure AI Vision-tárolók nem használnak bemeneti vagy kimeneti csatlakoztatásokat a betanítási vagy szolgáltatási adatok tárolásához.

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.

Választható Név Adattípus Leírás
Nem engedélyezett Input Sztring Az Azure AI Vision-tárolók ezt nem használják.
Választható Output Sztring A kimeneti csatlakoztatás célja. Az alapértelmezett érték /output. Ez a naplók helye. Ide tartoznak a tárolónaplók.

Példa:
--mount type=bind,src=c:\output,target=/output

Példa Docker-futtatási parancsok

Az alábbi példák a konfigurációs beállításokkal szemléltetik a parancsok írását és használatát docker run . A futtatás után a tároló addig fut, amíg le nem állítja .

  • Vonal-folytatás karakter: A következő szakaszok Docker-parancsai a fordított perjelet használják, \vonal folytatási karakterként. Cserélje le vagy távolítsa el ezt a gazda operációs rendszer követelményei alapján.
  • Argumentumsorrend: Ne módosítsa az argumentumok sorrendjét, hacsak nem ismeri a Docker-tárolókat.

A(z) {argument_name} helyére írja be a saját értékeit:

Helyőrző Érték Formátum vagy példa
{API_KEY} A Vision-erőforrás végpontkulcsa az erőforráskulcsok lapján. xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
{ENDPOINT_URI} A számlázási végpont értéke az erőforrás áttekintési oldalán érhető el. Az explicit példákhoz tekintse meg a szükséges paraméterek gyűjtését.

Feljegyzés

A 2019. július 1. után létrehozott új erőforrások egyéni altartományneveket fognak használni. 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.

Fontos

A Eulatároló futtatásához meg kell adni a , Billingés ApiKey a beállításokat, ellenkező esetben a tároló nem indul el. További információ: Számlázás. Az ApiKey értéke a Vision erőforráskulcsok oldal kulcsa.

Példák a Container Dockerre

Az alábbi Docker-példák az olvasási OCR-tárolóra mutatnak.

Egyszerű példa

docker run --rm -it -p 5000:5000 --memory 16g --cpus 8 \
mcr.microsoft.com/azure-cognitive-services/vision/read:3.2-model-2022-04-30 \
Eula=accept \
Billing={ENDPOINT_URI} \
ApiKey={API_KEY}

Példa naplózásra

docker run --rm -it -p 5000:5000 --memory 16g --cpus 8 \
mcr.microsoft.com/azure-cognitive-services/vision/read:3.2-model-2022-04-30 \
Eula=accept \
Billing={ENDPOINT_URI} \
ApiKey={API_KEY}
Logging:Console:LogLevel:Default=Information

Következő lépések

  • Tekintse át a tárolók telepítésének és futtatásának módját.