Importowanie aktualizacji do usługi Azure Device Update dla usługi IoT Hub

• Obsługiwane przeglądarki Microsoft Edge lub Google Chrome.

• Środowisko powłoki Bash.

  Możesz użyć środowiska Bash w usłudze Azure Cloud Shell do uruchamiania poleceń opisanych w tym artykule. Wybierz pozycję Uruchom usługę Cloud Shell, aby otworzyć usługę Cloud Shell , lub wybierz ikonę usługi Cloud Shell na górnym pasku narzędzi witryny Azure Portal.

  

  Jeśli wolisz, możesz uruchamiać polecenia interfejsu wiersza polecenia platformy Azure lokalnie:

  1. Zainstaluj Azure CLI. Uruchom polecenie az version , aby wyświetlić zainstalowaną wersję interfejsu wiersza polecenia platformy Azure i biblioteki zależne, a następnie uruchom polecenie az upgrade , aby zainstalować najnowszą wersję.
  2. Zaloguj się na platformie Azure, uruchamiając polecenie az login.
  3. Zainstaluj rozszerzenie azure-iot przy pierwszym użyciu, gdy pojawi się monit. Aby upewnić się, że używasz najnowszej wersji rozszerzenia, uruchom polecenie az extension update --name azure-iot.

1. W portalu Azure na stronie centrum IoT dla wystąpienia usługi Device Update wybierz w lewym okienku nawigacji pozycje Zarządzanie urządzeniami>Aktualizacje.

   

2. Na stronie Aktualizacje wybierz pozycję Importuj nową aktualizację.

   

3. Na stronie Importowanie aktualizacji wybierz pozycję Wybierz z kontenera magazynu.

4. Na stronie Konta magazynu wybierz istniejące konto magazynu lub utwórz nowe, wybierając opcję Konto magazynu. Konto magazynu danych dla kontenera służy do tymczasowego przechowywania plików aktualizacji.

5. Na stronie Kontenery wybierz istniejący kontener lub utwórz nowy kontener, wybierając pozycję Kontener. Kontener służy do przygotowania plików aktualizacji do importowania.

   

   Wskazówka

   Użycie nowego kontenera za każdym razem, gdy importujesz aktualizację, pomaga zapobiec przypadkowemu zaimportowaniu plików z poprzednich aktualizacji. Jeśli nie używasz nowego kontenera, usuń wszystkie poprzednie pliki z istniejącego kontenera.

6. Na stronie kontenera wybierz pozycję Przekaż.

   

7. Na ekranie Przekazywanie obiektu blob wybierz ikonę folderu obok pola Pliki. Użyj selektora plików, aby przejść do lokalizacji aktualizacji i zaimportować pliki manifestu, wybrać pliki, a następnie wybrać pozycję Otwórz. Możesz użyć Shift, aby wybrać wiele plików.

   

8. Po wybraniu wszystkich plików wybierz pozycję Przekaż.

   

9. Po ich przesłaniu pliki pojawiają się na stronie kontenera. Na stronie kontenera przejrzyj i wybierz pliki do zaimportowania, a następnie wybierz pozycję Wybierz.

   

10. Na ekranie Importowanie aktualizacji wybierz pozycję Importuj aktualizację.

    

Rozpoczyna się proces importowania, a ekran przechodzi do ekranu Aktualizacje . Po pomyślnym zakończeniu importowania zostanie wyświetlony na karcie Aktualizacje . Aby rozwiązać problemy z błędami, zobacz Rozwiązywanie problemów z aktualizacją serwera proxy.

Polecenie az iot du update stage obsługuje wstępne etapy importu aktualizacji, w tym przesyłanie plików aktualizacji do docelowego kontenera magazynu. Opcjonalna flaga umożliwia również automatyczne importowanie plików po ich przygotowaniu. W przeciwnym razie proces zostanie zakończony za pomocą polecenia az iot du update import.

Polecenie stage przyjmuje następujące argumenty:

• --account: Nazwa konta usługi Device Update.
• --instance: Nazwa instancji usługi Device Update.
• --manifest-path: ścieżka pliku do manifestu importu do etapu.
• --storage-account: Nazwa konta magazynu danych, na którym ma zostać przygotowana aktualizacja.
• --storage-container: Nazwa kontenera w obrębie wybranego konta magazynu, przeznaczonego do przygotowania aktualizacji.
• --overwrite: Flaga opcjonalna wskazująca, czy nadpisać istniejące obiekty blob w kontenerze magazynu danych, jeśli wystąpi konflikt.
• --then-import: opcjonalna flaga wskazująca, czy należy zaimportować aktualizację do usługi Device Update po jej przejściu.

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

Na przykład:

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

W jednym poleceniu można uwzględnić wiele manifestów importu. Na przykład:

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

Jeśli nie używasz flagi --then-import, dane wyjściowe polecenia stage zawierają monit o uruchomienie az iot du update import z góry wypełnionymi argumentami.

Użyj polecenia az iot du update list, aby sprawdzić, czy aktualizacje zostały pomyślnie zaimportowane.

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