Migrace zařízení do Azure IoT Hubu

  • Článek

Pokud se rozhodnete migrovat z řešení založeného na IoT Central na řešení založené na IoT Hubu, musíte změnit konfiguraci všech zařízení, která jsou aktuálně připojená k vaší aplikaci. Nástroj IoTC Migration automatizuje tento proces migrace zařízení.

Nástroj pro migraci:

  • Vytvoří ve službě IoT Hub registrace zařízení pro zařízení, která se aktuálně připojují k vaší aplikaci IoT Central.
  • Použije příkaz k odeslání oboru ID instance služby Device Provisioning Service (DPS) přidružené k vašemu centru IoT do zařízení.

Nástroj vyžaduje, aby připojená zařízení implementovaly příkaz DeviceMove definovaný v šabloně zařízení v aplikaci IoT Central. Datová část příkazu je obor ID cílové instance DPS. Když zařízení obdrží tento příkaz, měl by:

  • Ukončete odesílání telemetrie a odpojte se od aplikace IoT Central.
  • Zřiďte se pomocí DPS pomocí nového oboru ID v datové části příkazu.
  • Pomocí výsledku zřizování se připojte k cílovému centru IoT a znovu spusťte odesílání telemetrie.

Tip

Nástroj pro migraci můžete použít také k migraci zařízení mezi aplikacemi IoT Cental nebo z centra IoT do aplikace IoT Central.

Minimalizace přerušení

Pokud chcete minimalizovat přerušení, můžete migrovat zařízení ve fázích. Nástroj pro migraci používá skupiny zařízení k přesunu zařízení z IoT Central do centra IoT. Rozdělte vozový park zařízení do skupin zařízení, jako jsou zařízení v Texasu, zařízení v New Yorku a zařízení ve zbytku USA. Pak migrujte každou skupinu zařízení nezávisle.

Upozorňující

Nepřiřazená zařízení nemůžete přidat do skupiny zařízení. Nástroj pro migraci proto v současné době nemůžete použít k migraci nepřiřazených zařízení.

Pokud chcete minimalizovat obchodní dopad, postupujte následovně:

  • Vytvořte řešení PaaS a spusťte ho paralelně s aplikací IoT Central.

  • Nastavte průběžný export dat v aplikaci IoT Central a příslušné trasy do centra IoT hubu řešení PaaS. Transformujte datové kanály a uložte je do stejného datového jezera.

  • Migrujte zařízení ve fázích a ověřte je v každé fázi. Pokud se něco nespustí podle plánu, po obnovení zařízení zpět do IoT Central.

  • Když jste migrovali všechna zařízení do řešení PaaS a plně exportovali data z IoT Central, můžete je z řešení IoT Central odebrat.

Po migraci se zařízení z aplikace IoT Central automaticky neodstraní. Tato zařízení se budou dál účtovat jako poplatky za IoT Central za všechna zřízená zařízení v aplikaci. Když tato zařízení odeberete z aplikace IoT Central, už se vám za ně neúčtuje. Nakonec odeberte aplikaci IoT Central.

Přesun existujících dat z IoT Central

IoT Central můžete nakonfigurovat tak, aby průběžně exportovali telemetrická data a hodnoty vlastností. Cíle exportu jsou úložiště dat, jako jsou Azure Data Lake, Event Hubs a Webhooky. Šablony zařízení můžete exportovat pomocí uživatelského rozhraní IoT Central nebo rozhraní REST API. Rozhraní REST API umožňuje exportovat uživatele v aplikaci IoT Central.

Požadavky

K dokončení kroků migrace zařízení potřebujete následující požadavky:

  • Zdrojová aplikace IoT Central, kde se vaše zařízení aktuálně připojují.
  • Cílové centrum IoT, do kterého chcete přesunout zařízení. Toto centrum IoT musí být propojené s instancí DPS.
  • node.js a npm nainstalované na místním počítači, na kterém spouštíte nástroj pro migraci.

Požadavky na zařízení

Zařízení, která chcete migrovat, musí implementovat příkaz DeviceMove v komponentě označované jako migrace. Datová část příkazu obsahuje obor ID cílové instance DPS. Úložiště nástrojů pro migraci obsahuje ukázkový model komponent DTDL, který definuje příkaz DeviceMove . Tuto komponentu můžete přidat do existujících šablon zařízení.

Nástroj předpokládá, že název komponenty je migration a že ID rozhraní je dtmi:azureiot:DeviceMigration;1:

Screenshot that highlights the component name and interface ID.

Úložiště nástrojů také obsahuje ukázkový kód , který ukazuje, jak by zařízení mělo implementovat příkaz DeviceMove .

Nastavení nástroje

Proveďte následující úlohy nastavení a připravte se na migraci:

Aplikace Microsoft Entra

