Aprowizowanie agenta usługi Device Update

  • Artykuł

Agent modułu aktualizacji urządzeń może działać razem z innymi procesami systemowymi i modułami usługi IoT Edge, które łączą się z usługą IoT Hub w ramach tego samego urządzenia logicznego. W tej sekcji opisano sposób aprowizowania agenta usługi Device Update jako tożsamości modułu.

Zmiany agenta usługi Device Update w wersji ogólnie dostępnej

Jeśli używasz wersji agenta usługi Device Update, przeprowadź migrację do najnowszej wersji agenta w wersji 1.0.0, która jest ogólnie dostępna. Zobacz agent ga, aby uzyskać informacje o zmianach i sposobie uaktualniania

Możesz sprawdzić zainstalowaną wersję agenta aktualizacji urządzeń i agenta optymalizacji dostarczania w sekcji Właściwości urządzenia bliźniaczej reprezentacji urządzenia IoT. Dowiedz się więcej o właściwościach urządzenia w ramach interfejsu podstawowego usługi ADU.

Tożsamość modułu a tożsamość urządzenia

W usłudze IoT Hub w ramach każdej tożsamości urządzenia można utworzyć maksymalnie 50 tożsamości modułów. Każda tożsamość modułu niejawnie generuje bliźniacze reprezentacje modułu. Po stronie urządzenia zestawy SDK urządzeń usługi IoT Hub umożliwiają tworzenie modułów, w których każde z nich otwiera niezależne połączenie z usługą IoT Hub. Tożsamość modułu i bliźniacza reprezentacja modułu zapewniają podobne możliwości jak tożsamość urządzenia i bliźniacza reprezentacja urządzenia, ale w bardziej szczegółowym poziomie. Dowiedz się więcej o tożsamościach modułów w usłudze IoT Hub

Jeśli przeprowadzasz migrację z agenta na poziomie urządzenia do dodawania agenta jako tożsamości modułu na urządzeniu, usuń starszego agenta, który komunikował się za pośrednictwem bliźniaczej reprezentacji urządzenia. Gdy aprowizujesz agenta usługi Device Update jako tożsamość modułu, cała komunikacja między urządzeniem a usługą Device Update odbywa się za pośrednictwem bliźniaczej reprezentacji modułu, dlatego pamiętaj, aby oznaczyć bliźniacze reprezentację modułu podczas tworzenia grup i cała komunikacja musi odbywać się za pośrednictwem bliźniaczej reprezentacji modułu.

Obsługa aktualizacji urządzenia

Następujące urządzenie IoT za pośrednictwem typów aktualizacji powietrza jest obecnie obsługiwane w usłudze Device Update:

Wymagania wstępne

Jeśli konfigurujesz urządzenie IoT/urządzenie usługi IoT Edge pod kątem aktualizacji opartych na pakietach, dodaj packages.microsoft.com do repozytoriów maszyny, wykonując następujące kroki:

  1. Zaloguj się na maszynie lub urządzeniu IoT, na którym zamierzasz zainstalować agenta usługi Device Update.

  2. Otwórz okno terminalu.

  3. Zainstaluj konfigurację repozytorium zgodną z systemem operacyjnym urządzenia.

    curl https://packages.microsoft.com/config/ubuntu/18.04/multiarch/prod.list > ./microsoft-prod.list

  4. Skopiuj wygenerowaną listę do katalogu sources.list.d.

    sudo cp ./microsoft-prod.list /etc/apt/sources.list.d/

  5. Zainstaluj klucz publiczny GG firmy Microsoft.

    curl https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.gpg

    sudo cp ./microsoft.gpg /etc/apt/trusted.gpg.d/

Jak aprowizować agenta usługi Device Update jako tożsamość modułu

W tej sekcji opisano sposób aprowizowania agenta usługi Device Update jako tożsamości modułu

  • Urządzenia z włączoną usługą IoT Edge lub
  • Urządzenia IoT innych niż Edge lub
  • Inne urządzenia IoT.

Aby sprawdzić, czy na urządzeniu jest włączona usługa IoT Edge, zapoznaj się z instrukcjami instalacji usługi IoT Edge.

