A Térinformatikai tároló telepítése és futtatása (előzetes verzió)

A Térinformatikai tároló lehetővé teszi valós idejű streamelési videó elemzését, hogy megértse az emberek közötti térbeli kapcsolatokat, azok mozgását és a fizikai környezetekben lévő objektumokkal való interakciókat. A tárolók segítenek megfelelni bizonyos biztonsági és adatszabályozási követelményeknek.

Előfeltételek

  • Azure-előfizetés – Ingyenes létrehozás
  • Az Azure-fióknak rendelkeznie kell egy Cognitive Services Contributor szerepkörrel ahhoz, hogy elfogadja a felelős AI-feltételeket, és létrehozhasson egy erőforrást. Ha hozzá szeretné rendelni ezt a szerepkört a fiókjához, kövesse a Szerepkörök hozzárendelése dokumentáció lépéseit, vagy forduljon a rendszergazdához.
  • Miután megkapta az Azure-előfizetését, hozzon létre egy Computer Vision-erőforrást a Standard S1 szinthez az Azure Portalon a kulcs és a végpont lekéréséhez. Az üzembe helyezés után válassza az Ugrás az erőforrásra lehetőséget.
    • A térinformatikai tároló futtatásához szüksége lesz a létrehozott erőforrás kulcsára és végpontjára. A kulcsot és a végpontot később fogja használni.

Térinformatikai tárolókövetelmények

A térinformatikai tároló futtatásához nvidia CUDA számítási képességgel rendelkező GPU 6.0-s vagy újabb (például NVIDIA Tesla T4, A2, 1080Ti vagy 2080Ti) számítási eszközre van szükség. Javasoljuk, hogy gpu-gyorsítással használja az Azure Stack Edge-et , de a tároló bármely más asztali gépen fut, amely megfelel a minimális követelményeknek. Ezt az eszközt gazdaszámítógépként tekintjük.

Az Azure Stack Edge egy hardveres szolgáltatásként nyújtott megoldás, és egy hálózati adatátviteli képességekkel rendelkező, AI-kompatibilis peremhálózati számítástechnikai eszköz. Részletes előkészítési és beállítási utasításokért tekintse meg az Azure Stack Edge dokumentációját.

Követelmény Leírás
Kamera A Térinformatikai tároló nincs egy adott kameramárkához kötve. A kameraeszköznek támogatnia kell a valós idejű streamelési protokollt (RTSP) és a H.264 kódolást, elérhetőnek kell lennie a gazdaszámítógép számára, és képesnek kell lennie a streamelésre 15FPS és 1080p felbontásban.
Linux operációs rendszer Az Ubuntu Desktop 18.04 LTS-t telepíteni kell a gazdaszámítógépre.

A gazdaszámítógép beállítása

Javasoljuk, hogy azure Stack Edge-eszközt használjon a gazdaszámítógéphez. Válassza az Asztali gép lehetőséget, ha másik eszközt konfigurál, vagy virtuális gépet, ha virtuális gépet használ.

Számítás konfigurálása az Azure Stack Edge portálon

A térinformatikai elemzés az Azure Stack Edge számítási funkcióit használja egy AI-megoldás futtatásához. A számítási funkciók engedélyezéséhez győződjön meg arról, hogy:

  • Csatlakoztatta és aktiválta az Azure Stack Edge-eszközt.
  • Az eszköz eléréséhez PowerShell 5.0-s vagy újabb verzióját futtató Windows-ügyfélrendszerrel rendelkezik.
  • Kubernetes-fürt üzembe helyezéséhez konfigurálnia kell az Azure Stack Edge-eszközt az Azure Portal helyi felhasználói felületénkeresztül:
    1. Engedélyezze a számítási funkciót az Azure Stack Edge-eszközön. A számítás engedélyezéséhez nyissa meg az eszköz webes felületén található Számítási lapot.
    2. Válasszon ki egy hálózati adaptert, amelyet engedélyezni szeretne a számításhoz, majd válassza az Engedélyezés lehetőséget. Ez létrehoz egy virtuális kapcsolót az eszközön, az adott hálózati adapteren.
    3. Hagyja üresen a Kubernetes tesztcsomópont IP-címét és a Kubernetes külső szolgáltatások IP-címét.
    4. Válassza az Alkalmazás lehetőséget. Ez a művelet körülbelül két percet vehet igénybe.

Configure compute

Azure Stack Edge-szerepkör beállítása és IoT Hub-erőforrás létrehozása

Az Azure Portalon keresse meg az Azure Stack Edge-erőforrást. Az Áttekintés lapon vagy a navigációs listában válassza az Edge compute Get started (Első lépések) gombot. Az Edge-számítás konfigurálása csempén válassza a Konfigurálás lehetőséget.

Link

Az Edge-számítás konfigurálása lapon válasszon ki egy meglévő IoT Hubot, vagy hozzon létre egy újat. Alapértelmezés szerint egy standard (S1) tarifacsomagot használ egy IoT Hub-erőforrás létrehozásához. Ha ingyenes szintű IoT Hub-erőforrást szeretne használni, hozzon létre egyet, majd válassza ki. Az IoT Hub-erőforrás ugyanazt az előfizetést és erőforráscsoportot használja, amelyet az Azure Stack Edge-erőforrás használ

Válassza a Létrehozás lehetőséget. Az IoT Hub-erőforrás létrehozása eltarthat néhány percig. Az IoT Hub-erőforrás létrehozása után az Edge konfigurálása számítási csempe frissül az új konfiguráció megjelenítéséhez. Ha ellenőrizni szeretné, hogy az Edge számítási szerepkör konfigurálva lett-e, válassza a Konfiguráció megtekintése lehetőséget a Számítási csempe konfigurálása lapon.

Amikor az Edge számítási szerepkör be van állítva az Edge-eszközön, két eszközt hoz létre: egy IoT-eszközt és egy IoT Edge-eszközt. Mindkét eszköz megtekinthető az IoT Hub-erőforrásban. Az Azure IoT Edge-futtatókörnyezet már fut az IoT Edge-eszközön.

Feljegyzés

  • Jelenleg csak a Linux platform támogatott az IoT Edge-eszközökön. Ha segítségre van szüksége az Azure Stack Edge-eszköz hibaelhárításához, tekintse meg a naplózási és hibaelhárítási cikket.
  • Ha többet szeretne megtudni arról, hogyan konfigurálhat egy IoT Edge-eszközt proxykiszolgálón keresztüli kommunikációra, olvassa el az IoT Edge-eszköz konfigurálása proxykiszolgálón keresztüli kommunikációhoz című témakört .

MPS engedélyezése az Azure Stack Edge-en

Az alábbi lépéseket követve távolról csatlakozhat Windows-ügyfélről.

  1. Windows PowerShell-munkamenet futtatása rendszergazdaként.

  2. Győződjön meg arról, hogy a Windows távfelügyeleti szolgáltatás fut az ügyfélen. A parancssorba írja be a következőt:

    winrm quickconfig
    

    További információ: Telepítés és konfiguráció a Windows távfelügyelethez.

  3. Rendeljen hozzá egy változót a fájlban hosts használt kapcsolati sztring.

    $Name = "<Node serial number>.<DNS domain of the device>"
    

    Cserélje le és <DNS domain of the device> írja be <Node serial number> az eszköz csomópont sorozatszámát és DNS-tartományát. A csomópont sorozatszámának értékeit a Tanúsítványok lapról és a DNS-tartományból szerezheti be az eszköz helyi webes felhasználói felületén található Eszköz lapról.

  4. Ha hozzá szeretné adni ezt a kapcsolati sztring az eszközhöz az ügyfél megbízható gazdagépeinek listájához, írja be a következő parancsot:

    Set-Item WSMan:\localhost\Client\TrustedHosts $Name -Concatenate -Force
    
  5. Windows PowerShell-munkamenet indítása az eszközön:

    Enter-PSSession -ComputerName $Name -Credential ~\EdgeUser -ConfigurationName Minishell -UseSSL
    

    Ha a megbízhatósági kapcsolattal kapcsolatos hibát lát, ellenőrizze, hogy az eszközre feltöltött csomóponttanúsítvány aláírási lánca is telepítve van-e az eszközhöz hozzáférő ügyfélen.

  6. Adja meg a jelszót, amikor a rendszer kéri. Használja ugyanazt a jelszót, amelyet a helyi webes felhasználói felületre való bejelentkezéshez használ. A helyi webes felhasználói felület alapértelmezett jelszava a következő Password1: . Ha sikeresen csatlakozik az eszközhöz távoli PowerShell használatával, a következő mintakimenet jelenik meg:

    Windows PowerShell
    Copyright (C) Microsoft Corporation. All rights reserved.
    
    PS C:\WINDOWS\system32> winrm quickconfig
    WinRM service is already running on this machine.
    PS C:\WINDOWS\system32> $Name = "1HXQG13.wdshcsso.com"
    PS C:\WINDOWS\system32> Set-Item WSMan:\localhost\Client\TrustedHosts $Name -Concatenate -Force
    PS C:\WINDOWS\system32> Enter-PSSession -ComputerName $Name -Credential ~\EdgeUser -ConfigurationName Minishell -UseSSL
    
    WARNING: The Windows PowerShell interface of your device is intended to be used only for the initial network configuration. Please engage Microsoft Support if you need to access this interface to troubleshoot any potential issues you may be experiencing. Changes made through this interface without involving Microsoft Support could result in an unsupported configuration.
    [1HXQG13.wdshcsso.com]: PS>
    

