Migrer les appareils et les groupes vers la dernière version de Device Update pour IoT Hub

  • Article

Quand le service Device Update pour IoT Hub publie de nouvelles versions, vous pouvez mettre à jour vos appareils pour obtenir les dernières fonctionnalités et améliorations de la sécurité. Cet article fournit des informations sur la migration de la [version actualisée de la préversion publique (PPR, Public Preview Refresh)] vers la version en disponibilité générale (GA) actuelle. Il explique également le comportement des groupes et de l’expérience utilisateur sur ces différentes versions. Si aucun de vos appareils, groupes et déploiements n’utilise la version PPR, vous pouvez ignorer cette page.

Pour réussir la migration, vous devez mettre à niveau l’agent DU exécuté sur vos appareils. Dans la mesure où la version GA inclut des modifications majeures, nous vous recommandons de suivre attentivement les instructions pour éviter les erreurs.

Notes

Tous les groupes d’appareils PPR existants seront automatiquement convertis en groupes GA. Les groupes et les appareils seront disponibles après la migration. L’historique des déploiements ne sera pas transféré aux groupes GA mis à jour.

Mettre à jour l’agent Device Update

Pour la version GA, l’agent Device Update peut être mis à jour manuellement, ou à l’aide du service Device Update en utilisant les mises à jour d’image ou le manifeste APT. Si vous utilisez les mises à jour d’image, vous pouvez inclure la version GA de l’agent Device Update dans votre mise à jour.

Mise à niveau manuelle de l’agent Device Update

  1. Avant la mise à jour de votre appareil, les attributs de l’appareil incluent les détails du modèle PnP de la version PPR. Le nom du modèle de contrat est Device Update Model V1 et l’ID de modèle de contrat est dtmi:azure:iot:deviceUpdateContractModel;1.

  2. Connectez-vous avec SSH à votre appareil et mettez à jour l’agent Device Update.

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

  3. Vérifiez que l’agent Device Update fonctionne correctement. Recherchez le message « HealthCheck réussi »

    sudo -u adu /usr/bin/AducIotAgent -h

  4. Examinez l’appareil mis à jour dans le portail Device Update. Les attributs de l’appareil présentent maintenant les détails du modèle PnP mis à jour. Le nom du modèle de contrat est Device Update Model V2 et l’ID de modèle de contrat est dtmi:azure:iot:deviceUpdateContractModel;2.

Mise à niveau OTA de l’agent Device Update avec le manifeste APT

  1. Avant la mise à jour de vos appareils, les attributs des appareils incluent les détails du modèle PnP de la version PPR. Le nom du modèle de contrat est Device Update Model V1 et l’ID de modèle de contrat est dtmi:azure:iot:deviceUpdateContractModel;1.

  2. Ajoutez la mise à niveau de l’agent Device Update comme dernière étape de votre mise à jour. La version du manifeste d’importation doit être 4.0 pour pouvoir cibler les appareils appropriés. Consultez ci-dessous un exemple de manifeste d’importation et un exemple de manifeste APT :

    Exemple de manifeste d’importation

    {
   "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"
 }

    Exemple de manifeste APT

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

Notes

La mise à niveau de l’agent doit impérativement être la dernière étape du processus. Il peut y avoir d’autres étapes avant la mise à niveau de l’agent. Si des étapes sont ajoutées après la mise à niveau de l’agent, elles ne seront pas exécutées et journalisées correctement au moment où l’appareil se reconnectera au service Device Update.

  1. Déployez la mise à jour.

  2. Une fois la mise à jour correctement déployée, les attributs de l’appareil présentent les détails du modèle PnP mis à jour. Le nom du modèle de contrat est Device Update Model V2 et l’ID de modèle de contrat est dtmi:azure:iot:deviceUpdateContractModel;2.

Comportement des groupes et des déploiements sur les différentes versions

  • L’appareil avec l’agent Device Update version PPR (0.8.x) et avec l’agent version GA (1.0.x) peut être géré via le portail Device Update.

  • Vous ne pouvez pas jouter d’appareils avec des agents plus anciens (0.7.0/0.6.0) à ces groupes.

Étapes suivantes

Comprendre le fichier de configuration de l’Agent de mise à jour des appareils

Vous pouvez utiliser les tutoriels suivants pour une démonstration simple de Device Update pour IoT Hub :