Migrowanie urządzeń i grup do najnowszej aktualizacji urządzenia dla usługi IoT Hub

Artykuł
11/08/2023

W miarę jak usługa Device Update for IoT Hub udostępnia nowe wersje, należy zaktualizować urządzenia pod kątem najnowszych funkcji i ulepszeń zabezpieczeń. Ten artykuł zawiera informacje o sposobie migracji z wersji zapoznawczej [Public Preview Refresh(PPR) do bieżącej wersji ogólnie dostępnej. W tym artykule wyjaśniono również zachowanie grupy i środowiska użytkownika w tych wersjach. Jeśli nie masz urządzeń, grup i wdrożeń korzystających z wersji Odświeżanie publicznej wersji zapoznawczej, możesz zignorować tę stronę.

Aby pomyślnie przeprowadzić migrację, należy uaktualnić agenta DU uruchomionego na urządzeniach. Należy pamiętać, że w miarę wprowadzania istotnych zmian w wersji ogólnie dostępnej zalecamy ścisłe przestrzeganie instrukcji, aby uniknąć błędów.

Uwaga

Wszystkie utworzone grupy urządzeń PPR zostaną automatycznie zmienione na grupy ogólnie dostępne. Grupy i urządzenia będą dostępne po migracji. Historia wdrażania nie zostanie przeniosła do zaktualizowanych grup ogólnie dostępnej.

Aktualizowanie agenta usługi Device Update

W przypadku wersji ogólnie dostępnej agent aktualizacji urządzeń można zaktualizować ręcznie lub za pomocą usługi Device Update Service przy użyciu aktualizacji manifestu apt lub obrazu. Jeśli używasz aktualizacji obrazów, możesz uwzględnić agenta aktualizacji urządzeń ogólnodostępnych w aktualizacji.

Ręczne uaktualnianie agenta DU

Przed zaktualizowaniem urządzenia atrybuty urządzenia będą zawierać szczegóły modelu PPR PnP. Nazwa modelu kontraktu będzie zawierać identyfikator modelu aktualizacji urządzenia w wersji 1 i identyfikator modelu kontraktu będzie zawierać wartości dtmi:azure:iot:deviceUpdateContractModel; 1.

Za pomocą protokołu SSH na urządzeniu zaktualizuj agenta usługi Device Update.

sudo apt install deviceupdate-agent
sudo systemctl restart deviceupdate-agent
sudo systemctl status deviceupdate-agent

Upewnij się, że agent DU działa poprawnie. Wyszukaj hasło "HealthCheck passed"
```
sudo -u adu /usr/bin/AducIotAgent -h  
```
Zobacz zaktualizowane urządzenie w portalu usługi Device Update. Atrybuty urządzenia będą teraz wyświetlać zaktualizowane szczegóły modelu PnP. Nazwa modelu kontraktu będzie zawierać identyfikator modelu aktualizacji urządzeń w wersji 2 i identyfikator modelu kontraktu będzie zawierać wartości dtmi:azure:iot:deviceUpdateContractModel; 2.

Uaktualnianie agenta OTA DU za pomocą manifestu APT

Przed zaktualizowaniem urządzeń atrybuty urządzenia będą zawierać szczegóły modelu PPR PnP. Nazwa modelu kontraktu będzie zawierać identyfikator modelu aktualizacji urządzenia w wersji 1 i identyfikator modelu kontraktu będzie zawierać wartości dtmi:azure:iot:deviceUpdateContractModel; 1.

Dodaj uaktualnienie agenta aktualizacji urządzenia jako ostatni krok aktualizacji. Wersja manifestu importu musi mieć wartość "4.0" , aby upewnić się, że jest ona przeznaczona dla odpowiednich urządzeń. Poniżej przedstawiono przykładowy manifest importu i manifest APT:

Przykładowy manifest importu

{
   "manifestVersion": "4",
   "updateId": {
     "provider": "Contoso",
     "name": "Sensor",
     "version": "1.0"
   },
   "compatibility": [
     {
       "manufacturer": "Contoso",
       "model": "Sensor"
     }
   ],
   "instructions": {
     "steps": [
       {
     "handler": "microsoft/apt:1",
     "handlerProperties": {
       "installedCriteria": "1.0"
     },
     "files": [
       "fileId0"
     ]
       }
     ]
   },
   "files": {
     "fileId0": {
       "filename": "sample-upgrade-apt-manifest.json",
       "sizeInBytes": 210,
       "hashes": {
     "sha256": "mcB5SexMU4JOOzqmlJqKbue9qMskWY3EI/iVjJxCtAs="
       }
     }
   },
   "createdDateTime": "2022-08-20T18:32:01.8404544Z"
 }

Przykładowy manifest APT

  {
    "name": "Sample DU agent upgrade update",
    "version": "1.0.0",
    "packages": [
    {
        "name": "deviceupdate-agent"
    }
    ]
}

Uwaga

Wymagane jest, aby uaktualnienie agenta było ostatnim krokiem. Przed uaktualnieniem agenta mogą wystąpić inne kroki. Wszelkie kroki dodane po uaktualnieniu agenta nie zostaną wykonane i zgłoszone poprawnie, ponieważ urządzenie ponownie łączy się z usługą DU.

Wdróż aktualizację.
Po pomyślnym wdrożeniu aktualizacji atrybuty urządzenia będą teraz wyświetlać zaktualizowane szczegóły modelu PnP. Nazwa modelu kontraktu będzie zawierać identyfikator modelu aktualizacji urządzeń w wersji 2 i identyfikator modelu kontraktu będzie zawierać wartości dtmi:azure:iot:deviceUpdateContractModel; 2.

Zachowanie grupowania i wdrażania w różnych wersjach

Urządzenie z agentem du odświeżania publicznej wersji zapoznawczej (0.8.x) i agentem GA DU (1.0.x) można zarządzać za pośrednictwem portalu usługi Device Update.
Nie można dodać urządzeń ze starszymi agentami (0.7.0/0.6.0) do tych grup.

Następne kroki

Opis pliku konfiguracji agenta usługi Device Update

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

Udostępnij za pośrednictwem