IoT üzembe helyezési jegyzék

A tárolók több gazdagépen történő üzembe helyezésének egyszerűsítése érdekében létrehozhat egy üzembehelyezési jegyzékfájlt a tárolólétrehozás beállításainak és környezeti változóinak megadásához. Az Azure Stack Edge, más asztali gépek és a GitHubON GPU-val rendelkező Azure-beli virtuális gépek üzembe helyezési jegyzékére találhat példát.

Az alábbi táblázat az IoT Edge-modul által használt különböző környezeti változókat mutatja be. Ezeket a fent hivatkozott üzembehelyezési jegyzékben is beállíthatja a env következő spatialanalysisattribútummal:

A beállítás neve Érték Leírás
ARCHON_LOG_LEVEL Info; Részletes Naplózási szint, válasszon egyet a két érték közül
ARCHON_SHARED_BUFFER_LIMIT 377487360 Ne módosítsa
ARCHON_PERF_MARKER false Állítsa ezt igaz értékre a teljesítménynaplózáshoz, ellenkező esetben ennek hamisnak kell lennie
ARCHON_NODES_LOG_LEVEL Info; Részletes Naplózási szint, válasszon egyet a két érték közül
OMP_WAIT_POLICY PASSZÍV Ne módosítsa
QT_X11_NO_MITSHM 0 Ne módosítsa
APIKEY az API-kulcs Gyűjtse össze ezt az értéket az Azure Portalról a Vision-erőforrásból. Az erőforrás kulcs- és végpontszakaszában található.
SZÁMLÁZÁS a végpont URI-ja Gyűjtse össze ezt az értéket az Azure Portalról a Vision-erőforrásból. Az erőforrás kulcs- és végpontszakaszában található.
EULA elfogadás Ezt az értéket úgy kell beállítani, hogy elfogadja a tároló futtatását
MEGJELENÍTÉS 1: Ennek az értéknek meg kell egyeznie a gazdaszámítógép kimenetével echo $DISPLAY . Az Azure Stack Edge-eszközök nem rendelkeznek kijelzővel. Ez a beállítás nem alkalmazható
KEY_ENV A Standard kiadás titkosítási kulcs Adja hozzá ezt a környezeti változót, ha Video_URL egy elhomályosított sztring
IV_ENV Inicializálási vektor Adja hozzá ezt a környezeti változót, ha Video_URL egy elhomályosított sztring

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.

Miután saját beállításokkal és a műveletek kiválasztásával frissítette az Azure Stack Edge-eszközök, asztali gépek vagy Azure-beli virtuális gépek üzembehelyezési jegyzékét, az alábbi Azure CLI-paranccsal üzembe helyezheti a tárolót a gazdaszámítógépen, IoT Edge-modulként.

sudo az login
sudo az extension add --name azure-iot
sudo az iot edge set-modules --hub-name "<iothub-name>" --device-id "<device-name>" --content DeploymentManifest.json --subscription "<name or ID of Azure Subscription>"
Paraméter Leírás
--hub-name Az Azure IoT Hub neve.
--content Az üzembehelyezési fájl neve.
--target-condition A gazdaszámítógép IoT Edge-eszközneve.
-–subscription Előfizetés azonosítója vagy neve.

Ez a parancs elindítja az üzembe helyezést. Az Üzembe helyezés állapotának megtekintéséhez lépjen az Azure IoT Hub-példány lapjára az Azure Portalon. Az állapot 417-ként jelenhet meg – Az eszköz üzembehelyezési konfigurációja nincs beállítva , amíg az eszköz le nem tölti a tárolólemezképeket, és nem indul el a futás.

