Déployer une mise à jour en utilisant Device Update pour Azure IoT Hub

Découvrez comment déployer une mise à jour sur un appareil IoT en utilisant Device Update pour Azure IoT Hub.

Prérequis

• Accéder àun IoT Hub avec Device Update pour IoT Hub activé. Il est recommandé d’utiliser un niveau S1 (Standard) ou supérieur pour votre instance IoT Hub.
• Une mise à jour importée pour l’appareil configuré.
• Un appareil IoT (ou simulateur) provisionné pour Device Update dans IoT Hub.
• L’appareil fait au moins partie d’un groupe par défaut ou d’un groupe de mise à jour créé par l’utilisateur.

Azure portal

Navigateurs pris en charge :

• Microsoft Edge
• Google Chrome

Azure CLI

Environnement Azure CLI :

• Utilisez l’environnement Bash dans Azure Cloud Shell.

  

• Ou, si vous préférez exécuter les commandes de référence CLI localement, installez l’interface Azure CLI

  1. Connectez-vous à l’interface Azure CLI à l’aide de la commande az login.
  2. Exécutez az version pour rechercher la version et les bibliothèques dépendantes installées. Pour effectuer une mise à niveau vers la dernière version, exécutez az upgrade.
  3. Lorsque vous y êtes invité, installez les extensions Azure CLI lors de la première utilisation. Les commandes de cet article utilisent l’extension CLI azure-iot. Exécutez az extension update --name azure-iot pour vous assurer que vous disposez de la version la plus récente de l’extension.

Conseil

Dans cet article, les commandes Azure CLI utilisent la barre oblique inverse \ pour la continuation de ligne afin que les arguments de commande soient plus faciles à lire. Cette syntaxe fonctionne dans les environnements Bash. Si vous exécutez ces commandes dans PowerShell, remplacez chaque barre oblique inverse par un signe inverse « » ou supprimez-les entièrement.

Déployer la mise à jour

Azure portal

1. Accédez à votre IoT Hub dans le portail Azure.

2. Sélectionnez Mises à jour dans le menu de navigation pour ouvrir la page Device Update de votre instance IoT Hub.

   

3. Sélectionnez l’onglet Groupes et déploiements en haut de la page. Pour plus d’informations, consultez : Groupes d’appareils.

   

4. Affichez le graphique de conformité des mises à jour et la liste des groupes. Vous devez afficher une nouvelle mise à jour disponible pour votre groupe par étiquette ou par défaut. Vous devrez peut-être actualiser une fois. Pour plus d’informations, consultez Conformité de la mise à jour des appareils.

5. Sélectionnez Déployer en regard de la ou des mises à jour disponibles, puis vérifiez que l’étiquette descriptive que vous avez ajoutée lors de l’importation est présente et semble correcte.

6. Vérifiez que le groupe approprié est sélectionné comme groupe cible et sélectionnez Déployer.

7. Pour démarrer le déploiement, accédez à l’onglet Déploiement actuel. Sélectionnez le lien Déployer à côté de la mise à jour souhaitée dans la section Mises à jour disponibles. La meilleure mise à jour disponible pour un groupe donné est indiquée par la mention Optimale.

   

8. Planifiez votre déploiement pour qu’il démarre immédiatement ou plus tard.

   Conseil

   Par défaut, la date et l’heure de début sont définies sur Immédiatement. Veillez à sélectionner une autre date et heure si vous souhaitez que le déploiement commence plus tard.

   

9. Créez une stratégie de restauration automatique si nécessaire. Sélectionnez ensuite Créer.

10. Sous les détails du déploiement, État devient Actif. La mise à jour déployée est marquée avec la mention (déploiement en cours).

    

11. Affichez le graphique de conformité pour voir que la mise à jour est maintenant en cours.

    

12. Une fois votre appareil correctement mis à jour, vous voyez que votre graphique de conformité et les détails du déploiement sont mis à jour pour concorder.

    

Azure CLI

az iot du device group list pour vérifier la meilleure mise à jour disponible pour votre groupe. La commande prend les arguments suivants :

