Import aktualizace do služby Azure Device Update pro IoT Hub

Pokud chcete nasadit aktualizaci na zařízení pomocí služby Azure Device Update pro IoT Hub, nejprve naimportujete aktualizační soubory do služby Device Update, která ukládá importovanou aktualizaci pro nasazení do zařízení. V tomto článku se dozvíte, jak importovat aktualizaci do služby Device Update pomocí webu Azure Portal, Azure CLI nebo rozhraní API služby Device Update.

Požadavky

• Účet a instance služby Device Update nakonfigurované s centrem IoT.

• Zařízení IoT nebo simulátor zřízený pro službu Device Update v centru IoT.

• Aktualizujte soubory pro vaše zařízení a přidružený soubor manifestu importu vytvořený podle pokynů v části Příprava aktualizace pro import do služby Device Update.

• Účet služby Azure Storage a kontejner pro uložení importovaných souborů. Nebo můžete vytvořit nový účet úložiště a kontejner jako součást procesu importu založeného na webu Azure Portal.

  Důležité

  Ujistěte se, že účet úložiště, který používáte nebo vytváříte, nemá povolené privátní koncové body. Pokud chcete zjistit, jestli jsou povolené privátní koncové body, můžete v Centru služby Private Link zkontrolovat název účtu služby Azure Storage.

Azure Portal

• Podporované prohlížeče Microsoft Edge nebo Google Chrome.

Azure CLI

• Prostředí Bash.

  Ke spuštění příkazů v tomto článku můžete použít prostředí Bash v Azure Cloud Shellu . Výběrem možnosti Spustit Cloud Shell otevřete Cloud Shell nebo na horním panelu nástrojů webu Azure Portal vyberte ikonu Cloud Shellu.

  

  Pokud chcete, můžete příkazy Azure CLI spustit místně:

  1. Nainstalovat rozhraní příkazového řádku Azure CLI. Spuštěním příkazu az version zobrazte nainstalovanou verzi Azure CLI a závislé knihovny a spuštěním příkazu az upgrade nainstalujte nejnovější verzi.
  2. Přihlaste se k Azure spuštěním příkazu az login.
  3. Po zobrazení výzvy k prvnímu azure-iot použití nainstalujte rozšíření. Pokud chcete mít jistotu, že používáte nejnovější verzi rozšíření, spusťte az extension update --name azure-iotpříkaz .

Tip

Příkazy Azure CLI v tomto článku používají zpětné lomítko \ znak pro pokračování řádku, aby byly argumenty příkazu snadněji čitelné. Tato syntaxe funguje v prostředích Bash. Pokud tyto příkazy spustíte v PowerShellu, nahraďte každé zpětné lomítko zpětným lomítkem nebo je úplně odeberte.

Import aktualizace

Tato část ukazuje, jak importovat aktualizaci pomocí webu Azure Portal nebo Azure CLI. Aktualizaci můžete také importovat pomocí rozhraní API služby Device Update.

Pokud chcete naimportovat aktualizaci, nejprve nahrajete aktualizaci a naimportujete soubory manifestu do kontejneru Azure Storage. Pak naimportujete aktualizaci ze služby Azure Storage do služby Device Update pro IoT Hub, která ji ukládá pro nasazení do zařízení.

Azure Portal

1. Na webu Azure Portal na stránce Centra IoT pro vaši instanci služby Device Update vyberte v levém navigačním panelu aktualizace správy>zařízení.

   

2. Na stránce Aktualizace vyberte Importovat novou aktualizaci.

   

3. Na stránce Import update (Importovat aktualizaci) vyberte Select from storage container (Vybrat z kontejneru úložiště).

4. Na stránce Účty úložiště vyberte existující účet úložiště nebo vytvořte nový účet výběrem účtu úložiště. Pomocí účtu úložiště pro kontejner připravíte aktualizační soubory.

