Foglalási szabályzatok használata az eszközök IoT Hubokon való kiépítéséhez
Az Azure IoT Hub Device Provisioning Service (DPS) számos beépített foglalási szabályzatot támogat, amelyek meghatározzák, hogyan rendeli hozzá az eszközöket egy vagy több IoT Hubhoz. A DPS támogatja az egyéni foglalási szabályzatokat is, amelyek lehetővé teszik saját foglalási szabályzatok létrehozását és használatát, ha az IoT-forgatókönyv nem a beépített szabályzatok által biztosított funkciókat igényel.
Ez a cikk segít megérteni a DPS-foglalási szabályzatok használatát és kezelését.
A foglalási szabályzatok ismertetése
A foglalási szabályzatok határozzák meg, hogy a DPS hogyan rendel eszközöket egy IoT Hubhoz. Minden DPS-példány rendelkezik egy alapértelmezett foglalási szabályzattal, de ezt a szabályzatot felül lehet bírálni egy regisztrációhoz beállított foglalási szabályzattal. Csak a DPS-példányhoz csatolt IoT Hubok vehetnek részt a foglalásban. Az, hogy egy csatolt IoT Hub részt vesz-e a foglalásban, az eszköz által biztosított regisztráció beállításaitól függ.
A DPS négy foglalási szabályzatot támogat:
Egyenletesen súlyozott eloszlás: az eszközök súlyozott kivonat használatával vannak kiépítve egy IoT Hubra. A csatolt IoT Hubok alapértelmezés szerint ugyanazzal a foglalási súlybeállítással rendelkeznek, így ugyanolyan valószínű, hogy az eszközök ki vannak építve hozzájuk. Az IoT Hub foglalási súlyát a hozzárendelés valószínűségének növelése vagy csökkentése érdekében lehet módosítani. A DPS-példányok alapértelmezett foglalási szabályzata az egyenletesen súlyozott elosztás . Ha csak egy IoT Hubra épít ki eszközöket, javasoljuk, hogy használja ezt a szabályzatot.
Legalacsonyabb késés: az eszközök ki vannak építve az IoT Hubra, és az eszköz a legkisebb késéssel rendelkezik. Ha több IoT Hub biztosítja a legalacsonyabb késést, a DPS a konfigurált foglalási súlyuk alapján kivonatot ad az eszközökről ezeken a központokon.
Statikus konfiguráció: az eszközök egyetlen IoT Hubra vannak kiépítve, amelyet meg kell adni a regisztráció során.
Egyéni (Azure-függvény használata):: Az egyéni foglalási szabályzatok nagyobb mértékben szabályozják az eszközök IoT Hubhoz való hozzárendelését. Ez az Azure Functionsben üzemeltetett egyéni webhookok használatával történik az eszközök IoT Hubhoz való hozzárendeléséhez. A DPS meghívja a webhookot, és minden releváns információt megad az eszközről és a regisztrációról. A webhook visszaadja az eszköz kiépítéséhez használt IoT Hubot és kezdeti ikereszközt (nem kötelező). Az egyéni hasznos adatok az eszközre és az eszközről is továbbíthatók. További információ: Az egyéni foglalási szabályzatok ismertetése. A DPS-példány alapértelmezett házirendje nem állítható be.
Megjegyzés:
Az előző lista az Azure Portalon megjelenő foglalási szabályzatok nevét jeleníti meg. Ha a kiosztási szabályzatot a DPS REST API, az Azure CLI és a DPS szolgáltatás SDK-jával állítja be, a következőkre hivatkozunk: kivonatolt, geolatency, statikus és egyéni.
A csatolt IoT Hubon két beállítás van, amelyek szabályozzák, hogyan vesz részt a foglalásban:
Foglalási súly: meghatározza, hogy az IoT Hub milyen súlyt kap, amikor több IoT Hubot tartalmazó foglalási szabályzatokban vesz részt. Ez egy és 1000 közötti érték lehet. Az alapértelmezett érték egy (vagy null).
Az egyenletesen súlyozott elosztási szabályzattal a magasabb foglalási súlyértékekkel rendelkező IoT Hubok nagyobb valószínűséggel vannak kiválasztva az alacsonyabb súlyértékekkel rendelkezőkhöz képest.
A legalacsonyabb késési foglalási szabályzat esetén a foglalási súly értéke befolyásolja az IoT Hub kiválasztásának valószínűségét, ha egynél több IoT Hub teljesíti a legalacsonyabb késési követelményt.
Egyéni foglalási szabályzat esetén a kiosztás súlyértékének használata a webhook logikájától függ.
Foglalási szabályzat alkalmazása: meghatározza, hogy az IoT Hub részt vesz-e a foglalási szabályzatban. Az alapértelmezett érték az Igen (igaz). Ha nem (hamis) értékre van állítva, az eszközök nem lesznek hozzárendelve az IoT Hubhoz. Az IoT Hub továbbra is kiválasztható egy regisztráción, de nem vesz részt a kiosztásban. Ezzel a beállítással ideiglenesen vagy véglegesen eltávolíthat egy IoT Hubot a foglalásban való részvételből; Például ha az eszköz megközelíti az engedélyezett számú eszközt.
Az IoT Hubok DPS-példányban való összekapcsolásáról és kezeléséről további információt az IoT Hubok csatolása és kezelése című témakörben talál.
Ha egy eszköz a DPS-ben működik, a szolgáltatás az alábbi irányelveknek megfelelően rendeli hozzá egy IoT Hubhoz:
Ha a regisztráció kiosztási szabályzatot ad meg, használja ezt a szabályzatot; ellenkező esetben használja a DPS-példány alapértelmezett foglalási szabályzatát.
Ha a regisztráció egy vagy több IoT Hubot határoz meg, alkalmazza a foglalási szabályzatot ezeken az IoT Hubokon; ellenkező esetben alkalmazza a kiosztási szabályzatot a DPS-példányhoz társított összes IoT Hubra. Vegye figyelembe, hogy ha a foglalási szabályzat statikus konfiguráció, a regisztrációnak IoT Hubot kell megadnia.
Fontos
Ha módosít egy foglalási szabályzatot vagy a vonatkozó IoT Hubokat, a módosítások csak a későbbi eszközregisztrációkat érintik. Az IoT Hubon már kiépített eszközökre nem lesz hatással. Ha azt szeretné, hogy a módosítások visszamenőlegesen vonatkozzanak ezekre az eszközökre, újra kell őket készítenie. További információ: Eszközök újraépítése.
A DPS-példány alapértelmezett foglalási szabályzatának beállítása
A DPS-példány alapértelmezett foglalási szabályzata akkor használatos, ha nincs megadva foglalási szabályzat egy regisztráción. Az alapértelmezett foglalási szabályzat csak az egyenletesen súlyozott elosztást, a legalacsonyabb késést és a statikus konfigurációt támogatja. Az egyéni foglalás nem támogatott. DPS-példány létrehozásakor az alapértelmezett szabályzat automatikusan egyenletesen súlyozott eloszlásra van állítva.
Megjegyzés:
Ha a statikus konfigurációt állítja be egy DPS-példány alapértelmezett foglalási szabályzataként, egy csatolt IoT Hubot kell megadni az alapértelmezett házirendre támaszkodó regisztrációkban.
Az Azure Portal használata az alapértelmezett foglalási szabályzat beállításához
A DPS-példány alapértelmezett foglalási szabályzatának beállítása az Azure Portalon:
A DPS-példány bal oldali menüjében válassza a Foglalási szabályzat kezelése lehetőséget.
Válassza ki a beállítani kívánt foglalási szabályzat gombját: Legalacsonyabb késés, Egyenletesen súlyozott eloszlás vagy Statikus konfiguráció. (Az alapértelmezett foglalási szabályzat nem támogatja az egyéni foglalást.)
Válassza a Mentés parancsot.
Az alapértelmezett foglalási szabályzat beállítása az Azure CLI használatával
Az az iot dps update Azure CLI-paranccsal állítsa be a DPS-példány alapértelmezett foglalási szabályzatát. A szabályzat megadására használható --set properties.allocationPolicy . Az alábbi parancs például egyenletesen súlyozott eloszlásra állítja a foglalási szabályzatot (az alapértelmezett):
az iot dps update --name MyExampleDps --set properties.allocationPolicy=hashed
A DPS támogatja az alapértelmezett foglalási szabályzat beállítását a DPS-erőforrás REST API-jának, a Resource Manager-sablonoknak és a DPS Management SDK-knak a használatával.
Foglalási szabályzat és IoT Hubok beállítása a regisztrációkhoz
Az egyes regisztrációk és regisztrációs csoportok megadhatnak egy foglalási szabályzatot és a csatolt IoT Hubokat, amelyekre alkalmaznia kell. Ha a regisztráció nem ad meg foglalási szabályzatot, akkor a RENDSZER a DPS-példány alapértelmezett foglalási szabályzatát használja.
Mindkét esetben a következő feltételek érvényesek:
Egyenletesen súlyozott terjesztési, legalacsonyabb késési és egyéni foglalási szabályzatok esetén a regisztráció meghatározhatja, hogy mely csatolt IoT Hubokat kell használni. Ha a regisztrációban nincs kiválasztva IoT Hub, akkor a DPS-példány összes csatolt IoT Hubja használatban lesz.
Statikus konfiguráció esetén a regisztrációnak egyetlen IoT Hubot kell megadnia a csatolt IoT Hubok listájából.
Az egyéni regisztrációkhoz és a regisztrációs csoportokhoz is megadhatja a foglalási szabályzatot és a csatolt IoT Hubokat, hogy alkalmazva legyen a regisztráció létrehozásakor vagy frissítésekor.
A regisztrációs foglalási szabályzat és az IoT Hubok kezelése az Azure Portal használatával
A foglalási szabályzat beállításához és az IoT Hubok kiválasztásához egy regisztrációhoz az Azure Portalon:
A DPS-példány bal oldali menüjében válassza a Regisztrációk kezelése lehetőséget.
A Regisztrációk kezelése lapon:
Új regisztráció létrehozásához válassza a Regisztrációs csoportok vagy az Egyéni regisztrációk lapot, majd válassza a Regisztrációs csoport hozzáadása vagy az Egyéni regisztráció hozzáadása lehetőséget.
Meglévő regisztráció frissítéséhez válassza ki a regisztrációs csoportok vagy az Egyéni regisztrációk lap listájából.
A Regisztráció hozzáadása lapon (a létrehozásnál) vagy a Regisztráció részletei lapon (a frissítés során) válassza az IoT Hubs lapot. Ezen a lapon kiválaszthatja a regisztrációra alkalmazni kívánt foglalási szabályzatot, és kiválaszthatja a használni kívánt IoT Hubokat:
Válassza ki azokat az IoT Hubokat, amelyekhez az eszközök hozzárendelhetők a legördülő listából. Ha kiválasztja a statikus konfigurációs foglalási szabályzatot, akkor egyetlen csatolt IoT Hub kiválasztására lesz korlátozva. Az összes többi foglalási szabályzat esetében alapértelmezés szerint az összes csatolt IoT Hub ki lesz választva, de ezt a kijelölést a legördülő menüvel módosíthatja. Ha azt szeretné, hogy a regisztráció automatikusan társított IoT Hubokat használjon a DPS-példányhoz való hozzáadásukkor (vagy abból törölve), törölje az összes IoT Hub kijelölését.
Ha szeretné, az Új IoT Hub csatolása gombot választva csatolhat egy új IoT Hubot a DPS-példányhoz, és elérhetővé teheti a kijelölhető IoT Hubok listájában. Az IoT Hub csatolásáról további információt az IoT Hub csatolása című témakörben talál.
Válassza ki a regisztrációra alkalmazni kívánt foglalási szabályzatot. Alapértelmezés szerint a DPS-példány alapértelmezett foglalási szabályzata van kiválasztva. Egyéni kiosztáshoz egyéni foglalási szabályzat webhookot is meg kell adnia az Azure Functionsben. További részletekért tekintse meg az Egyéni foglalási szabályzatok használata oktatóanyagot.
Állítsa be a regisztrációhoz szükséges egyéb tulajdonságokat, majd mentse a beállításokat.
A regisztrációs foglalási szabályzat és az IoT Hubok kezelése az Azure CLI használatával
Az az iot dps enrollment create, az iot dps enrollment update, az iot dps enrollment-group create, az iot dps enrollment-group update Azure CLI-parancsokkal hozhat létre vagy frissíthet egyéni regisztrációs vagy regisztrációs csoportokat.
A következő parancs például létrehoz egy szimmetrikus kulcsregisztrációs csoportot, amely alapértelmezés szerint a DPS-példányon beállított alapértelmezett foglalási szabályzatot és a DPS-példányhoz társított összes IoT Hubot használja:
az iot dps enrollment-group create --dps-name MyExampleDps --enrollment-id MyEnrollmentGroup
Az alábbi parancs frissíti ugyanazt a regisztrációs csoportot, hogy a legalacsonyabb késésű foglalási szabályzatot használja a MyExampleHub és a MyExampleHub-2 nevű IoT Hubokkal:
az iot dps enrollment-group update --dps-name MyExampleDps --enrollment-id MyEnrollmentGroup --allocation-policy geolatency --iot-hubs "MyExampleHub.azure-devices.net MyExampleHub-2.azure-devices.net"
A DPS emellett támogatja a foglalási szabályzat beállítását és a regisztrációhoz kiválasztott IoT Hubokat az egyéni regisztráció létrehozása vagy frissítése, valamint a REST API-k létrehozása vagy frissítése, valamint a DPS szolgáltatás SDK-k használatával.
Foglalási viselkedés
Figyelje meg a következő viselkedést, amikor foglalási szabályzatokat használ az IoT Hubbal:
Az Azure CLI, a REST API és a DPS szolgáltatás SDK-kkal foglalási szabályzat nélkül hozhat létre regisztrációkat. Ebben az esetben a DPS az alapértelmezett szabályzatot használja a DPS-példányhoz, amikor egy eszköz a regisztráción keresztül ki van kapcsolva. A DPS-példány alapértelmezett házirendbeállításának módosítása megváltoztatja az eszközök üzembe helyezésének módját a regisztráción keresztül.
Az Azure Portalon a regisztráció foglalási szabályzatának beállítása előre fel van töltve az alapértelmezett foglalási szabályzattal. Ezt a beállítást megtarthatja vagy másik szabályzatra módosíthatja, de a regisztráció mentésekor a foglalási szabályzat be van állítva a regisztrációban. A szolgáltatás alapértelmezett foglalási szabályzatának későbbi módosításai nem módosítják az eszközök üzembe helyezését a regisztráción keresztül.
Az egyenlően súlyozott terjesztési, legalacsonyabb késési és egyéni foglalási szabályzatok esetében konfigurálhatja a regisztrációt a DPS-példányhoz társított összes IoT Hub használatára:
Az Azure CLI és a DPS szolgáltatás SDK-jaival IoT Hubok megadása nélkül hozhatja létre a regisztrációt.
Az Azure Portalon a regisztráció előre fel van töltve a kiválasztott DPS-példányhoz társított összes IoT Hubmal; a regisztráció mentése előtt törölje az összes IoT Hub kijelölését.
Ha nincs kiválasztva IoT Hub a regisztráció során, akkor amikor egy új IoT Hub kapcsolódik a DPS-példányhoz, részt vesz a kiosztásban; és fordítva a DPS-példányból eltávolított IoT Hub esetében.
Ha az IoT Hubok egy regisztrációban vannak megadva, a regisztráció IoT Hubs-beállítását manuálisan vagy programozott módon kell frissíteni az újonnan csatolt IoT Hub hozzáadásához, vagy egy törölt IoT Hub hozzáadásához, hogy el lehessen távolítani a foglalásból.
A regisztrációhoz használt foglalási szabályzat vagy IoT Hubok módosítása csak az adott regisztráción keresztüli későbbi regisztrációkat érinti. Ha azt szeretné, hogy a módosítások hatással legyen a korábbi regisztrációkra, minden korábban regisztrált eszközt újra kell létrehoznia.
Korlátozások
A foglalási szabályzatok és a privát végpontok használatakor bizonyos korlátozások vonatkoznak. További információ: Privát végpont korlátozásai.
Következő lépések
A csatolt IoT Hubok összekapcsolásáról és kezeléséről további információt a csatolt IoT Hubok kezelése című témakörben talál.
Az egyéni foglalási szabályzatokról további információt az egyéni foglalási szabályzatok ismertetése című témakörben talál.
A legalacsonyabb késési kiosztási szabályzatot használó végpontok közötti példaért tekintse meg a geolatencia-kiosztási oktatóanyagot.
Ha egy egyéni foglalási szabályzatot használó, végpontok közötti példát szeretne látni, tekintse meg az Egyéni foglalási szabályzatok használata oktatóanyagot.