Docker-tárolók használata leválasztott környezetekben

A tárolók lehetővé teszik az Azure AI-szolgáltatások API-k futtatását a saját környezetében, és kiválóan megfelelnek a konkrét biztonsági és adatszabályozási követelményeknek. A leválasztott tárolók lehetővé teszik, hogy az internetről leválasztott API-k közül több is használható legyen. Jelenleg a következő tárolók futtathatók így:

Mielőtt megpróbálna docker-tárolót futtatni offline környezetben, győződjön meg arról, hogy ismeri a tároló sikeres letöltésének és használatának lépéseit. Például:

  • A gazdagépre vonatkozó követelmények és javaslatok.
  • A tároló letöltéséhez használt Docker-parancs pull .
  • Tároló futásának ellenőrzése.
  • Lekérdezések küldése a tároló végpontjára a futtatás után.

Hozzáférés kérése a tárolók leválasztott környezetekben való használatához

Töltse ki és küldje el a kéreleműrlapot, hogy hozzáférést kérjen az internetről leválasztott tárolókhoz.

Az űrlap információt kér Önről, a vállalatról és arról a felhasználói forgatókönyvről, amelyhez a tárolót használni fogja. Az űrlap elküldése után az Azure AI-szolgáltatások csapata 10 munkanapon belül áttekinti azt, és e-mailben elküldi Önnek a döntést.

Fontos

  • Az űrlapon egy Azure-előfizetés-azonosítóhoz társított e-mail-címet kell használnia.
  • A tároló futtatásához használt Azure-erőforrást a jóváhagyott Azure-előfizetés-azonosítóval kell létrehozni.
  • Ellenőrizze az e-mail-címét (a beérkezett üzeneteket és a levélszemétmappát is) az alkalmazás állapotával kapcsolatos frissítésekért a Microsofttól.

A jóváhagyás után a cikk későbbi részében ismertetett Microsoft Container Registryből (MCR) való letöltés után futtathatja a tárolót.

Nem fogja tudni futtatni a tárolót, ha az Azure-előfizetését nem hagyta jóvá.

A hozzáférés az alábbi követelményeknek megfelelő ügyfelekre korlátozódik:

  • A szervezetet stratégiai ügyfélként vagy a Microsofttal való partnerként kell azonosítani.
  • A leválasztott tárolók várhatóan teljesen offline állapotban futnak, ezért a használati eseteknek meg kell felelniük az alábbi vagy hasonló követelmények egyikének:
    • Olyan környezet vagy eszköz(ek), amely nem rendelkezik internetkapcsolattal.
    • Távoli hely, amely időnként rendelkezik internet-hozzáféréssel.
    • Szigorú szabályozás alá tartozó szervezet, amely semmilyen adatot nem küld vissza a felhőbe.
  • Az alkalmazás az utasításoknak megfelelően fejeződött be – Ügyeljen arra, hogy az alkalmazás teljes egészében útmutatást nyújtson annak biztosítása érdekében, hogy minden szükséges információt megadjon a jóváhagyáshoz.

Kötelezettségvállalási szint díjszabási csomagjának vásárlása leválasztott tárolókhoz

Új erőforrás létrehozása

  1. Jelentkezzen be az Azure Portalra , és válassza a Fent felsorolt azure AI-szolgáltatások egyikének új erőforrásának létrehozása lehetőséget.

  2. Adja meg az erőforrás létrehozásához szükséges információkat. Tarifacsomagként mindenképpen válassza ki a leválasztott kötelezettségvállalási szintet.

    Megjegyzés:

    • A kötelezettségvállalási szint megvásárlásának lehetősége csak akkor jelenik meg, ha a Microsoft jóváhagyta.
    • A díjszabás részletei például csak.
  3. Válassza a Véleményezés + Létrehozás lehetőséget a lap alján. Tekintse át az információkat, és válassza a Létrehozás lehetőséget.

Tároló konfigurálása leválasztott használatra

A tároló leválasztott használatra való letöltésének és konfigurálásának lépéseit a következő dokumentációban találja:

Beszédszolgáltatás

Nyelvi szolgáltatás

Környezeti változók nevei a Kubernetes-üzemelő példányokban

Egyes Azure AI-tárolók, például a Translator megkövetelik, hogy a felhasználók olyan környezeti változóneveket adjanak át, amelyek kettőspontokat (:) tartalmaznak a tároló futtatásakor. Ez a Docker használatakor jól működik, de a Kubernetes nem fogadja el a kettőspontokat a környezeti változók neveiben. A probléma megoldásához dupla aláhúzásjelre (__) cserélheti a kettőspont-karaktereket a Kubernetesben való üzembe helyezéskor. A környezeti változók neveinek elfogadható formátumát az alábbi példában tekinthetik meg:

        env:  
        - name: Mounts__License
          value: "/license"
        - name: Mounts__Output
          value: "/output"

