Oktatóanyag: Batch-feladat aktiválása az Azure Functions használatával

Ebben az oktatóanyagban megtudhatja, hogyan aktiválhat Batch-feladatokat az Azure Functions használatával. Ez a cikk egy példát mutat be, amely egy Azure Storage-blobtárolóhoz hozzáadott dokumentumokat alkalmaz optikai karakterfelismerésre (OCR) az Azure Batch használatával. Az OCR-feldolgozás egyszerűsítése érdekében ez a példa egy Azure-függvényt konfigurál, amely batch OCR-feladatot futtat minden alkalommal, amikor egy fájlt hozzáad a blobtárolóhoz. Megtudhatja, hogyan:

• Készletek és feladatok létrehozásához használja az Azure Portalt.
• Blobtárolók és közös hozzáférésű jogosultságkód (SAS) létrehozása.
• Hozzon létre egy Azure-függvényt, amelyet Blob aktivál.
• Bemeneti fájlok feltöltése a Tárolóba.
• Tevékenység végrehajtásának figyelése.
• Kimeneti fájlok lekérése.

Előfeltételek

• Egy Azure-fiók, aktív előfizetéssel. Hozzon létre egy fiókot ingyenesen.
• Egy Azure Batch-fiók és egy társított Azure Storage-fiók. A fiókok létrehozásáról és összekapcsolásáról további információt a Batch-fiók létrehozása című témakörben talál.

Bejelentkezés az Azure-ba

Jelentkezzen be a Azure portalra.

Batch-készlet és Batch-feladat létrehozása az Azure Portal használatával

Ebben a szakaszban az Azure Portal használatával hozza létre az OCR-feladatokat futtató Batch-készletet és Batch-feladatot.

Készlet létrehozása

1. Jelentkezzen be az Azure Portalra azure-beli hitelesítő adataival.

2. Hozzon létre egy készletet a bal oldali navigációs sáv Készletek elemének kiválasztásával, majd a keresési űrlap fölött található Hozzáadás gombra kattintva.

   

   1. Adjon meg egy készletazonosítót. Ez a példa a készletet ocr-pool-nek nevezi.
   2. Válassza a Canonical opciót közzétevőként.
   3. Ajánlatként válassza a 0001-com-ubuntu-server-jammy lehetőséget.
   4. Válassza ki a 22_04-ltsSku-ként.
   5. Válassza ki Standard_F2s_v2 - 2 vCPUs, 2 GB Memory a virtuális gép méretét a Csomópontméret szakaszban.
   6. Állítsa a Méretezés szakaszban lévő módotRögzített értékre, és adja meg a 3 értéket a dedikált célcsomópontokhoz.
   7. Állítsa be a Start feladatot úgy, hogy engedélyezve legyen a kezdési feladat, és írja be a parancsot /bin/bash -c "sudo update-locale LC_ALL=C.UTF-8 LANG=C.UTF-8; sudo apt-get update; sudo apt-get -y install ocrmypdf" a parancssorba. Ügyeljen arra, hogy a jogosultságszintetkészlet autouserként, rendszergazdaként állítsa be, amely lehetővé teszi, hogy az indítási feladatok parancsokat tartalmazzanak a következővel sudo: .
   8. Kattintson az OK gombra.

Feladat létrehozása

1. Hozzon létre egy feladatot a feladatlistán a bal oldali navigációs sáv Feladatok elemének kiválasztásával, majd válassza a keresési űrlap feletti Hozzáadás gombot.
   1. Adjon meg egy feladatazonosítót. Ez a példa a következőt használja: ocr-job.
   2. Válassza ki ocr-pool a jelenlegi medencét, vagy a medencéhez választott nevet.
   3. Kattintson az OK gombra.

Blobtárolók létrehozása

Itt blobtárolókat hoz létre, amelyek az OCR Batch-feladat bemeneti és kimeneti fájljait tárolják. Ebben a példában a bemeneti tároló neve van elnevezve input , és a rendszer először az OCR nélküli összes dokumentumot feltölti feldolgozásra. A kimeneti tároló neve el van nevezve output , és a Batch-feladat a feldolgozott dokumentumokat OCR-vel írja.

1. Tárfiókok keresése és kiválasztása az Azure Portalon.

2. Válassza ki a Batch-fiókhoz társított tárfiókot.

3. A bal oldali navigációs sávon válassza a Tárolók lehetőséget, és hozzon létre két blobtárolót (egyet a bemeneti fájlokhoz, egyet a kimeneti fájlokhoz) a Blob-tároló létrehozása lépésekkel.

4. Hozzon létre megosztott hozzáférési aláírást a kimeneti tárolóhoz a kimeneti tároló kiválasztásával, majd a Megosztott hozzáférési jogkivonatok lapon válassza az Írás lehetőséget az Engedélyek legördülő menüben. Nincs szükség más engedélyekre.