• --account : nom du compte Device Update.
• --instance : nom de l’instance Device Update.
• --group-id : ID de groupe d’appareils que vous ciblez avec ce déploiement. Cet ID est la valeur de la balise ADUGroup ou $default pour les appareils sans étiquette.
• --best-updates : Cet indicateur facultatif signale que la commande doit récupérer les meilleures mises à jour disponibles pour le groupe d’appareils, y compris le nombre d’appareils qui ont besoin de chaque mise à jour.
• « --resource-group -g » : Nom du groupe de ressources du compte Device Update.
• « --update-compliance » : Cet indicateur signale que la commande doit récupérer les informations de conformité des mises à jour du groupe d’appareils, comme le nombre d’appareils sur la dernière mise à jour, le nombre d’appareils qui ont besoin de nouvelles mises à jour et le nombre d’appareils en cours de réception d’une nouvelle mise à jour.

az iot du device group list \
    --account <Device Update account name> \
    --instance <Device Update instance name>\
    --gid <device group id>\
    --best-updates {false, true}

Utilisez az iot du device deployment create pour créer un déploiement pour un groupe d’appareils.

La commande device deployment create prend les trois arguments suivants :

• --account : nom du compte Device Update.
• --instance : nom de l’instance Device Update.
• --group-id : ID de groupe d’appareils que vous ciblez avec ce déploiement. Cet ID est la valeur de la balise ADUGroup ou $default pour les appareils sans étiquette.
• --deployment-id : ID permettant d’identifier ce déploiement.
• --update-name, --update-provider et --update-version : ces trois paramètres définissent l’objet updateId qui est un identificateur unique pour la mise à jour que vous utilisez dans ce déploiement.

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>

Les arguments facultatifs vous permettent de configurer le déploiement. Pour obtenir la liste complète, consultez Paramètres facultatifs

Si vous souhaitez créer une stratégie de restauration automatique, ajoutez les paramètres suivants :

• --failed-count : nombre d’appareils ayant échoué dans un déploiement qui déclenchent une restauration.
• --failed-percentage : le pourcentage du nombre d’appareils ayant échoué dans un déploiement qui déclenchent une restauration.
• --rollback-update-name, --rollback-update-provider, --rollback-update-version : updateID de la mise à jour que le groupe d’appareils utilisera si une restauration est lancée.

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>

Si vous souhaitez que le déploiement démarre à l’avenir, utilisez le --start-time paramètre pour fournir la dateheure cible du déploiement.

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"

Superviser le déploiement d’une mise à jour

Azure portal

1. Sélectionnez le groupe sur lequel vous avez déployé, puis accédez à l’onglet Mises à jour actuelles ou Historique des déploiements pour vérifier que le déploiement est en cours

   

2. Sélectionnez Détails à côté du déploiement que vous avez créé. Ici, vous pouvez afficher les détails du déploiement, les détails de la mise à jour et les détails de la classe d’appareil cible. Vous pouvez éventuellement ajouter un nom convivial pour la classe d’appareil.

   

3. Sélectionnez Actualiser pour voir les détails d’état les plus récents.

4. Vous pouvez accéder à la vue de base du groupe pour rechercher l’état d’un appareil particulier ou filtrer pour afficher les appareils qui ont échoué le déploiement

Azure CLI

Utilisez az iot du device deployment list pour afficher tous les déploiements d’un groupe d’appareils.

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

Utilisez az iot du device deployment show pour afficher les détails d’un déploiement particulier.

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>

Ajoutez l’indicateur --status pour retourner des informations sur le nombre d’appareils en cours, terminés ou ayant échoué dans le déploiement.

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

Réessayer le déploiement d’une mise à jour

Si votre déploiement échoue pour une raison quelconque, vous pouvez réessayer le déploiement pour les appareils en échec.

Azure portal

1. Accédez à l’onglet Déploiement actuel dans l’écran des Détails du groupe.

   

2. Sélectionnez Réessayer pour les appareils ayant échoué et accusez réception de la notification de confirmation.

Azure CLI

Utilisez az iot du device deployment retry pour réessayer un déploiement pour un sous-groupe cible d’appareils.

Cette commande prend l’argument --class-id , qui est généré à partir de l’ID de modèle et des propriétés de compatibilité signalées par l’agent de mise à jour de l’appareil.

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>

Étapes suivantes

Résolution des problèmes courants