Nástroj pro migraci vyžaduje registraci aplikace Microsoft Entra, aby se mohla ověřit ve vašem předplatném Azure:

  1. Přejděte na azure Portal > Microsoft Entra ID > Registrace aplikací.

  2. Vyberte Nová registrace.

  3. Zadejte název, například "Aplikace IoTC Migrator".

  4. Vyberte účty v libovolném organizačním adresáři (libovolný adresář Microsoft Entra – Víceklient) a osobní účty Microsoft (např. Skype, Xbox).

  5. Vyberte jednostránkové aplikace (SPA).

  6. Zadejte http://localhost:3000 jako identifikátor URI přesměrování. Tuto hodnotu přidáte do konfigurace aplikace pro migraci později.

  7. Vyberte Zaregistrovat.

  8. Poznamenejte si hodnoty ID aplikace (klienta) a ID adresáře (tenanta). Tyto hodnoty použijete později ke konfiguraci aplikace pro migraci:

    Screenshot that shows the Microsoft Entra application in the Azure portal.

  9. Přejděte na stránku Manifest v registraci a nahraďte obsah requiredResourceAccess následující konfigurace:

    [
  {
    "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. Uložte změny.

Přidání klíčů zařízení do DPS

Přidejte klíče sdíleného přístupového podpisu nebo certifikáty X.509 z aplikace IoT Central do skupiny přidělování DPS.

Pokud vaše zařízení používají sdílené přístupové podpisy k ověření ve vaší aplikaci IoT Central:

  • V aplikaci IoT Central přejděte do skupin připojení zařízení oprávnění>.
  • Vyberte skupinu registrací, které vaše zařízení používají.
  • Poznamenejte si primární a sekundární klíče.
  • Na webu Azure Portal přejděte k vaší instanci DPS.
  • Vyberte Správa registrací.
  • Vytvořte novou registraci a nastavte typ ověření identity na symetrický klíč, zrušte výběr klíčů automatického generování a přidejte primární a sekundární klíče, o které jste si poznamenali.
  • Zvolte Uložit.

Pokud vaše zařízení používají certifikáty X.509 k ověření ve vaší aplikaci IoT Central:

  • Na webu Azure Portal přejděte k vaší instanci DPS.
  • Vyberte Certifikáty a pak vyberte Přidat.
  • Nahrajte a ověřte kořenové nebo zprostředkující certifikáty X.509, které používáte ve své aplikaci IoT Central.
  • Vyberte Správa registrací.
  • Vytvořte novou registraci a nastavte typ ověření identity na Certifikát a pak vyberte primární a sekundární certifikáty, které jste nahráli.
  • Zvolte Uložit.

Stažení a konfigurace nástroje pro migraci

Stáhněte nebo naklonujte kopii nástroje pro migraci do místního počítače:

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

V kořenovém adresáři staženého úložiště vytvořte soubor .env . REACT_APP_AAD_APP_CLIENT_IDAktualizujte hodnoty a REACT_APP_AAD_APP_TENANT_IDREACT_APP_AAD_APP_REDIRECT_URI hodnoty s hodnotami z registrace aplikace Microsoft Entra, kterou jste vytvořili dříve. Pak uložte změny:

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

Tip

Ujistěte se, že odpovídá REACT_APP_AAD_APP_REDIRECT_URI identifikátoru URI přesměrování, který jste použili při registraci aplikace Microsoft Entra.

V prostředí příkazového řádku přejděte do kořenového iotc-migrator adresáře úložiště. Potom spuštěním následujících příkazů nainstalujte požadované balíčky node.js a spusťte nástroj:

npm install
npm start

Po spuštění aplikace pro migraci přejděte k http://localhost:3000 zobrazení nástroje. Po zobrazení výzvy se přihlaste.

Migrace zařízení

Pomocí nástroje můžete migrovat zařízení v dávkách. Na stránce Nová migrace zadejte podrobnosti o migraci :

  1. Zadejte název migrace.
  2. Vyberte skupinu zařízení z aplikace IoT Central.
  3. Vyberte šablonu zařízení, která obsahuje definici příkazu DeviceMove .
  4. Vyberte Přesunout do vlastního Azure IoT Hubu.
  5. Vyberte instanci DPS propojenou s vaším cílovým centrem IoT.
  6. Vyberte Migrovat. Nástroj vás vyzve ke zkopírování klíčů z aplikace IoT Central do skupiny registrací DPS. Tento krok jste už dokončili v kroku Přidat klíče zařízení do DPS .

Screenshot of migration tool that shows the migration definition.

Nástroj teď zaregistruje všechna připojená zařízení, která odpovídají filtru cílového zařízení v cílovém centru IoT. Nástroj pak ve vaší aplikaci IoT Central vytvoří úlohu pro volání metody DeviceMove na všech těchto zařízeních. Datová část příkazu obsahuje obor ID cílové instance DPS.

Ověření migrace

Ke sledování průběhu použijte stránku Stav migrace v nástroji pro migraci:

Screenshot that shows the migration status page in the tool.

Výběrem úlohy na stránce Stav migrace zobrazíte stav úlohy v aplikaci IoT Central. Na této stránce můžete zobrazit stav jednotlivých zařízení v úloze:

Screenshot showing completed migration status for IoT Central job.

Zařízení, která se úspěšně migrovala:

  • Zobrazení jako odpojené na stránce zařízení v aplikaci IoT Central

  • Zobrazení jako zaregistrované a zřízené ve službě IoT Hub:

    Screenshot of IoT Hub in the Azure portal that shows the provisioned devices.

  • Posílání telemetrie do centra IoT

    Screenshot of IoT Hub in the Azure portal that shows telemetry metrics for the migrated devices.