Eszközök migrálása az Azure IoT Hubba

Ha úgy dönt, hogy IoT Central-alapú megoldásról IoT Hub-alapú megoldásra migrál, módosítania kell az alkalmazáshoz jelenleg csatlakoztatott összes eszköz konfigurációját. Az IoTC Migration eszköz automatizálja ezt az eszközmigrálási folyamatot.

A vándorló eszköz:

• Eszközregisztrációkat hoz létre az IoT Hubon az IoT Central-alkalmazáshoz jelenleg csatlakozó eszközökhöz.
• Egy paranccsal elküldi az IoT Hubhoz társított Device Provisioning Service (DPS) példány azonosító hatókörét az eszközeinek.

Az eszköz megköveteli, hogy a csatlakoztatott eszközök implementáljanak egy DeviceMove-parancsot , amely az IoT Central-alkalmazás eszközsablonjában van definiálva. A parancs hasznos adattartalma a cél DPS-példány azonosító hatóköre. Amikor egy eszköz megkapja ezt a parancsot, a következőnek kell lennie:

• Hagyja abba a telemetriai adatok küldését, és válassza le az IoT Central-alkalmazásról.
• A DPS-sel való üzembe helyezéshez használja az új azonosító hatókörét a parancs hasznos adatai között.
• A kiépítési eredmény használatával csatlakozzon a cél IoT Hubhoz, és kezdje újra a telemetriai adatok küldését.

A megszakítás minimalizálása

A fennakadások minimalizálása érdekében az eszközöket fázisokban migrálhatja. A vándorló eszköz eszközcsoportokkal helyezi át az eszközöket az IoT Centralról az IoT Hubra. Ossza fel eszközflottát eszközcsoportokra, például texasi eszközökre, New York-i eszközökre és az USA többi részén található eszközökre. Ezután az egyes eszközcsoportokat egymástól függetlenül migráljuk.

Az alábbi lépések végrehajtásával minimalizálja az üzleti hatást:

• Hozza létre a PaaS-megoldást, és futtassa párhuzamosan az IoT Central-alkalmazással.

• Állítsa be a folyamatos adatexportálást az IoT Central-alkalmazásban, és megfelelő útvonalakat a PaaS-megoldás IoT Hubhoz. Alakítsa át mindkét adatcsatornát, és tárolja az adatokat ugyanabba a data lake-be.

• Migrálja az eszközöket fázisokban, és ellenőrizze az egyes fázisokban. Ha valami nem a tervek szerint halad, az eszközök visszakerülnek az IoT Centralba.

• Ha az összes eszközt a PaaS-megoldásba migrálta, és az adatokat teljes mértékben exportálta az IoT Centralból, eltávolíthatja az eszközöket az IoT Central-megoldásból.

Az áttelepítés után az eszközök nem törlődnek automatikusan az IoT Central-alkalmazásból. Ezek az eszközök továbbra is IoT Central-díjakként lesznek kiszámlázva az alkalmazás összes kiépített eszközére vonatkozóan. Ha eltávolítja ezeket az eszközöket az IoT Central-alkalmazásból, a továbbiakban nem kell fizetnie rájuk. Végül távolítsa el az IoT Central-alkalmazást.

Meglévő adatok áthelyezése az IoT Centralból

Az IoT Central konfigurálható a telemetriai és tulajdonságértékek folyamatos exportálására. Az exportálási célhelyek olyan adattárak, mint az Azure Data Lake, az Event Hubs és a Webhook. Az eszközsablonokat az IoT Central felhasználói felületén vagy a REST API-val exportálhatja. A REST API lehetővé teszi a felhasználók exportálását egy IoT Central-alkalmazásban.

Előfeltételek

Az eszköz áttelepítési lépéseinek elvégzéséhez a következő előfeltételekre van szükség:

• A forrás IoT Central-alkalmazás, amelyhez az eszközök jelenleg csatlakoznak.
• A cél IoT Hub, ahová át szeretné helyezni az eszközöket. Ezt az IoT Hubot egy DPS-példányhoz kell csatolni.
• node.js és npm telepítve a helyi gépen, ahol a vándorló eszközt futtatja.