Postępuj zgodnie z wszystkimi lub dowolnym z poniższych sekcji, aby dodać agenta aktualizacji urządzeń na podstawie typu urządzenia IoT, którym zarządzasz.

Na urządzeniach z włączoną usługą IoT Edge

Postępuj zgodnie z tymi instrukcjami, aby aprowizować agenta aktualizacji urządzeń na urządzeniach z włączoną usługą IoT Edge.

  1. Postępuj zgodnie z instrukcjami, aby ręcznie aprowizować pojedyncze urządzenie usługi IoT Edge z systemem Linux.

  2. Zainstaluj agenta aktualizacji obrazu usługi Device Update.

    Udostępniamy przykładowe obrazy w repozytorium Assets tutaj . Plik swUpdate to obraz podstawowy, który można migać na płytę Raspberry Pi B3+. Plik .gz to aktualizacja, którą można zaimportować za pośrednictwem usługi Device Update dla usługi IoT Hub. Przykład można znaleźć w temacie How to flash the image to your IoT Hub device (Jak migać obraz do urządzenia usługi IoT Hub).

  3. Zainstaluj agenta aktualizacji pakietu device Update.

    • W przypadku najnowszych wersji agentów z packages.microsoft.com: Aktualizowanie list pakietów na urządzeniu i instalowanie pakietu agenta usługi Device Update oraz jego zależności przy użyciu:

      sudo apt-get update

      sudo apt-get install deviceupdate-agent

    • W przypadku wszystkich wersji "rc" tzn. wersji agenta kandydata do wydania z obszaru Artifacts : pobierz plik .deb na maszynę, na której chcesz zainstalować agenta usługi Device Update, a następnie:

      sudo apt-get install -y ./"<PATH TO FILE>"/"<.DEB FILE NAME>"

    • Jeśli konfigurujesz mcC dla scenariusza odłączonego urządzenia, zainstaluj wtyczkę APT optymalizacji dostarczania:

      sudo apt-get install deliveryoptimization-plugin-apt

  4. Po zainstalowaniu agenta aktualizacji urządzenia należy edytować plik konfiguracji aktualizacji urządzenia, uruchamiając poniższe polecenie.

    sudo nano /etc/adu/du-config.json

    Zmień parametr connectionType na "AIS" dla agentów, którzy będą używać usługi tożsamości IoT na potrzeby aprowizacji. Pole Połączenie ionData musi być pustym ciągiem. Należy pamiętać, że należy ustawić wszystkie wartości z tagiem "Umieść tutaj". Zobacz Konfigurowanie agenta DU.

  5. Teraz możesz uruchomić agenta usługi Device Update na urządzeniu IoT.

Na urządzeniach z systemem Linux iot bez zainstalowanej usługi IoT Edge

Postępuj zgodnie z tymi instrukcjami, aby aprowizować agenta usługi Device Update na urządzeniach z systemem IoT z systemem Linux.

  1. Zainstaluj usługę IoT Identity Service i dodaj najnowszą wersję do urządzenia IoT, postępując zgodnie z instrukcjami w temacie Instalowanie usługi azure IoT Identity Service.

  2. Skonfiguruj usługę tożsamości IoT, postępując zgodnie z instrukcjami w temacie Konfigurowanie usługi azure IoT Identity Service.

  3. Na koniec zainstaluj agenta usługi Device Update. W tym miejscu udostępniamy przykładowe obrazy w obszarze Assets. Plik swUpdate jest obrazem podstawowym, który można migać na płytę Raspberry Pi B3+, a plik .gz to aktualizacja, którą można zaimportować za pomocą usługi Device Update dla usługi IoT Hub. Zobacz przykładowy sposób flashowania obrazu na urządzeniu usługi IoT Hub.

  4. Po zainstalowaniu agenta aktualizacji urządzenia należy edytować plik konfiguracji aktualizacji urządzenia, uruchamiając poniższe polecenie.

    sudo nano /etc/adu/du-config.json

    Zmień parametr connectionType na "AIS" dla agentów, którzy będą używać usługi tożsamości IoT na potrzeby aprowizacji. Pole Połączenie ionData musi być pustym ciągiem. Należy pamiętać, że należy ustawić wszystkie wartości z tagiem "Umieść tutaj". Zobacz Konfigurowanie agenta DU.

  5. Teraz możesz uruchomić agenta usługi Device Update na urządzeniu IoT.