5. Na stránce Kontejnery vyberte existující kontejner nebo vytvořte nový kontejner výběrem kontejneru. Pomocí kontejneru připravíte soubory aktualizací pro import.

   

   Tip

   Použití nového kontejneru při každém importu aktualizace pomáhá zabránit nechtěnému importu souborů z předchozích aktualizací. Pokud nepoužíváte nový kontejner, nezapomeňte z existujícího kontejneru odstranit všechny předchozí soubory.

6. Na stránce kontejneru vyberte Nahrát.

   

7. Na obrazovce Nahrát objekt blob vyberte ikonu složky vedle položky Soubory. Pomocí nástroje pro výběr souborů přejděte do umístění souborů manifestu aktualizace a importu, vyberte soubory a pak vyberte Otevřít. K vícenásobnému výběru souborů můžete použít klávesu Shift.

   

8. Po výběru všech souborů vyberte Nahrát.

   

9. Po nahrání se soubory zobrazí na stránce kontejneru. Na stránce kontejneru zkontrolujte a vyberte soubory, které chcete importovat, a pak vyberte Vybrat.

   

10. Na obrazovce Importovat aktualizaci vyberte Importovat aktualizaci.

    

Proces importu začíná a obrazovka se přepne na obrazovku Aktualizace . Po úspěšném importu se zobrazí na kartě Aktualizace . Pokud chcete vyřešit případné chyby, přečtěte si téma Řešení potíží s aktualizací proxy serveru.

Azure CLI

Příkaz az iot du update stage zpracovává požadované kroky importu aktualizace, včetně nahrání souborů aktualizací do cílového kontejneru úložiště. Volitelný příznak také umožňuje, aby tento příkaz po přípravě automaticky naimportoval soubory. V opačném případě příkaz az iot du update import proces dokončí.

Příkaz stage přijímá následující argumenty:

• --account: Název účtu aktualizace zařízení.
• --instance: Název instance služby Device Update.
• --manifest-path: Cesta k souboru k manifestu importu do fáze.
• --storage-account: Název účtu úložiště, na který má být aktualizace připravena.
• --storage-container: Název kontejneru ve vybraném účtu úložiště pro fázi aktualizace.
• --overwrite: Volitelný příznak označující, jestli se mají přepsat existující objekty blob v kontejneru úložiště, pokud dojde ke konfliktu.
• --then-import: Volitelný příznak, který označuje, jestli se má aktualizace naimportovat do služby Device Update po přípravě.

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říklad:

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

Do jednoho příkazu můžete zahrnout více manifestů importu. Příklad:

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

Pokud příznak nepoužíváte --then-import , výstup stage příkazu obsahuje příkazový řádek ke spuštění příkazu az iot du update import s předem vyplněnými argumenty.

Pomocí příkazu az iot du update list ověřte, že se aktualizace úspěšně importují.

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

Import pomocí rozhraní API služby Device Update

Aktualizaci můžete také importovat prostřednictvím kódu programu pomocí některé z následujících metod:

• Rozhraní API služby Device Update v sadách Azure SDK pro .NET, Java, JavaScript nebo Python
• Rozhraní REST API pro import aktualizace zařízení
• Ukázkové moduly PowerShellu (vyžaduje PowerShell 5 nebo novější pro Linux, macOS nebo Windows)

Poznámka:

Viz role uživatelů služby Device Update a přístup k požadovaným oprávněním rozhraní API.

Soubory aktualizací a manifest importu se musí nahrát do kontejneru objektů blob služby Azure Storage pro přípravu. Pokud chcete importovat fázované soubory, zadejte adresu URL objektu blob nebo sdílený přístupový podpis (SAS) pro privátní objekty blob do rozhraní API služby Device Update. Pokud používáte SAS, nezapomeňte zadat interval vypršení platnosti 3 hodiny nebo více.

Tip

K nahrání velkých aktualizačních souborů do kontejneru objektů blob služby Azure Storage můžete použít jednu z následujících metod pro lepší výkon:

• AzCopy
• Azure Storage Explorer

Související obsah

• Skupiny zařízení
• Manifest importu služby Device Update