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

Z tego artykułu dowiesz się, jak wdrożyć aktualizację na urządzeniach IoT przy użyciu usługi Azure Device Update for IoT Hub w witrynie Azure Portal lub za pomocą interfejsu wiersza polecenia platformy Azure.

Wymagania wstępne

• Standardowe (S1) lub wyższe wystąpienie usługi Azure IoT Hub z włączoną aktualizacją urządzenia dla usługi IoT Hub.
• Urządzenie IoT lub symulator aprowizowany na potrzeby aktualizacji urządzenia w centrum IoT. Aprowizowane urządzenie może być członkiem grupy urządzeń utworzonej przez użytkownika lub grupy domyślnej.
• Zaimportowana aktualizacja dla aprowizowanego urządzenia.

Wdrażanie aktualizacji

W tej sekcji opisano sposób wdrażania aktualizacji przy użyciu witryny Azure Portal lub interfejsu wiersza polecenia platformy Azure.

Witryna Azure Portal

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

2. Wybierz pozycję Aktualizacje w obszarze Zarządzanie urządzeniami w obszarze nawigacji po lewej stronie.

   

3. Na stronie Aktualizacje wybierz kartę Grupy i wdrożenia, a następnie wyświetl wykres zgodności aktualizacji i listę grup urządzeń. Może być konieczne odświeżenie widoku, aby wyświetlić ostatnio zaimportowane aktualizacje dostępne dla grupy urządzeń.

4. W obszarze Stan na liście grup wybierz pozycję Wdróż obok jednej lub kilku nowych aktualizacji jest dostępnych dla tej grupy.

   

5. 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ń.

6. Wybierz pozycję Wdróż obok co najmniej jednego dostępnego stanu aktualizacji.

7. Z listy po prawej stronie wybierz żądaną aktualizację do wdrożenia.

   

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

   Napiwek

   Domyślnie data i godzina rozpoczęcia to 24 godziny od bieżącej godziny. Pamiętaj, aby wybrać inną datę i godzinę, jeśli chcesz, aby wdrożenie rozpoczęło się wcześniej lub później.

   

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

10. Na karcie Bieżące aktualizacje możesz wyświetlić stan wdrożenia.

    

11. W widoku Podstawowe informacje o grupie wykres zgodności pokazuje, że aktualizacja jest teraz w toku.

    Po pomyślnym zaktualizowaniu urządzenia wykres zgodności i szczegóły wdrożenia zostaną zaktualizowane, aby odzwierciedlić ten stan.

Interfejs wiersza polecenia platformy Azure

Aby uruchomić następujące polecenia, możesz użyć środowiska powłoki Bash w usłudze Azure Cloud Shell . 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 interfejs wiersza polecenia platformy Azure. 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. azure-iot Zainstaluj rozszerzenie po wyświetleniu monitu o pierwsze użycie. Aby upewnić się, że używasz najnowszej wersji rozszerzenia, uruchom polecenie az extension update --name azure-iot.

Napiwek

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

Weryfikowanie dostępności aktualizacji

1. Użyj polecenia , az iot du device group list aby zidentyfikować grupę urządzeń.

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

2. Następnie użyj polecenia az iot du device group show , aby wyświetlić 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, który jest wartością tagu ADUGroup lub $default dla urządzeń bez tagu.
   • --resource-group: nazwa grupy zasobów konta usługi Device Update.
   • --best-updates: zwraca najlepsze dostępne aktualizacje dla grupy urządzeń, w tym liczbę urządzeń wymagających każdej aktualizacji.
   • --update-compliance: zwraca informacje o zgodności aktualizacji grupy urządzeń, takie jak liczba urządzeń w najnowszej aktualizacji, liczba nowych aktualizacji i liczba aktualnie otrzymywanych nowych aktualizacji.

   Aby sprawdzić najlepszą dostępną aktualizację dla grupy, uruchom polecenie w następujący sposób:

   az iot du device group show \
       --account <Device Update account name> \
       --instance <Device Update instance name>\
       --group-id <device group ID>\
       --best-updates
   

Tworzenie wdrożenia

Użyj az iot du device deployment create polecenia , aby utworzyć wdrożenie dla grupy urządzeń. 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, który 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: Parametry definiujące updateId obiekt, unikatowy identyfikator aktualizacji w tym wdrożeniu.

Uruchom polecenie w następujący sposób:

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>

Używanie opcjonalnych argumentów

Opcjonalne argumenty umożliwiają dalsze konfigurowanie wdrożenia. Aby uzyskać pełną listę argumentów opcjonalnych, zobacz Parametry opcjonalne.

Aby utworzyć zasady automatycznego wycofywania, dodaj następujące parametry:

• --failed-count: liczba nieudanych urządzeń we wdrożeniu, które wyzwala wycofanie.
• --failed-percentage: procent nieudanych urządzeń we wdrożeniu, który wyzwala wycofanie.
• --rollback-update-name, , --rollback-update-provider--rollback-update-version: parametry aktualizacji do użycia, jeśli zainicjowano wycofanie.

Uruchom polecenie w następujący sposób:

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>

Aby ustawić godzinę rozpoczęcia wdrożenia, użyj parametru --start-time , aby podać docelową datę i godzinę wdrożenia w następujący sposób:

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 stanu wdrożenia

Witryna Azure Portal

1. Na karcie Grupy i wdrożenia na stronie Aktualizacje wybierz grupę, do której wdrożono.

2. Na stronie Szczegóły grupy przejdź do karty Bieżące wdrożenie lub Historia wdrożenia, aby potwierdzić, że wdrożenie jest w toku.

   

3. Wybierz pozycję Szczegóły obok wdrożenia, aby 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.

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

   

Przejdź do karty Podstawy grupy na stronie Szczegóły 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, 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>

Powiązana zawartość

• Wdrożenia aktualizacji urządzeń
• Przewodnik rozwiązywania problemów z aktualizacją urządzenia