Import aktualizace do služby Device Update pro IoT Hub

Zjistěte, jak získat novou aktualizaci a importovat ji do služby Device Update pro IoT Hub. Pokud jste to ještě neudělali, nezapomeňte si projít klíčové koncepty importu a připravit aktualizaci, která se má importovat.

Požadavky

• Přístup ke službě IoT Hub s povolenou službou Device Update pro IoT Hub

• Kontejner Azure Storage bez povoleného privátního koncového bodu

  • Pokud si nejste jistí, jestli je povolený privátní koncový bod, přejděte do Centra služby Private Link, vyberte na levé straně privátní koncové body a pak ve sloupci Prostředky vyhledejte název vašeho účtu služby Azure Storage.

• Zařízení IoT (nebo simulátor) zřízené pro službu Device Update ve službě IoT Hub.

• Postupujte podle kroků v části Příprava aktualizace pro import do služby Device Update pro IoT Hub a vytvořte manifest importu pro vaše aktualizační soubory.

Azure Portal

Podporované prohlížeče:

• Microsoft Edge
• Google Chrome

Azure CLI

Prostředí Azure CLI:

• Použijte prostředí Bash v Azure Cloud Shellu.

  

• Nebo pokud dáváte přednost místnímu spouštění referenčních příkazů rozhraní příkazového řádku, nainstalujte Azure CLI.

  1. Přihlaste se k Azure CLI pomocí příkazu az login .
  2. Spuštěním příkazu az version zjistěte verzi a závislé knihovny, které jsou nainstalované. Pokud chcete upgradovat na nejnovější verzi, spusťte az upgrade.
  3. Po zobrazení výzvy nainstalujte rozšíření Azure CLI při prvním použití. Příkazy v tomto článku používají rozšíření azure-iot . Spusťte, az extension update --name azure-iot abyste měli jistotu, že používáte nejnovější verzi rozšíření.

Tip

Příkazy Azure CLI v tomto článku používají znak zpětného lomítka \ pro pokračování řádku, aby byly argumenty příkazů čitelnější. Tato syntaxe funguje v prostředích Bash. Pokud tyto příkazy spouští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. Místo toho můžete k importu aktualizace použít také rozhraní API služby Device Update pro IoT Hub.

Pokud chcete naimportovat aktualizaci, nejprve nahrajete aktualizační soubory a import manifestu do kontejneru Azure Storage. Pak naimportujete aktualizaci ze služby Azure Storage do služby Device Update pro IoT Hub, kde se uloží, abyste ji mohli nasadit do zařízení.

Azure Portal

1. Na webu Azure Portal přejděte ke službě IoT Hub pomocí služby Device Update.

2. Na levé straně stránky vyberte v části Správa zařízení aktualizace.

   

3. V seznamu karet v horní části obrazovky vyberte kartu Aktualizace.

   

4. Vyberte + Importovat novou aktualizaci pod záhlavím Dostupné aktualizace .

   

5. Vyberte + Vybrat z kontejneru úložiště. Zobrazí se uživatelské rozhraní účtů úložiště. Vyberte existující účet nebo vytvořte účet pomocí + Účet úložiště. Tento účet slouží ke zfázování aktualizací pro import kontejneru. Účet by neměl mít současně povolené veřejné i privátní koncové body.

   

6. Jakmile vyberete účet úložiště, zobrazí se uživatelské rozhraní Kontejnery. Vyberte existující kontejner nebo vytvořte kontejner pomocí + Kontejner. Tento kontejner slouží k rozfázování souborů aktualizací pro import.

   Při každém importu aktualizace doporučujeme použít nový kontejner. Vždy používejte nové kontejnery, abyste se vyhnuli náhodnému importu souborů z předchozích aktualizací. Pokud nepoužíváte nový kontejner, nezapomeňte před dokončením tohoto kroku odstranit všechny soubory z existujícího kontejneru.

   

7. V kontejneru vyberte Nahrát. Zobrazí se uživatelské rozhraní pro nahrávání.

   

8. V záhlaví Nahrát objekt blob vyberte ikonu složky na pravé straně oddílu Soubory. Pomocí nástroje pro výběr souborů přejděte do umístění souborů aktualizací a importu manifestu, vyberte všechny soubory a pak vyberte Otevřít. Můžete podržet klávesu Shift a kliknout na vícenásobný výběr souborů.

   

9. Až vyberete všechny soubory aktualizací, vyberte Nahrát.

   

10. Vyberte nahrané soubory a určete je, které se mají importovat. Pak se výběrem tlačítka Vybrat vrátíte na stránku Import update .

    

11. Na stránce Importovat aktualizaci zkontrolujte soubory, které se mají importovat. Potom výběrem možnosti Importovat aktualizaci spusťte proces importu. Pokud chcete vyřešit případné chyby, přečtěte si téma Řešení potíží s aktualizací proxy serveru.

    

12. Proces importu začíná a obrazovka se přepne do oddílu Historie importu. Výběrem možnosti Aktualizovat zobrazíte průběh, dokud se proces importu neskončí (v závislosti na velikosti aktualizace může proces trvat několik minut, ale může trvat déle).

    

13. Když sloupec Stav označuje, že import proběhl úspěšně, vyberte záhlaví Dostupné aktualizace. V seznamu by se teď měla zobrazit importovaná aktualizace.

    

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 tento příkaz automaticky importovat soubory po jejich přípravě. 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, který by měl být připravený.
• --storage-account: Název účtu úložiště, který má aktualizaci provést.
• --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 importovat do služby Device Update po její fázi.

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

Pokud máte více manifestů importu, můžete je zahrnout do jednoho příkazu. 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, včetně předem vyplněných argumentů.

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

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

Pokud místo toho importujete pomocí rozhraní API

Aktualizaci můžete importovat také prostřednictvím kódu programu:

• Použití Azure SDK pro .NET, Java, JavaScript nebo Python
• Použití rozhraní REST API pro aktualizaci importu
• Použití ukázkových modulů PowerShellu
  • Vyžaduje PowerShell 5 nebo novější (včetně instalací Linuxu, macOS a Windows).

Poznámka:

Informace o požadovaných oprávněních rozhraní API najdete v části Role uživatele aktualizace zařízení a přístup .

Aktualizace souborů a manifestu 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

Pokud chcete do kontejneru objektů blob služby Azure Storage nahrát velké soubory aktualizací, můžete pro lepší výkon použít jednu z následujících možností:

• AzCopy
• Azure Storage Explorer

Další kroky

• Vytvoření skupin
• Další informace o konceptech importu