Frissítés importálása az IoT Hub eszközfrissítésére

Megtudhatja, hogyan szerezhet be és importálhat új frissítést az IoT Hub eszközfrissítésébe. Ha még nem tette meg, mindenképpen tekintse át a legfontosabb importálási fogalmakat és az importálandó frissítés előkészítésének módját.

Előfeltételek

• Hozzáférés IoT Hubhoz , amelyen engedélyezve van az IoT Hub eszközfrissítése.
• Az IoT Hub eszközfrissítéséhez kiépített IoT-eszköz (vagy szimulátor).
• Kövesse a frissítés előkészítése az IoT Hub eszközfrissítésébe való importáláshoz szükséges lépéseit a frissítési fájlok importálási jegyzékének létrehozásához.

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.

Frissítés importálása

Ez a szakasz bemutatja, hogyan importálhat frissítést az Azure Portal vagy az Azure CLI használatával. Az IoT Hub API-k eszközfrissítésével is importálhat egy frissítést.

Frissítés importálásához először töltse fel a frissítési fájlokat, és importálja a jegyzékfájlokat egy Azure Storage-tárolóba. Ezután importálja a frissítést az Azure Storage-ból az IoT Hub eszközfrissítésébe, ahol a rendszer tárolja az eszközökre való üzembe helyezéshez.

Azure Portal

1. Az Azure Portalon lépjen az IoT Hubra az eszközfrissítéssel.

2. A lap bal oldalán válassza Frissítések Eszközkezelés alatt.

   

3. Válassza ki a Frissítések lapot a képernyő tetején lévő lapok listájából.

   

4. Válassza a + Új frissítés importálása az Elérhető Frissítések fejléc alatt lehetőséget.

   

5. Válassza a + Kiválasztás a tárolóból lehetőséget. Megjelenik a Tárfiókok felhasználói felülete. Válasszon ki egy meglévő fiókot, vagy hozzon létre egy fiókot a + Storage-fiókkal. Ez a fiók egy tárolóhoz használható a frissítések importáláshoz való szakaszához. A fiók nem rendelkezhet egyszerre nyilvános és privát végpontokkal.

   

6. Miután kiválasztott egy Storage-fiókot, megjelenik a Tárolók felhasználói felülete. Válasszon ki egy meglévő tárolót, vagy hozzon létre egy tárolót a + Tároló használatával. Ez a tároló a frissítési fájlok importáláshoz való szakaszolására szolgál

   Javasoljuk, hogy minden egyes frissítés importálásakor használjon új tárolót. Az új tárolók használata segít elkerülni a fájlok véletlen importálását a korábbi frissítésekből. Ha nem használ új tárolót, a lépés végrehajtása előtt mindenképpen törölje a fájlokat a meglévő tárolóból.

   

7. A tárolóban válassza a Feltöltés lehetőséget. Megjelenik a Feltöltés felhasználói felület.

   

8. Válassza a Mappa ikont a Fájlok szakasz jobb oldalán, a Blob feltöltése fejléc alatt. A fájlválasztóval keresse meg a frissítési fájlok helyét, és importálja a jegyzékfájlokat, jelölje ki az összes fájlt, majd válassza a Megnyitás lehetőséget. Tartsa lenyomva a Shift billentyűt, és kattintson a fájlok többszörös kijelöléséhez.

   

9. Amikor kiválasztotta az összes frissítési fájlt, válassza a Feltöltés lehetőséget.

   

10. Válassza ki a feltöltött fájlokat az importálandó fájlok kijelöléséhez. Ezután a Kiválasztás gombra kattintva visszatérhet a Frissítés importálása lapra.

    

11. A Frissítés importálása lapon tekintse át az importálni kívánt fájlokat. Ezután válassza a Frissítés importálása lehetőséget az importálási folyamat elindításához. A hibák elhárításához tekintse meg a proxyfrissítés hibaelhárítását.

    

12. Az importálási folyamat megkezdődik, és a képernyő az Importálási előzmények szakaszra vált. A Frissítés elemet választva megtekintheti az importálási folyamat befejezéséig tartó folyamatot (a frissítés méretétől függően a folyamat néhány perc múlva befejeződhet, de hosszabb időt is igénybe vehet).

    