Eszközkövetelmények

A migrálni kívánt eszközöknek implementálniuk kell a DeviceMove parancsot egy migrálás nevű összetevőben. A parancs hasznos adatai tartalmazzák a cél DPS-példány azonosító hatókörét . A vándorló eszköz adattára tartalmaz egy példa DTDL-összetevőmodellt , amely meghatározza a DeviceMove parancsot. Ezt az összetevőt hozzáadhatja meglévő eszközsablonjaihoz.

Az eszköz feltételezi, hogy az összetevő neve és migration a felület azonosítója:dtmi:azureiot:DeviceMigration;1

Az eszközadattár mintakódot is tartalmaz, amely bemutatja, hogyan kell implementálnia egy eszköznek a DeviceMove parancsot.

Eszköz beállítása

A migrálásra való felkészüléshez végezze el a következő beállítási feladatokat:

Microsoft Entra-alkalmazás

A migrálási eszköz használatához Microsoft Entra-alkalmazásregisztrációra van szükség ahhoz, hogy az Azure-előfizetésével hitelesíthesse magát:

1. Lépjen az Azure Portal > Microsoft Entra-azonosító > Alkalmazásregisztrációk.

2. Válassza az Új regisztráció lehetőséget.

3. Adjon meg egy nevet, például "IoTC Migrator app".

4. Válassza a Fiókok lehetőséget bármely szervezeti könyvtárban (Bármely Microsoft Entra címtár – Több-bérlős) és személyes Microsoft-fiókokban (pl. Skype, Xbox).

5. Válassza az Egyoldalas alkalmazás (SPA) lehetőséget.

6. Adja meg http://localhost:3000 átirányítási URI-ként. Ezt az értéket később hozzáadhatja a migrációs alkalmazás konfigurációhoz.

7. Válassza ki a pénztárgépet.

8. Jegyezze fel az alkalmazás (ügyfél) és a címtár (bérlő) azonosítójának értékeit. Ezeket az értékeket később használhatja a vándorló alkalmazás konfigurálásához:

   

9. Lépjen a regisztráció Jegyzék lapjára, és cserélje le a requiredResourceAccess tartalomra a következő konfigurációt:

   [
     {
       "resourceAppId": "9edfcdd9-0bc5-4bd4-b287-c3afc716aac7",
       "resourceAccess": [
         {
           "id": "73792908-5709-46da-9a68-098589599db6",
           "type": "Scope"
         }
       ]
     },
     {
       "resourceAppId": "797f4846-ba00-4fd7-ba43-dac1f8f63013",
       "resourceAccess": [
         {
           "id": "41094075-9dad-400e-a0bd-54e686782033",
           "type": "Scope"
         }
       ]
     },
     {
       "resourceAppId": "00000003-0000-0000-c000-000000000000",
       "resourceAccess": [
         {
           "id": "e1fe6dd8-ba31-4d61-89e7-88639da4683d",
           "type": "Scope"
         }
       ]
     }
   ]
   

10. Mentse el a módosításokat.

Az eszközkulcsok hozzáadása a DPS-hez

Adja hozzá a közös hozzáférésű jogosultságkódkulcsokat vagy az X.509-tanúsítványokat az IoT Central-alkalmazásból a DPS-foglalási csoporthoz.

Ha az eszközei közös hozzáférésű jogosultságkódokat használnak az IoT Central-alkalmazás hitelesítéséhez:

• Az IoT Central-alkalmazásban keresse meg az Engedélyek > eszköz kapcsolatcsoportokat.
• Válassza ki azt a regisztrációs csoportot, amelyet az eszközök használnak.
• Jegyezze fel az elsődleges és másodlagos kulcsokat.
• Az Azure Portalon keresse meg a DPS-példányt.
• Válassza a Regisztrációk kezelése lehetőséget.
• Hozzon létre egy új regisztrációt, és állítsa az igazolás típusát szimmetrikus kulcsra, törölje az automatikus kulcsok kijelölését, majd adja hozzá azokat az elsődleges és másodlagos kulcsokat, amellyel feljegyzett.
• Válassza a Mentés lehetőséget.