Inne urządzenia IoT

Agent usługi Device Update można również skonfigurować bez usługi tożsamości IoT na potrzeby testowania lub na ograniczonych urządzeniach. Wykonaj poniższe kroki, aby aprowizować agenta usługi Device Update przy użyciu parametry połączenia (z modułu lub urządzenia).

  1. Udostępniamy przykładowe obrazy w repozytorium Assets tutaj . Plik swUpdate to obraz podstawowy, który można migać na płytę Raspberry Pi B3+. Plik .gz to aktualizacja, którą można zaimportować za pośrednictwem usługi Device Update dla usługi IoT Hub. Przykład można znaleźć w temacie How to flash the image to your IoT Hub device (Jak migać obraz do urządzenia usługi IoT Hub).

  2. Zaloguj się na maszynie lub urządzeniu usługi IoT Edge/urządzeniu IoT.

  3. Otwórz okno terminalu.

  4. Dodaj parametry połączenia do pliku konfiguracji usługi Device Update:

    1. Wprowadź poniższe polecenie w oknie terminalu:

    2. Kopiowanie parametry połączenia podstawowej

      • Jeśli agent usługi Device Update jest skonfigurowany jako moduł, skopiuj podstawowe parametry połączenia modułu.
      • W przeciwnym razie skopiuj podstawowe parametry połączenia urządzenia.

    3. Wprowadź skopiowaną parametry połączenia podstawową do wartości pola "connectionData" w pliku du-config.json. Należy pamiętać, że należy ustawić wszystkie wartości z tagiem "Umieść tutaj". Zobacz Konfigurowanie agenta DU

  5. Teraz możesz przystąpić do uruchamiania agenta usługi Device Update na urządzeniu IoT.

Jak uruchomić agenta usługi Device Update

W tej sekcji opisano sposób uruchamiania i weryfikowania agenta usługi Device Update jako tożsamości modułu uruchomionej pomyślnie na urządzeniu IoT.

  1. Zaloguj się do maszyny lub urządzenia, na którym jest zainstalowany agent usługi Device Update.

  2. Otwórz okno terminalu i wprowadź poniższe polecenie.

    sudo systemctl restart deviceupdate-agent

  3. Stan agenta można sprawdzić przy użyciu poniższego polecenia. Jeśli widzisz jakiekolwiek problemy, zapoznaj się z tym przewodnikiem rozwiązywania problemów.

    sudo systemctl status deviceupdate-agent

    Powinien zostać wyświetlony stan OK.

  4. W portalu usługi IoT Hub przejdź do pozycji Urządzenie IoT lub urządzenia usługi IoT Edge, aby znaleźć urządzenie skonfigurowane za pomocą agenta usługi Device Update. W tym miejscu zobaczysz agenta usługi Device Update uruchomionego jako moduł. Na przykład:

    Diagram nazwy modułu Device Update.

Jak skompilować i uruchomić agenta usługi Device Update

Możesz również skompilować i zmodyfikować własnego agenta usługi Device Update klienta. Postępuj zgodnie z instrukcjami, aby skompilować agenta aktualizacji urządzenia ze źródła.

Po pomyślnym utworzeniu agenta należy uruchomić agenta. Teraz wprowadź zmiany wymagane do uwzględnienia agenta na obrazie. Aby uzyskać wskazówki, zobacz, jak zmodyfikować agenta aktualizacji urządzeń.

Przewodnik po rozwiązywaniu problemów

Jeśli wystąpią problemy, zapoznaj się z artykułem Device Update for IoT Hub Troubleshooting Guide (Przewodnik rozwiązywania problemów z usługą Device Update for IoT Hub), aby ułatwić odblokowanie wszelkich możliwych problemów i zebranie niezbędnych informacji w celu udostępnienia firmie Microsoft.

Następne kroki

Poniższe samouczki umożliwiają prosty pokaz aktualizacji urządzenia dla usługi IoT Hub: