A Spatial Analysis-tároló telepítése és futtatása (előzetes verzió)
A Térbeli elemzés tároló lehetővé teszi a valós idejű streamelési videók 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 kiválóan alkalmasak adott biztonsági és adatszabályozási követelményekhez.
Előfeltételek
- Azure-előfizetés – Ingyenes létrehozás
- Az Azure-fióknak rendelkeznie kell egy
Cognitive Services Contributor
hozzárendelt 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. - Az Azure-előfizetés létrehozása után a Standard S1 szinthez a Azure Portal a kulcs és a végpont lekéréséhez. Az üzembe helyezés után válassza az Erőforrás megnyitása lehetőséget.
- A Spatial Analysis-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.
A térinformatikai elemzés tárolókövetelményei
A térinformatikai elemzési 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 fogjuk használni.
Az Azure Stack Edge egy szolgáltatásként nyújtott hardveres megoldás és egy AI-kompatibilis peremhálózati számítástechnikai eszköz, amely hálózati adatátviteli képességekkel rendelkezik. 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 Spatial Analysis tároló nincs egy adott kameramárkához kötve. A kameraeszköznek támogatnia kell a Real-Time Streaming Protocol (RTSP) és a H.264 kódolást, elérhetővé kell tennie 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 egy Azure Stack Edge-eszközt használjon a gazdagé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 spatial Analysis 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ót futtató Windows-ügyfélrendszerrel rendelkezik.
- Kubernetes-fürt üzembe helyezéséhez konfigurálnia kell az Azure Stack Edge-eszközt a helyi felhasználói felületen keresztül a Azure Portal:
- 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 lépjen az eszköz webes felületének Számítás lapjára.
- 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. Ezzel létrehoz egy virtuális kapcsolót az eszközön a hálózati adapteren.
- Hagyja üresen a Kubernetes tesztcsomópont IP-címeit és a Kubernetes külső szolgáltatások IP-címeit.
- Kattintson az Alkalmaz gombra. Ez a művelet körülbelül két percet vehet igénybe.
Azure Stack Edge-szerepkör beállítása és IoT Hub-erőforrás létrehozása
A Azure Portal 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 – 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.
Az Edge-számítás konfigurálása lapon válasszon ki egy meglévő IoT Hub, vagy hozzon létre egy újat. Alapértelmezés szerint egy standard (S1) tarifacsomagot használunk 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. A 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. A IoT Hub erőforrás létrehozása eltarthat néhány percig. A IoT Hub erőforrás létrehozása után az Edge számítási konfigurálása csempe frissül, hogy megjelenjen az új konfiguráció. Annak ellenőrzéséhez, hogy az Edge számítási szerepkör konfigurálva van-e, válassza a Konfiguráció megtekintése lehetőséget a Számítás konfigurálása csempén.
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 Runtime már fut az IoT Edge eszközön.
Megjegyzés
- Jelenleg csak a Linux platform támogatott IoT Edge eszközökön. Az Azure Stack Edge-eszköz hibaelhárításával kapcsolatos segítségért tekintse meg a naplózással és hibaelhárítással foglalkozó cikket.
- Ha többet szeretne megtudni arról, hogyan konfigurálhat IoT Edge eszközt proxykiszolgálón keresztüli kommunikációra, tekintse meg az IoT Edge eszköz proxykiszolgálón keresztüli kommunikációra való konfigurálását ismertető cikket.
MPS engedélyezése az Azure Stack Edge-ben
Az alábbi lépéseket követve távolról csatlakozhat windowsos ügyfélről.
Futtasson egy Windows PowerShell-munkamenetet rendszergazdaként.
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álás a Windows távfelügyelethez.
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
<Node serial number>
a és<DNS domain of the device>
a elemet az eszköz csomópont-sorozatszámára és DNS-tartományára. 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.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
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ó lánca is telepítve van-e az eszközhöz hozzáférő ügyfélre.
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 Jelszó1. Ha sikeresen csatlakozik az eszközhöz távoli PowerShell-lel, 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-üzembehelyezési jegyzék
A tárolók több gazdagépen való ü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. A GitHubon talál egy példát az Azure Stack Edge, más asztali gépek és GPU-val rendelkező Azure-beli virtuális gépek üzembehelyezési jegyzékére.
Az alábbi táblázat a IoT Edge modul által használt különböző környezeti változókat mutatja be. Ezeket a fent hivatkozott üzembehelyezési jegyzékfájlban is beállíthatja a env
következő spatialanalysis
attribútummal:
Beállítás neve | Érték | Leírás |
---|---|---|
ARCHON_LOG_LEVEL | Info; Részletes | Naplózási szint, válassza ki a két érték egyikét |
ARCHON_SHARED_BUFFER_LIMIT | 377487360 | Ne módosítsa |
ARCHON_PERF_MARKER | hamis | Állítsa ezt true é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álassza ki a két érték egyikét |
OMP_WAIT_POLICY | PASSZÍV | Ne módosítsa |
QT_X11_NO_MITSHM | 1 | Ne módosítsa |
APIKEY | az API-kulcs | Gyűjtse össze ezt az értéket Azure Portal a Vision-erőforrásból. Ezt az erőforrás Kulcs és végpont szakaszában találja. |
SZÁMLÁZÁS | a végpont URI-ja | Gyűjtse össze ezt az értéket Azure Portal a Vision-erőforrásból. Ezt az erőforrás Kulcs és végpont szakaszában találja. |
EULA | Elfogadja | Ezt az értéket úgy kell beállítani, hogy fogadja el a tároló futtatását |
KIJELZŐ | :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 | ASE titkosítási kulcs | Adja hozzá ezt a környezeti változót, ha Video_URL egy rejtjelezett sztring |
IV_ENV | Inicializálási vektor | Adja hozzá ezt a környezeti változót, ha Video_URL egy rejtjelezett sztring |
Fontos
A Eula
tároló futtatásához meg kell adni a , Billing
a és ApiKey
a beállítást, ellenkező esetben a tároló nem indul el. További információ: Számlázás.
Miután frissítette az Azure Stack Edge-eszközök, asztali gépek vagy GPU-val rendelkező Azure-beli virtuális gépek üzembehelyezési jegyzékfájlját a saját beállításaival és a műveletek kiválasztásával, az alábbi Azure CLI-paranccsal helyezheti üzembe 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 |
A 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. Lépjen a Azure IoT Hub példány lapjára a Azure Portal az üzembe helyezés állapotának megtekintéséhez. 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 el nem indul 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 lehetőség van. Keresse meg a futtatókörnyezet állapotát a Azure Portal Azure IoT Hub példányának Térbeli elemzés moduljának IoT Edge modulbeállításaiban. Ellenőrizze, hogy a Futtatókörnyezet állapotakívánt értéke és Jelentett értékeFut-e.
Miután az üzembe helyezés befejeződött, és a tároló fut, a gazdaszámítógép megkezdi az események küldését a Azure IoT Hub. Ha a .debug
műveletek verzióját használta, megjelenik egy vizualizációs ablak az üzembehelyezési jegyzékben konfigurált összes kamerához. Most már meghatározhatja a figyelni kívánt vonalakat és zónákat az üzembehelyezési jegyzékben, és kövesse az utasításokat az újbóli üzembe helyezéshez.
A térbeli elemzés által végrehajtott műveletek konfigurálása
A tároló konfigurálásához térbeli elemzési műveleteket kell használnia a csatlakoztatott kamerák használatára, a műveletek konfigurálására és egyebekre. A térinformatikai elemzés műveletei minden konfigurált kameraeszközhöz létrehoznak egy JSON-üzenetek kimeneti adatfolyamát, amelyet a Azure IoT Hub példányának küldenek.
A tároló által létrehozott kimenet használata
Ha el szeretné kezdeni használni a tároló által létrehozott kimenetet, tekintse meg a következő cikkeket:
- A választott programozási nyelvhez tartozó Azure Event Hubs SDK-val csatlakozzon a Azure IoT Hub végponthoz, é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 üzenetirányítást a Azure IoT Hub, hogy az eseményeket más végpontokra küldje, vagy mentse az eseményeket Azure Blob Storage stb. További információt az IoT Hub Üzenetirányítás című témakörben talál.
Hibaelhárítás
Ha problémákba ütközik a tároló indításakor vagy futtatásakor, a gyakori problémák megoldásához tekintse meg a telemetriai és hibaelhárítási lépéseket. 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ába ütközik egy Azure AI-szolgáltatások tárolójának futtatásakor, 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 elemet a végpontra, és cserélje le a elemet {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 Spatial Analysis-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érbeli elemzés nyilvános előzetes verzióban való használata jelenleg ingyenes.
Az Azure AI-tárolók nem futtathatók anélkül, hogy a mérési/számlázási végponthoz csatlakozna. Mindig engedélyeznie kell a tárolók számára, 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.
Összefoglalás
Ebben a cikkben megismerkedett a Spatial Analysis-tároló letöltésével, telepítésével és futtatásával kapcsolatos fogalmakkal és munkafolyamatokkal. Összegezve:
- A Spatial Analysis egy Linux-tároló a Dockerhez.
- A tárolórendszerképek a Microsoft Container Registryből töltődnek le.
- A tárolórendszerképek IoT-modulként futnak az Azure IoT Edge.
- Konfigurálja a tárolót, és helyezze üzembe egy gazdagépen.