Az elosztási szabályok használata eszközök IoT-csomópontokon való telepí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.

Az elosztási szabályzatok megérté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 a regisztrációhoz beállított foglalási szabályzat felülírhatja az alapértelmezett foglalási szabályzatot. Csak a DPS-példányhoz csatolt IoT Hubok vehetnek részt a kiosztá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 kivonattal kerülnek telepítésre az IoT hubra. Alapértelmezés szerint a csatolt IoT hubok ugyanazzal a foglalási súlybeállítással rendelkeznek, így ugyanolyan valószínű, hogy eszközök lesznek hozzájuk rendelve. Az IoT Hub foglalási súlya módosítható a hozzárendelés valószínűségének növelése vagy csökkentése érdekében. 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ésleltetést, a DPS az eszközöket ezek között a központok között allokációs súlyuk alapján szórja szét.

  • 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 egyéni kiosztás az Azure Functionsben üzemeltetett egyéni webhook 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 testreszabott hasznos adatok az eszközre és az eszközről is továbbíthatók. További információ: Egyéni foglalási szabályzatok megismerése az Azure IoT Hub Device Provisioning Service szolgáltatással. A DPS-példány alapértelmezett házirendjeként nem lehet beállítani.

Feljegyzés

Az előző lista az Azure Portalon megjelenő foglalási szabályzatok nevét jeleníti meg. Amikor 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 tartalmaz, 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 több IoT Hub is megfelel a legalacsonyabb késési követelménynek.

    • 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 nincsenek 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.

Ha többet szeretne megtudni az IoT Hubok DPS-példányban való összekapcsolásáról és kezeléséről, olvassa el az IoT Hubok csatolása és kezelése című témakört.

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. Ha a foglalási szabályzat statikus konfiguráció, a regisztrációnak meg kell adnia egy IoT Hubot.

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 hubhoz már korábban kiépített eszközökre nincs hatás. Ha azt szeretné, hogy a módosítások visszamenőlegesen vonatkozzanak ezekre az eszközökre, akkor újra kell létrehoznia őket. További információért olvassa el: Eszközök újrakonfigurálása.

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 kiosztá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.

Feljegyzé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:

  1. DPS-példány bal oldali menüjében válassza a Foglalási szabályzat kezelése.

  2. 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.)

  3. Válassza a Mentés lehetőséget.

Az alapértelmezett foglalási szabályzat beállítása az Azure CLI használatával

Az iot dps update Azure CLI-paranccsal állítsa be a DPS-példány alapértelmezett hozzárendelési szabályzatát. A szabályzat megadására használható --set properties.allocationPolicy . Az alábbi parancs például az egyenletesen súlyozott eloszlásra (alapértelmezett) állítja a foglalási szabályzatot:

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, Resource Manager-sablonok és a DPS Management SDK-k használatával.

Foglalási szabályzat és IoT Hubok beállítása a regisztrációkhoz

Az egyéni regisztrációk és regisztrációs csoportok megadhatnak egy allokációs irányelvet és a csatolt IoT Hubokat, amelyekre alkalmazni kell. Ha a regisztráció nem ad meg allokációs irányelvet, akkor a DPS-példány alapértelmezett allokációs irányelve lesz használva.

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ó megadhatja, hogy mely csatolt IoT Hubokat kell használni. Ha nincsenek kiválasztva az IoT Hubok a regisztráció során, akkor a DPS-példány összes csatolt IoT Hubját használják.

  • 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 hozzárendelési szabályzat beállításához és az IoT Hubok kiválasztásához egy regisztráció során az Azure portálon:

  1. A DPS-példány bal oldali menüjében válassza a Regisztrációk kezelése lehetőséget.

  2. 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.

  3. 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:

    Képernyőkép a foglalási szabályzatról és a kiválasztott központbeállításokról az IoT Hubs lapon.

    1. Válassza ki azokat az IoT Hubokat, amelyekhez az eszközök hozzárendelhetők a legördülő listából. Ha a statikus konfigurációfoglalási szabályzatot választja, csak egyetlen csatolt IoT Hubot választhat. Az összes többi foglalási szabályzat esetében alapértelmezés szerint az összes csatolt IoT Hub ki van jelölve, de ezt a kijelölést a legördülő menüvel módosíthatja. Ha azt szeretné, hogy a regisztráció automatikusan a társított IoT Hub-okat használja, ahogy azokat hozzáadják a DPS-példányhoz vagy abból törlik, törölje az összes IoT Hub kijelölését.

    2. 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ával kapcsolatos részletekért lásd : Csatolt IoT Hub hozzáadása.

    3. 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 információért tekintse meg az Oktatóanyagot: Egyéni hozzárendelési szabályzatok használata a Device Provisioning Service (DPS) szolgáltatásnál.

  4. Á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 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ókat 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 legkisebb késleltetésű elosztási szabályzatot használja az MyExampleHub és 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 regisztrálás során az allokációs szabályzat és a kiválasztott IoT Hubok beállítását az egyéni regisztráció létrehozása vagy frissítése és az regisztrációs csoport létrehozása vagy frissítése REST API-k, valamint a DPS szolgáltatás SDK-k használatával.

Allokációs 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 irányelvet használja a DPS-példányhoz, amikor egy eszköz a regisztráció során aktiválódik. A DPS példány alapértelmezett házirendjének módosítása megváltoztatja az eszközök regisztrációval történő telepítésének módját.

  • Az Azure portálon a regisztráció allokációs szabályzatának beállítása fel van töltve az alapértelmezett allokációs 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 meg vannak adva egy regisztrációban, a regisztráció IoT Hub-beállításait manuálisan vagy programozott módon kell frissíteni, hogy az újonnan csatolt IoT hub hozzáadható, illetve egy törölt IoT hub eltávolítható legyen a kiosztá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, újra kell létrehoznia az összes korábban regisztrált eszközt.

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

  • Last updated on