Ez a példa felülírja a docker-futtatási parancsban szereplő és Mounts:Output a Mounts:License környezeti változók neveinek alapértelmezett formátumát.

Tárolórendszerképek és licencfrissítések

A tárolólicencek fájljai kulcsként szolgálnak az egyes tárolólemezképek bizonyos fájljainak visszafejtéséhez. Ha ezek a titkosított fájlok egy új tárolórendszerképen belül frissülnek, előfordulhat, hogy a licencfájl nem tudja elindítani a tárolót, még akkor is, ha az a tárolólemezkép előző verziójával működött. A probléma elkerülése érdekében javasoljuk, hogy töltsön le egy új licencfájlt az Azure Portalon megadott tároló erőforrás-végpontjáról, miután lekérte az új lemezképverziókat mcr.microsoft.com.

Új licencfájl letöltéséhez hozzáadhatja DownloadLicense=True a Docker-futtatási parancsot egy licenccsatlakozással, az API-kulccsal és a számlázási végponttal együtt. Részletes útmutatásért tekintse meg a tároló dokumentációját .

Használati rekordok

Ha a Docker-tárolókat leválasztott környezetben üzemelteti, a tároló használati rekordokat fog írni egy kötetbe, ahol azokat idővel összegyűjtik. REST-végpontot is meghívhat, hogy jelentést hozzon létre a szolgáltatáshasználatról.

A naplók tárolásának argumentumai

Ha leválasztott környezetben fut, a tárolóhoz kimeneti csatlakoztatásnak kell rendelkezésre állnia a használati naplók tárolásához. Az alábbi példában például -v /host/output:{OUTPUT_PATH}Mounts:Output={OUTPUT_PATH} a naplók tárolásának elérési útját kell megadnia {OUTPUT_PATH} :

docker run -v /host/output:{OUTPUT_PATH} ... <image> ... Mounts:Output={OUTPUT_PATH}

Rekordok lekérése a tárolóvégpontok használatával

A tároló két végpontot biztosít a használat rekordjainak visszaadására.

Az összes rekord lekérése

A következő végpont egy jelentést biztosít, amely összegzi a csatlakoztatott számlázási rekord könyvtárában összegyűjtött összes használatot.

https://<service>/records/usage-logs/

Az alábbi példához hasonló JSON-t ad vissza.

{
  "apiType": "noop",
  "serviceName": "noop",
  "meters": [
    {
      "name": "Sample.Meter",
      "quantity": 253
    }
  ]
}

Egy adott hónap rekordjainak lekérése

Az alábbi végpont egy jelentést biztosít, amely egy adott hónap és év használatát összegzi.

https://<service>/records/usage-logs/{MONTH}/{YEAR}

az alábbi példához hasonló JSON-választ ad vissza:

{
  "apiType": "string",
  "serviceName": "string",
  "meters": [
    {
      "name": "string",
      "quantity": 253
    }
  ]
}

Tárolók leválasztott környezetekben való használatára vonatkozó kötelezettségvállalási terv vásárlása

A leválasztott tárolókra vonatkozó kötelezettségvállalási tervek naptári évre vonatkozó kötelezettségvállalási időszakhoz tartoznak. A csomag megvásárlásakor a teljes árat azonnal felszámítjuk. A kötelezettségvállalási időszak alatt nem módosíthatja a kötelezettségvállalási tervet, de az év hátralévő napjaira vonatkozóan előre meghatározott áron vásárolhat további egységeket. A kötelezettségvállalás utolsó napján éjfélig (UTC) kell befejeznie egy kötelezettségvállalási tervet.

Másik kötelezettségvállalási csomagot választhat az erőforrás kötelezettségvállalási rétegének díjszabási beállításai között.

Kötelezettségvállalási terv befejezése

Ha úgy dönt, hogy nem szeretné folytatni a kötelezettségvállalási csomag megvásárlását, beállíthatja, hogy az erőforrás automatikus megújítása ne legyen automatikusan megújítva. A kötelezettségvállalási terv a megjelenített kötelezettségvállalási befejezési napon lejár. Ezen dátum után a kötelezettségvállalási tervért nem kell fizetnie. Továbbra is használhatja az Azure-erőforrást API-hívások indítására, használatalapú fizetéssel. Az év utolsó napján éjfélig (UTC) kell befejeznie a leválasztott tárolókra vonatkozó kötelezettségvállalási tervet, és a következő évben nem kell fizetnie.

Hibaelhárítás

Ha a tárolót kimeneti csatlakoztatással és naplózással futtatja, a tároló olyan naplófájlokat hoz létre, amelyek segítenek elhárítani a tároló indításakor vagy futtatásakor felmerülő problémákat.

Tipp.

További hibaelhárítási információkért és útmutatásért tekintse meg a leválasztott tárolókra vonatkozó gyakori kérdéseket (GYIK).

Következő lépések

Az Azure AI-tárolók áttekintése