13. Ha az Állapot oszlop azt jelzi, hogy az importálás sikeres volt, válassza az Elérhető Frissítések fejlécet. Most már látnia kell az importált frissítést a listában.

    

Azure CLI

Az az iot du update stage parancs kezeli a frissítés importálásának előfeltételeit, beleértve a frissítési fájlok céltárolóba való feltöltését is. A választható jelzők azt is lehetővé teszik, hogy a parancs az előkészítés után automatikusan importálja a fájlokat. Ellenkező esetben az az iot du update importálási parancs befejezi a folyamatot.

A stage 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.
• --manifest-path: A szakaszba helyezendő importálási jegyzékfájl elérési útja.
• --storage-account: A frissítés szakaszához tartozó tárfiók neve.
• --storage-container: A kiválasztott tárfiókon belüli tároló neve a frissítés szakaszához.
• --overwrite: Nem kötelező jelölő, amely jelzi, hogy felülírja-e a meglévő blobokat a tárolóban, ha ütközés van.
• --then-import: Választható jelző, amely azt jelzi, hogy a frissítést importálni kell-e az Eszközfrissítésbe a szakaszosítás után.

az iot du update stage \
    --account <Replace with your Device Update account name> \
    --instance <Replace with your Device Update instance name> \
    --manifest-path <Replace with the full path to your import manifest> \
    --storage-account <Replace with your Storage account name> \
    --storage-container <Replace with your container name> \
    --overwrite --then-import

Példa:

az iot du update stage \
    --account deviceUpdate001 \
    --instance myInstance \
    --manifest-path /my/apt/manifest/file.importmanifest.json \
    --storage-account deviceUpdateStorage \
    --storage-container deviceUpdateDemo \
    --overwrite --then-import

Ha több importálási jegyzékfájllal rendelkezik, azokat egyetlen parancsba is belefoglalhatja. Példa:

az iot du update stage \
    --account deviceUpdate001 \
    --instance myInstance \
    --manifest-path /my/apt/manifest/parent.importmanifest.json \
    --manifest-path /my/apt/manifest/child1.importmanifest.json \
    --manifest-path /my/apt/manifest/child2.importmanifest.json \
    --storage-account deviceUpdateStorage \
    --storage-container deviceUpdateDemo \
    --overwrite --then-import

Ha nem használja a --then-import jelölőt, a parancs kimenete tartalmazza az stage iot du frissítés importálásának futtatására vonatkozó kérést, beleértve az előre kitöltött argumentumokat is.

Az az iot du update listával ellenőrizze, hogy a frissítés vagy a frissítések importálása sikeresen megtörtént-e.

az iot du update list \
    --account <Replace with your Device Update account name> \
    --instance <Replace with your Device Update instance name> \
    -o table

Ha ehelyett API-kat használ

A frissítést programozott módon is importálhatja a következő módon:

• .NET, Java, JavaScript vagy Python használata Azure SDK
• Az Import Update REST API használata
• PowerShell-mintamodulok használata
  • PowerShell 5 vagy újabb verziót igényel (linuxos, macOS és Windows rendszerű telepítéseket is beleértve)

Feljegyzés

Tekintse meg az eszközfrissítési felhasználói szerepköröket és a szükséges API-engedélyhez való hozzáférést .

A fájlok frissítését és az importálási jegyzékfájlt egy Azure Storage Blob-tárolóba kell feltölteni az előkészítéshez. A szakaszos fájlok importálásához adja meg a blob URL-címét vagy a privát blobok közös hozzáférésű jogosultságkódját (SAS) a Device Update API-nak. SAS használata esetén mindenképpen adjon meg három vagy több órás lejárati időt

Tipp.

Ha nagy méretű frissítési fájlokat szeretne feltölteni az Azure Storage Blob-tárolóba, az alábbiak egyikét használhatja a jobb teljesítmény érdekében:

• AzCopy
• Azure Storage Explorer

Következő lépések

• Csoportok létrehozása
• Tudnivalók az importálási fogalmakról