Frissítés üzembe helyezése az Azure IoT Hub eszközfrissítésével

Megtudhatja, hogyan helyezhet üzembe frissítést egy IoT-eszközön az Azure IoT Hub eszközfrissítésével.

Előfeltételek

• Hozzáférés IoT Hubhoz , amelyen engedélyezve van az IoT Hub eszközfrissítése. Javasoljuk, hogy az IoT Hubhoz használjon S1 (Standard) vagy újabb szintet.
• A kiépített eszköz importált frissítése.
• Az IoT Hub eszközfrissítéséhez kiépített IoT-eszköz (vagy szimulátor).
• Az eszköz legalább egy alapértelmezett csoport vagy felhasználó által létrehozott frissítési csoport része.

Azure Portal

Támogatott böngészők:

• Microsoft Edge
• Google Chrome

Azure CLI

Azure CLI-környezet:

• Használja a Bash-környezetet az Azure Cloud Shellben.

  

• Vagy ha inkább helyi parancssori felületi referenciaparancsokat szeretne futtatni, telepítse az Azure CLI-t

  1. Jelentkezzen be az Azure CLI-be az az login paranccsal.
  2. Futtassa az az version parancsot a telepített verzió és a függő kódtárak megkereséséhez. A legújabb verzióra az az upgrade paranccsal frissíthet.
  3. Amikor a rendszer kéri, először telepítse az Azure CLI-bővítményeket. A cikkben szereplő parancsok az Azure-iot bővítményt használják. Futtassa az extension update --name azure-iot a bővítmény legújabb verzióját.

Tipp.

A cikkben szereplő Azure CLI-parancsok a fordított perjel \ karaktert használják a vonal folytatásához, hogy a parancsargumentumok könnyebben olvashatók legyenek. Ez a szintaxis Bash-környezetekben működik. Ha ezeket a parancsokat a PowerShellben futtatja, cserélje le az egyes fordított perjeleket egy "" háttérre, vagy távolítsa el őket teljesen.

A frissítés üzembe helyezése

Azure Portal

1. Az Azure Portalon keresse meg az IoT hubot.

2. Válassza Frissítések a navigációs menüben az IoT Hub-példány Eszközfrissítés lapjának megnyitásához.

   

3. Válassza a Lap tetején található Csoportok és üzemelő példányok lapot. További információ: Eszközcsoportok.

   

4. Tekintse meg a frissítési megfelelőségi diagramot és a csoportlistát. A címkealapú vagy az alapértelmezett csoporthoz elérhető új frissítésnek kell megjelennie. Előfordulhat, hogy egyszer frissítenie kell. További információ: Eszközfrissítések megfelelősége.

5. Az elérhető egy vagy több frissítés mellett válassza az Üzembe helyezés lehetőséget, és ellenőrizze, hogy az importáláskor hozzáadott leíró címke jelen van-e, és helyesen jelenik-e meg.

6. Győződjön meg arról, hogy a megfelelő csoport van kijelölve célcsoportként, és válassza az Üzembe helyezés lehetőséget.

7. Az üzembe helyezés elindításához lépjen az Aktuális üzembe helyezés lapra. Válassza a kívánt frissítés melletti Üzembe helyezés hivatkozást az Elérhető frissítések szakaszban. Az adott csoport számára elérhető legjobb frissítés a legjobb kiemeléssel van jelölve.

   

8. Ütemezze az üzembe helyezés azonnali vagy jövőbeli indítását.

   Tipp.

   Alapértelmezés szerint a kezdési dátum és az idő azonnali értékre van állítva. Ügyeljen arra, hogy válasszon másik dátumot és időpontot, ha azt szeretné, hogy az üzembe helyezés később kezdődjön.

   

9. Szükség esetén hozzon létre egy automatikus visszaállítási szabályzatot. Válassza a Létrehozás parancsot.

10. Az üzembe helyezés részletei között az állapot aktívvá válik. Az üzembe helyezett frissítés megjelölése (üzembe helyezés).

    

11. Tekintse meg a megfelelőségi diagramot, és ellenőrizze, hogy a frissítés folyamatban van-e.

    

12. Az eszköz sikeres frissítése után láthatja, hogy a megfelelőségi diagram és az üzembehelyezési adatok is frissülnek, hogy azok tükrözzék azokat.

    

Azure CLI

A az iot du device group list csoport számára elérhető legjobb frissítés ellenőrzéséhez. A parancs a következő argumentumokat veszi fel:

• --account: Az eszközfrissítési fiók neve.
• --instance: Az Eszközfrissítés példány neve.
• --group-id: Az ezzel az üzembe helyezéssel megcélzott eszközcsoport azonosítója. Ez az azonosító az ADUGroup címke értéke, vagy $default címkével nem rendelkező eszközök esetén.
• --best-updates: Ez a jelző azt jelzi, hogy a parancsnak le kell kérnie az eszközcsoport számára elérhető legjobb frissítéseket, beleértve annak számát, hogy hány eszköznek van szüksége az egyes frissítésekre.
• '--resource-group -g': Eszközfrissítési fiók erőforráscsoportjának neve.
• "--update-compliance": Ez a jelző azt jelzi, hogy a parancsnak le kell kérnie az eszközcsoport frissítési megfelelőségi információit, például hogy hány eszköz van a legújabb frissítésen, hányan igényelnek új frissítéseket, és hány van folyamatban az új frissítés fogadása során.

