Migrace zařízení a skupin na nejnovější verzi služby Device Update pro IoT Hub

Článek
11/08/2023

Protože služba Device Update for IoT Hub vydává nové verze, budete chtít aktualizovat zařízení o nejnovější funkce a vylepšení zabezpečení. Tento článek obsahuje informace o tom, jak migrovat z verze [Public Preview Refresh(PPR) na aktuální verzi GA. Tento článek také vysvětluje chování skupin a uživatelských rozhraní v těchto verzích. Pokud nemáte zařízení, skupiny a nasazení používající verzi Public Preview Refresh, můžete tuto stránku ignorovat.

Pokud chcete úspěšně provést migraci, budete muset upgradovat agenta DU spuštěného na vašich zařízeních. Mějte na paměti, že vzhledem k velkým změnám ve verzi GA doporučujeme postupovat podle pokynů, abyste se vyhnuli chybám.

Poznámka:

Všechny vytvořené skupiny zařízení PPR se automaticky změní na skupiny GA. Skupiny a zařízení budou po migraci k dispozici. Historie nasazení se nepřenese do aktualizovaných skupin ga.

Aktualizace agenta Device Update

V případě verze GA je možné agenta Aktualizace zařízení aktualizovat ručně nebo pomocí služby Device Update pomocí manifestu apt nebo aktualizací imagí. Pokud používáte aktualizace imagí, můžete do aktualizace zahrnout agenta GA Device Update.

Ruční upgrade agenta DU

Před aktualizací zařízení budou atributy zařízení obsahovat podrobnosti o modelu PPR PnP. Název modelu kontraktu zobrazí model aktualizace zařízení V1 a ID modelu kontraktu zobrazí dtmi:azure:iot:deviceUpdateContractModel; 1.

Připojte se k zařízení s protokolem SSH a aktualizujte agenta Device Update.

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

Ověřte, že agent DU běží správně. Vyhledejte "HealthCheck passed" (Kontrola stavu prošla).
```
sudo -u adu /usr/bin/AducIotAgent -h  
```
Podívejte se na aktualizované zařízení na portálu Device Update. Atributy zařízení teď zobrazí aktualizované podrobnosti modelu PnP. Název modelu kontraktu zobrazí model aktualizace zařízení V2 a ID modelu kontraktu zobrazí dtmi:azure:iot:deviceUpdateContractModel; 2.

Upgrade agenta OTA DU přes manifest APT

Před aktualizací zařízení budou atributy zařízení obsahovat podrobnosti o modelu PPR PnP. Název modelu kontraktu zobrazí model aktualizace zařízení V1 a ID modelu kontraktu zobrazí dtmi:azure:iot:deviceUpdateContractModel; 1.

Přidejte upgrade agenta aktualizace zařízení jako poslední krok v aktualizaci. Aby se zajistilo, že je určená na správná zařízení, musí být verze manifestu importu 4.0 . Níže najdete ukázkový manifest importu a manifest APT:

Příklad manifestu 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"
 }

Příklad manifestu APT

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

Poznámka:

Je nutné, aby upgrade agenta byl posledním krokem. Před upgradem agenta můžete mít další kroky. Všechny kroky přidané po upgradu agenta se nespustí a nahlásí se správně, protože se zařízení znovu připojí ke službě DU.

Nasaďte aktualizaci.
Po úspěšném nasazení aktualizace budou atributy zařízení zobrazovat aktualizované podrobnosti modelu PnP. Název modelu kontraktu zobrazí model aktualizace zařízení V2 a ID modelu kontraktu zobrazí dtmi:azure:iot:deviceUpdateContractModel; 2.

Chování skupin a nasazení napříč verzemi

Zařízení s agentem DU aktualizace Public Preview (0.8.x) a agentem GA DU (1.0.x) je možné spravovat prostřednictvím portálu Device Update.
Do těchto skupin nelze přidat zařízení se staršími agenty (0.7.0/0.6.0).

Další kroky

Principy konfiguračního souboru agenta služby Device Update

Následující kurzy můžete použít k jednoduché ukázce služby Device Update pro IoT Hub:

Sdílet prostřednictvím