Az üzembe helyezés sikerességének ellenőrzése

A tároló futásának ellenőrzésére többféleképpen is van lehetőség. Keresse meg a futtatókörnyezet állapotát az Azure PortalOn található Azure IoT Hub-példány térinformatikai moduljának IoT Edge-moduljának Gépház. Ellenőrizze, hogy a futásidejű állapot kívánt értéke és jelentett értéke fut-e.

Example deployment verification

Miután az üzembe helyezés befejeződött, és a tároló fut, a gazdaszámítógép elkezd eseményeket küldeni az Azure IoT Hubba. Ha a .debug műveletek verzióját használta, megjelenik egy vizualizációs ablak az üzembe helyezési jegyzékben konfigurált összes kamerához. Most már meghatározhatja a figyelni kívánt vonalakat és zónákat az üzembe helyezési jegyzékben, és az utasításokat követve újra üzembe helyezheti.

A térinformatikai elemzés által végrehajtott műveletek konfigurálása

Térinformatikai műveletek használatával konfigurálnia kell a tárolót csatlakoztatott kamerák használatára, a műveletek konfigurálására stb. Minden konfigurált kameraeszköz esetében a térinformatikai műveletek JSON-üzenetek kimeneti adatfolyamát generálják, amelyeket az Azure IoT Hub-példánynak küldenek.

A tároló által létrehozott kimenet használata

Ha a tároló által létrehozott kimenetet szeretné használni, tekintse meg az alábbi cikkeket:

  • A választott programozási nyelvhez tartozó Azure Event Hubs SDK használatával csatlakozzon az Azure IoT Hub végpontjához, és fogadja az eseményeket. További információ: Eszközről felhőbe irányuló üzenetek olvasása a beépített végpontról.
  • Állítsa be az Üzenet-útválasztást az Azure IoT Hubon, hogy az eseményeket más végpontokra küldje, vagy mentse az eseményeket az Azure Blob Storage-ba stb.

Hibaelhárítás

Ha problémákba ütközik a tároló indításakor vagy futtatásakor, tekintse meg a telemetriát és a hibaelhárítást a gyakori problémák megoldásához. Ez a cikk a naplók létrehozásával és gyűjtésével, valamint a rendszerállapot gyűjtésével kapcsolatos információkat is tartalmaz.

Ha problémákat tapasztal egy Azure AI-szolgáltatástároló futtatásával, próbálja meg használni a Microsoft diagnosztikai tárolóját. Ezzel a tárolóval diagnosztizálhatja az üzembehelyezési környezetben előforduló gyakori hibákat, amelyek megakadályozhatják, hogy az Azure AI-tárolók a várt módon működjenek.

A tároló lekéréséhez használja a következő docker pull parancsot:

docker pull mcr.microsoft.com/azure-cognitive-services/diagnostic

Ezután futtassa a tárolót. Cserélje le {ENDPOINT_URI} a végpontot, és cserélje le {API_KEY} az erőforrás kulcsára:

docker run --rm mcr.microsoft.com/azure-cognitive-services/diagnostic \
eula=accept \
Billing={ENDPOINT_URI} \
ApiKey={API_KEY}

A tároló teszteli a számlázási végponthoz való hálózati kapcsolatot.

Számlázás

A térinformatikai tároló számlázási adatokat küld az Azure-nak egy Vision-erőforrás használatával az Azure-fiókjában. A térinformatikai elemzés nyilvános előzetes verzióban való használata jelenleg ingyenes.

Az Azure AI-tárolók nincsenek licencelve a mérés/számlázás végpontjához való csatlakozás nélkül történő futtatásra. Mindig engedélyeznie kell a tárolóknak, hogy a számlázási adatokat a számlázási végponttal közöljék. Az Azure AI-tárolók nem küldenek ügyféladatokat, például az elemezni kívánt videót vagy képet a Microsoftnak.

Összegzés

Ebben a cikkben megismerkedett a térinformatikai tároló letöltésével, telepítésével és futtatásával kapcsolatos fogalmakkal és munkafolyamatokkal. Összegezve:

  • A térbeli elemzés a Docker Linux-tárolója.
  • A tárolólemezképek a Microsoft Container Registryből töltődnek le.
  • A tárolólemezképek IoT-modulokként futnak az Azure IoT Edge-ben.
  • Konfigurálja a tárolót, és helyezze üzembe egy gazdagépen.

Következő lépések