Ha az eszközei X.509-tanúsítványokat használnak az IoT Central-alkalmazás hitelesítéséhez:

• Az Azure Portalon keresse meg a DPS-példányt.
• Válassza a Tanúsítványok lehetőséget, majd a Hozzáadás lehetőséget.
• Töltse fel és ellenőrizze az IoT Central-alkalmazásban használt fő- vagy köztes X.509-tanúsítványokat.
• Válassza a Regisztrációk kezelése lehetőséget.
• Hozzon létre egy új regisztrációt, és állítsa az igazolás típusát tanúsítványra, majd válassza ki a feltöltött elsődleges és másodlagos tanúsítványokat.
• Válassza a Mentés lehetőséget.

A migrálási eszköz letöltése és konfigurálása

Töltse le vagy klónozza a migrálási eszköz másolatát a helyi gépre:

git clone https://github.com/Azure/iotc-migrator.git

A letöltött adattár gyökerében hozzon létre egy .env fájlt. Frissítse a REACT_APP_AAD_APP_CLIENT_ID, REACT_APP_AAD_APP_TENANT_IDés REACT_APP_AAD_APP_REDIRECT_URI az értékeket a korábban létrehozott Microsoft Entra-alkalmazásregisztráció értékeivel. Ezután mentse a módosításokat:

PORT=3000
REACT_APP_AAD_APP_CLIENT_ID=<your-AAD-Application-(client)-ID>
REACT_APP_AAD_APP_TENANT_ID=<your-AAD-Directory-(tenant)-ID>
REACT_APP_AAD_APP_REDIRECT_URI=http://localhost:3000

A parancssori környezetben keresse meg az iotc-migrator adattár gyökerét. Ezután futtassa a következő parancsokat a szükséges node.js csomagok telepítéséhez, majd futtassa az eszközt:

npm install
npm start

A migrálási alkalmazás elindítása után navigáljon az eszköz megtekintéséhez http://localhost:3000 . Jelentkezzen be, amikor a rendszer kéri.

Eszközök migrálása

Az eszközzel kötegekben migrálhatja az eszközöket. Adja meg az áttelepítés részleteit az Új migrálás lapon:

1. Adja meg az áttelepítés nevét.
2. Válasszon egy eszközcsoportot az IoT Central-alkalmazásból.
3. Válasszon egy eszközsablont, amely tartalmazza a DeviceMove parancsdefiníciót.
4. Válassza az Áthelyezés a saját Azure IoT Hubra lehetőséget.
5. Válassza ki a cél IoT Hubhoz társított DPS-példányt.
6. Válassza a Migrate (Migrálás) lehetőséget. Az eszköz kéri, hogy másolja a kulcsokat az IoT Central-alkalmazásból a DPS regisztrációs csoportjába. Ezt a lépést korábban az Eszközkulcsok hozzáadása a DPS-hez lépésben hajtotta végre.

Az eszköz mostantól regisztrálja az összes csatlakoztatott eszközt, amely megfelel a céleszköz-szűrőnek a cél IoT Hubon. Az eszköz ezután létrehoz egy feladatot az IoT Central-alkalmazásban, hogy meghívja a DeviceMove metódust az összes eszközön. A parancs hasznos adatai tartalmazzák a cél DPS-példány azonosító hatókörét.

Áttelepítés ellenőrzése

A migrálási eszköz áttelepítési állapotlapjának használatával monitorozza az előrehaladást:

Válasszon ki egy feladatot a Migrálás állapotlapján a feladat állapotának megtekintéséhez az IoT Central-alkalmazásban. Ezen a lapon megtekintheti a feladat egyes eszközeinek állapotát:

Sikeresen áttelepített eszközök:

• Az IoT Central-alkalmazás eszközoldalán bontottként jelenik meg.

• Az IoT Hubon regisztráltként és kiépítettként jelenik meg:

  

• Most telemetriát küld az IoT Hubra