5. Válassza a SAS jogkivonat és URL-cím generálása lehetőséget, majd másolja ki a Blob SAS URL-cím a függvény későbbi használatához.

   

Azure-függvény létrehozása

Ebben a szakaszban létrehozza az Azure-függvényt, amely aktiválja az OCR Batch-feladatot, amikor egy fájl feltöltésre kerül a bemeneti konténerbe.

1. A függvény létrehozásához kövesse az Azure Blob Storage által aktivált függvény létrehozása című témakörben leírt lépéseket.

   1. Futtatókörnyezeti verem esetén válassza a .NET lehetőséget. Ez a példafüggvény a C# használatával használja a Batch .NET SDK előnyeit.
   2. A Storage lapon használja ugyanazt a tárfiókot, amelyet a Batch-fiókhoz csatolt.
   3. Válassza a Véleményezés + Létrehozás lehetőséget>.

   Az alábbi képernyőkép a Függvényalkalmazás létrehozása lap az Alapok lapon, példaadatok használatával.

   

2. A függvényben válassza a Függvények lehetőséget a bal oldali navigációs sávon, és válassza a Létrehozás lehetőséget.

3. A Függvény létrehozása panelen válassza az Azure Blob Storage-eseményindítót.

4. Adja meg a függvény nevét az Új függvényben. Ebben a példában a név OcrTrigger. Adja meg az elérési utat úgy, hogy a input/{name} helyén a Blob-tároló nevét használja bemenetként.

5. Válassza a Create gombot.

   

6. A blob által aktivált függvény létrehozása után válassza a Kód + Teszt lehetőséget. Használja a run.csx és function.proj elemeket a GitHubból a függvényben. function.proj alapértelmezés szerint nem létezik, ezért válassza a Feltöltés gombot a fejlesztési munkaterületre való feltöltéshez.

   • run.csx akkor fut, ha új blobot ad hozzá a bemeneti blobtárolóhoz.
   • function.proj A függvénykód külső kódtárait sorolja fel, például a Batch .NET SDK-t.

7. Módosítsa a változók helyőrző értékeit a Run() fájl run.csx függvényében úgy, hogy azok tükrözzék a Batch és a tár hitelesítő adatait. A Batch és a tárfiók hitelesítő adatait az Azure Portalon, a Batch és a tárfiók Kulcsok szakaszában találja.

A függvény aktiválása és az eredmények lekérése

Töltsön fel bármelyik vagy az összes beolvasott fájlt a input_files könyvtárból a GitHubon a bemeneti konténerbe.

A függvényt az Azure Portalon tesztelheti a függvény Kód + Teszt oldalán.

1. Válassza a Teszt/futtatás lehetőséget a Kód + Teszt lapon.
2. Adja meg a bemeneti tároló elérési útját a Bevitel lapon a Törzs lapon.
3. Válassza a Futtatás parancsot.

Néhány másodperc elteltével az OCR-t tartalmazó fájl hozzáadódik a kimeneti tárolóhoz. A naplóinformációk az alsó ablakba kerülnek ki. A fájl ezután látható és lekérthető a Storage Explorerben.

A naplóadatokat a Monitor lapon is megtalálhatja:

2019-05-29T19:45:25.846 [Information] Creating job...
2019-05-29T19:45:25.847 [Information] Accessing input container <inputContainer>...
2019-05-29T19:45:25.847 [Information] Adding <fileName> as a resource file...
2019-05-29T19:45:25.848 [Information] Name of output text file: <outputTxtFile>
2019-05-29T19:45:25.848 [Information] Name of output PDF file: <outputPdfFile>
2019-05-29T19:45:26.200 [Information] Adding OCR task <taskID> for <fileName> <size of fileName>...

A kimeneti fájlok helyi gépre való letöltéséhez nyissa meg a tárfiók kimeneti tárolóját. Válassza ki a kívánt fájl további beállításait, majd válassza a Letöltés lehetőséget.

Jótanács

A letöltött fájlok kereshetők, ha pdf-olvasóban vannak megnyitva.

Erőforrások tisztítása

A csomópontkészletért akkor is fizetnie kell, amíg a csomópontok futnak, még akkor is, ha nincsenek ütemezve feladatok. Ha már nincs szüksége a készletre, törölje a következő lépésekkel:

1. A Batch-fiók Készletek lapján válassza ki a készlet további beállításait.
2. Válassza a Törlés lehetőséget.

Amikor a készletet törli, a csomópontokon lévő összes feladat kimenete is törlődik. A kimeneti fájlok azonban megmaradnak a Storage-fiókban. Ha már nincs rá szükség, törölheti a Batch-fiókot és a tárfiókot is.

Következő lépések

A .NET API-val a Batch számítási feladatainak ütemezésére és feldolgozására vonatkozó további példákért tekintse meg a GitHubon található mintákat.

• Batch C#-minták