Wdrażanie aktualizacji przy użyciu usługi Device Update dla usługi Azure IoT Hub

Dowiedz się, jak wdrożyć aktualizację na urządzeniu IoT przy użyciu usługi Device Update dla usługi Azure IoT Hub.

Wymagania wstępne

• Dostęp do usługi IoT Hub z włączoną aktualizacją urządzenia dla usługi IoT Hub. Zalecamy użycie warstwy S1 (Standardowa) lub nowszej dla usługi IoT Hub.
• Zaimportowana aktualizacja dla aprowizowanego urządzenia.
• Urządzenie IoT (lub symulator) aprowizowane na potrzeby aktualizacji urządzenia w usłudze IoT Hub.
• Urządzenie jest częścią co najmniej jednej grupy domyślnej lub grupy aktualizacji utworzonej przez użytkownika.

Witryna Azure Portal

Obsługiwane przeglądarki:

• Microsoft Edge
• Google Chrome

Interfejs wiersza polecenia platformy Azure

Środowisko interfejsu wiersza polecenia platformy Azure:

• Użyj środowiska powłoki Bash w usłudze Azure Cloud Shell.

  

• Jeśli wolisz uruchamiać polecenia referencyjne interfejsu wiersza polecenia lokalnie, zainstaluj interfejs wiersza polecenia platformy Azure

  1. Zaloguj się do interfejsu wiersza polecenia platformy Azure przy użyciu polecenia az login .
  2. Uruchom polecenie az version, aby znaleźć zainstalowane wersje i biblioteki zależne. Aby uaktualnić do najnowszej wersji, uruchom polecenie az upgrade.
  3. Po wyświetleniu monitu zainstaluj rozszerzenia interfejsu wiersza polecenia platformy Azure podczas pierwszego użycia. Polecenia w tym artykule używają rozszerzenia azure-iot . Uruchom polecenie az extension update --name azure-iot , aby upewnić się, że używasz najnowszej wersji rozszerzenia.

Napiwek

Polecenia interfejsu wiersza polecenia platformy Azure w tym artykule używają znaku ukośnika \ odwrotnego do kontynuacji wiersza, dzięki czemu argumenty poleceń są łatwiejsze do odczytania. Ta składnia działa w środowiskach powłoki Bash. Jeśli uruchamiasz te polecenia w programie PowerShell, zastąp każdy ukośnik odwrotny tekstem "" lub usuń je całkowicie.

Wdrażanie aktualizacji

Witryna Azure Portal

1. W witrynie Azure Portal przejdź do centrum IoT Hub.

2. Wybierz Aktualizacje z menu nawigacji, aby otworzyć stronę Aktualizacja urządzenia wystąpienia usługi IoT Hub.

   

3. Wybierz kartę Grupy i wdrożenia w górnej części strony. Aby uzyskać więcej informacji, zobacz Grupy urządzeń.

   

4. Wyświetl wykres zgodności aktualizacji i listę grup. Powinna zostać wyświetlona nowa aktualizacja dostępna dla grupy opartej na tagach lub domyślnej. Może być konieczne odświeżenie raz. Aby uzyskać więcej informacji, zobacz Zgodność aktualizacji urządzeń.

5. Wybierz pozycję Wdróż obok jednej lub kilku dostępnych aktualizacji i upewnij się, że etykieta opisowa dodana podczas importowania jest obecna i wygląda poprawnie.

6. Upewnij się, że wybrana jest poprawna grupa jako grupa docelowa i wybierz pozycję Wdróż.

7. Aby rozpocząć wdrażanie, przejdź do karty Bieżące wdrożenie . Wybierz link Wdróż obok żądanej aktualizacji w sekcji Dostępne aktualizacje . Najlepsza dostępna aktualizacja dla danej grupy jest oznaczona wyróżnieniem Najlepsze .

   

8. Zaplanuj rozpoczęcie wdrożenia natychmiast lub w przyszłości.

   Napiwek

   Domyślnie data i godzina rozpoczęcia jest ustawiona na wartość Natychmiast. Pamiętaj, aby wybrać inną datę i godzinę, jeśli chcesz, aby wdrożenie rozpoczęło się później.

   

9. W razie potrzeby utwórz zasady automatycznego wycofywania. Następnie wybierz Utwórz.

10. W szczegółach wdrożenia stan zmieni się na Aktywny. Wdrożona aktualizacja jest oznaczona elementem (wdrażanie).

    

11. Wyświetl wykres zgodności, aby zobaczyć, że aktualizacja jest teraz w toku.

    

12. Po pomyślnym zaktualizowaniu urządzenia zobaczysz, że wykres zgodności i szczegóły wdrożenia zostały zaktualizowane w celu odzwierciedlenia tego samego.

    

Interfejs wiersza polecenia platformy Azure

Aby az iot du device group list sprawdzić najlepszą dostępną aktualizację dla grupy. Polecenie przyjmuje następujące argumenty:

• --account: Nazwa konta usługi Device Update.
• --instance: nazwa wystąpienia usługi Device Update.
• --group-id: identyfikator grupy urządzeń przeznaczony dla tego wdrożenia. Ten identyfikator jest wartością tagu ADUGroup lub $default dla urządzeń bez tagu.
• --best-updates: Ta flaga wskazuje, że polecenie powinno pobrać najlepsze dostępne aktualizacje dla grupy urządzeń, w tym liczbę urządzeń wymagających każdej aktualizacji.
• "--resource-group -g": nazwa grupy zasobów konta aktualizacji urządzenia.
• "--update-compliance": ta flaga wskazuje, że polecenie powinno pobrać informacje o zgodności aktualizacji grupy urządzeń, takie jak liczba urządzeń w najnowszej aktualizacji, ile jest potrzebnych nowych aktualizacji i ile jest w toku podczas odbierania nowej aktualizacji.

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

Użyj polecenia az iot du device deployment create , aby utworzyć wdrożenie dla grupy urządzeń.

Polecenie device deployment create przyjmuje następujące argumenty:

• --account: Nazwa konta usługi Device Update.
• --instance: nazwa wystąpienia usługi Device Update.
• --group-id: identyfikator grupy urządzeń przeznaczony dla tego wdrożenia. Ten identyfikator jest wartością tagu ADUGroup lub $default dla urządzeń bez tagu.
• --deployment-id: identyfikator identyfikujące to wdrożenie.
• --update-name, --update-provideri --update-version: Te trzy parametry definiują obiekt updateId , który jest unikatowym identyfikatorem aktualizacji używanej w tym wdrożeniu.

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>

Opcjonalne argumenty umożliwiają skonfigurowanie wdrożenia. Aby uzyskać pełną listę, zobacz Parametry opcjonalne

Jeśli chcesz utworzyć zasady automatycznego wycofywania, dodaj następujące parametry:

• --failed-count: liczba nieudanych urządzeń we wdrożeniu, które wyzwoli wycofanie.
• --failed-percentage: procent nieudanych urządzeń we wdrożeniu, który wyzwoli wycofanie.
• --rollback-update-name, , --rollback-update-provider--rollback-update-version: identyfikator updateID aktualizacji, która będzie używana przez grupę urządzeń w przypadku zainicjowania wycofywania.

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>

Jeśli chcesz, aby wdrożenie było uruchamiane w przyszłości, użyj parametru --start-time , aby podać docelową datę/godzinę wdrożenia.

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"

Monitorowanie wdrożenia aktualizacji

Witryna Azure Portal

1. Wybierz wdrożoną grupę i przejdź do karty Bieżące aktualizacje lub Historia wdrożenia, aby potwierdzić, że wdrożenie jest w toku

   

2. Wybierz pozycję Szczegóły obok utworzonego wdrożenia. W tym miejscu możesz wyświetlić szczegóły wdrożenia, szczegóły aktualizacji i szczegóły docelowej klasy urządzeń. Opcjonalnie możesz dodać przyjazną nazwę klasy urządzenia.

   

3. Wybierz pozycję Odśwież , aby wyświetlić najnowsze szczegóły stanu.

4. Możesz przejść do widoku podstawowe grupy, aby wyszukać stan określonego urządzenia lub filtrować, aby wyświetlić urządzenia, które zakończyły się niepowodzeniem wdrożenia

Interfejs wiersza polecenia platformy Azure

Użyj polecenia az iot du device deployment list , aby wyświetlić wszystkie wdrożenia dla grupy urządzeń.

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

Użyj polecenia az iot du device deployment show , aby wyświetlić szczegóły określonego wdrożenia.

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>

Dodaj flagę --status , aby zwrócić informacje o tylu urządzeniach w trakcie wdrażania, ukończonych lub zakończonych niepowodzeniem.

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

Ponów próbę wdrożenia aktualizacji

Jeśli wdrożenie zakończy się niepowodzeniem z jakiegoś powodu, możesz ponowić próbę wdrożenia dla urządzeń, które zakończyły się niepowodzeniem.

Witryna Azure Portal

1. Przejdź do karty Bieżące wdrożenie na ekranie Szczegóły grupy.

   

2. Wybierz pozycję Ponów próbę niepowodzenia urządzeń i potwierdź powiadomienie o potwierdzeniu.

Interfejs wiersza polecenia platformy Azure

Użyj polecenia az iot du device deployment retry to retry a deployment for a target subgroup of devices (Ponów próbę wdrożenia dla docelowej podgrupy urządzeń).

To polecenie przyjmuje --class-id argument generowany na podstawie identyfikatora modelu i właściwości zgodności zgłoszonych przez agenta aktualizacji urządzenia.

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>

Następne kroki

Rozwiązywanie typowych problemów