az iot du device group list \
    --account <Device Update account name> \
    --instance <Device Update instance name>\
    --gid <device group id>\
    --best-updates {false, true}

Az az iot du device deployment create használatával hozzon létre üzembe helyezést egy eszközcsoport számára.

A device deployment create parancs a következő argumentumokat veszi fel:

• --account: Az eszközfrissítési fiók neve.
• --instance: Az Eszközfrissítés példány neve.
• --group-id: Az ezzel az üzembe helyezéssel megcélzott eszközcsoport azonosítója. Ez az azonosító az ADUGroup címke értéke, vagy $default címkével nem rendelkező eszközök esetén.
• --deployment-id: Az üzembe helyezés azonosítására szolgáló azonosító.
• --update-name, --update-providerés --update-version: Ez a három paraméter határozza meg az updateId objektumot, amely az ebben az üzembe helyezésben használt frissítés egyedi azonosítója.

az iot du device deployment create \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group id> \
    --deployment-id <deployment id> \
    --update-name <update name> \
    --update-provider <update provider> \
    --update-version <update version>

Az opcionális argumentumok lehetővé teszik az üzembe helyezés konfigurálását. A teljes listát a Választható paraméterek című témakörben találja .

Ha automatikus visszaállítási szabályzatot szeretne létrehozni, adja hozzá a következő paramétereket:

• --failed-count: Azon sikertelen eszközök száma egy üzembe helyezésben, amely visszaállítást indít el.
• --failed-percentage: A sikertelen eszközök százalékos aránya egy üzembe helyezésben, amely visszaállítást indít el.
• --rollback-update-name, , --rollback-update-provider: --rollback-update-versionAnnak a frissítésnek az updateID azonosítója, amelyet az eszközcsoport a visszaállítás kezdeményezésekor használni fog.

az iot du device deployment create \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group id> \
    --deployment-id <deployment id> \
    --update-name <update name> \
    --update-provider <update provider> \
    --update-version <update version> \
    --failed-count 10 \
    --failed-percentage 5 \
    --rollback-update-name <rollback update name> \
    --rollback-update-provider <rollback update provider> \
    --rollback-update-version <rollback update version>

Ha azt szeretné, hogy az üzembe helyezés a jövőben elinduljon, a --start-time paraméter használatával adja meg az üzembe helyezés céldátumát.

az iot du device deployment create \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group id> \
    --deployment-id <deployment id> \
    --update-name <update name> \
    --update-provider <update provider> \
    --update-version <update version> \
    --start-time "2022-12-20T01:00:00"

Frissítéstelepítés figyelése

Azure Portal

1. Válassza ki azt a csoportot, amelybe telepítette, és lépjen az Aktuális frissítések vagy az Üzembe helyezési előzmények lapra annak ellenőrzéséhez, hogy az üzembe helyezés folyamatban van-e

   

2. Válassza a Létrehozott telepítés melletti Részletek lehetőséget . Itt megtekintheti az üzembe helyezés részleteit, a frissítés részleteit és a céleszközosztály részleteit. Igény szerint hozzáadhat egy rövid nevet az eszközosztályhoz.

   

3. Válassza a Frissítés lehetőséget a legújabb állapotadatok megtekintéséhez.

4. A csoport alapszintű nézetére léphet egy adott eszköz állapotának kereséséhez, vagy szűrhet az üzembe helyezés meghiúsult eszközeinek megtekintéséhez

Azure CLI

Az az iot du eszköztelepítési lista használatával megtekintheti egy eszközcsoport összes üzembe helyezését.

az iot du device deployment list \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group id>

Az az iot du device deployment show használatával megtekintheti egy adott üzembe helyezés részleteit.

az iot du device deployment show \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group ID> \
    --deployment-id <deployment ID>

Adja hozzá a --status jelzőt, és adja vissza az üzemelő példányban lévő eszközök állapotáról, befejezéséről vagy sikertelenségéről szóló információkat.

az iot du device deployment show \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group ID> \
    --deployment-id <deployment ID> \
    --status

Frissítéstelepítés ismételt megkísérlése

Ha az üzembe helyezés valamilyen okból meghiúsul, újrapróbálhatja a sikertelen eszközök üzembe helyezését.

Azure Portal

1. Lépjen az Aktuális üzembe helyezés lapra a Csoport részletei képernyőn.

   

2. Válassza az Újrapróbálkozás sikertelen eszközök lehetőséget , és nyugtázza a megerősítésről szóló értesítést.

Azure CLI

Az az iot du device deployment újrapróbálkozása az eszközök cél alcsoportjának üzembe helyezésének újrapróbálkozásához.

Ez a parancs az eszközfrissítési --class-id ügynök által jelentett modellazonosítóból és kompatibilitási tulajdonságokból létrehozott argumentumot használja.

az iot du device deployment retry \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --deployment-id <deployment ID> \
    --group-id <device group ID> \
    --class-id <device class ID>

Következő lépések

Gyakori problémák megoldása