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

Dans cet article, vous allez apprendre à déployer une mise à jour sur des appareils IoT en utilisant Azure Device Update pour IoT Hub dans le Portail Azure ou avec Azure CLI.

Prérequis

• Instance Standard (S1) ou supérieure d’Azure IoT Hub avec Device Update pour IoT Hub activé.
• Un dispositif IoT ou un simulateur approvisionné pour la mise à jour des appareils au sein du hub IoT. L’appareil approvisionné peut être membre d’un groupe d’appareils créé par l’utilisateur ou du groupe par défaut.
• Une mise à jour importée pour l’appareil configuré.

Déployer la mise à jour

Cette section décrit comment déployer la mise à jour en utilisant le Portail Azure ou Azure CLI.

Azure portal

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

2. Dans le volet de navigation de gauche, sous Gestion des appareils, sélectionnez Mises à jour.

   

3. Dans la page Mises à jour, sélectionnez l’onglet Groupes et déploiements et affichez le graphique de conformité des mises à jour et la liste des groupes d’appareils. Vous devrez peut-être actualiser l’affichage pour voir les mises à jour récemment importées à la disposition de votre groupe d’appareils.

4. Dans la liste des groupes, sous État, sélectionnez Déployer en regard de Une ou plusieurs nouvelles mises à jour sont disponibles pour ce groupe.

   

5. 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.

6. Sélectionnez Déployer en regard de l’état Une ou plusieurs mises à jour disponibles.

7. Dans la liste de droite, sélectionnez la mise à jour que vous souhaitez déployer.

   

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 est définie sur 24 heures à partir de votre heure actuelle. Veillez à sélectionner une date et une heure différentes si vous souhaitez que le déploiement commence plus tôt ou plus tard.

   

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

10. Sous l’onglet Mises à jour actuelles, vous pouvez afficher l’état de votre déploiement.

    

11. Dans l’affichage Informations de base du groupe, le graphique de conformité indique que la mise à jour est en cours.

    Une fois l’appareil correctement mis à jour, les détails du déploiement et du graphique de conformité se mettent à jour pour refléter cet état.

Azure CLI

Vous pouvez utiliser l’environnement Bash dans Azure Cloud Shell pour exécuter les commandes suivantes. Sélectionnez Lancer Cloud Shell pour ouvrir Cloud Shell, ou sélectionnez l’icône Cloud Shell dans la barre d’outils supérieure du portail Azure.

Ou si vous préférez, vous pouvez exécuter les commandes Azure CLI localement :

1. Installez l’interface de ligne de commande Azure. Exécutez version az pour afficher la version d’Azure CLI installée et les bibliothèques dépendantes, puis exécutez az upgrade pour installer la dernière version.
2. Connectez-vous à Azure en exécutant az login.
3. Installez l’extension azure-iot lorsque vous y êtes invité lors de la première utilisation. Pour vous assurer que vous utilisez la dernière version de l’extension, exécutez az extension update --name azure-iot.

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.

Vérifier la disponibilité des mises à jour

1. Utilisez la commande az iot du device group list pour identifier votre groupe d’appareils.

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

2. Utilisez ensuite az iot du device group show pour afficher la meilleure mise à jour disponible pour votre groupe. La commande prend les trois arguments suivants :

   • --account : nom du compte Device Update.
   • --instance : nom de l’instance Device Update.
   • --group-id : ID du groupe d’appareils que vous ciblez avec ce déploiement, à savoir la valeur de l’étiquette ADUGroup ou $default pour les appareils sans étiquette.
   • --resource-group : nom du groupe de ressources du compte Device Update.
   • --best-updates : retourne les meilleures mises à jour disponibles pour le groupe d’appareils, notamment le nombre d’appareils nécessitant chaque mise à jour.
   • --update-compliance : retourne 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 nécessitant de nouvelles mises à jour et le nombre d’appareils recevant actuellement une nouvelle mise à jour.

   Pour vérifier la meilleure mise à jour disponible pour votre groupe, exécutez la commande comme suit :

   az iot du device group show \
       --account <Device Update account name> \
       --instance <Device Update instance name>\
       --group-id <device group ID>\
       --best-updates
   

Créer le déploiement

Utilisez az iot du device deployment create pour créer un déploiement pour le groupe d’appareils. La commande prend les trois arguments suivants :

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

Exécutez la commande comme suit :

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>

Utiliser des arguments facultatifs

Les arguments facultatifs vous permettent de configurer le déploiement plus en détail. Pour obtenir la liste complète des arguments facultatifs, 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 : pourcentage des appareils ayant échoué dans un déploiement qui déclenchent une restauration.
• --rollback-update-name, --rollback-update-provider, --rollback-update-version : paramètres de la mise à jour à utiliser si une restauration est lancée.

Exécutez la commande comme suit :

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>

Pour définir l’heure de début du déploiement, utilisez le paramètre --start-time pour fournir la date et l’heure cibles du déploiement, comme suit :

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"

Surveiller l’état du déploiement

Azure portal

1. Sous l’onglet Groupes et déploiements de la page Mises à jour, sélectionnez le groupe sur lequel vous avez effectué le déploiement.

2. Dans la page Détails du groupe, accédez à l’onglet Déploiement actuel ou Historique de déploiement pour confirmer qu’un déploiement est en cours.

   

3. Sélectionnez Détails en regard d’un déploiement pour afficher les détails du déploiement, les détails de la mise à jour et les détails de la classe des appareils cibles. Vous pouvez éventuellement ajouter un nom convivial pour la classe d’appareil.

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

   

Accédez à l’onglet Informations de base du groupe de la page Détails du groupe pour rechercher l’état d’un appareil particulier ou appliquer un filtre pour afficher les appareils sur lesquels le déploiement a échoué.

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, vous pouvez le réessayer sur les appareils ayant échoué.

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>

Contenu connexe

• Déploiements Device Update
• Guide de dépannage de Device Update