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

1. Dans le portail Azure, accédez à votre hub IoT.

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. Pour la sécurité des téléchargements, sélectionnez HTTPS (recommandé) ou HTTP. Ce paramètre contrôle le protocole utilisé par les appareils pour télécharger le contenu de la mise à jour. HTTPS est le code par défaut et chiffre le contenu des mises à jour en transit.

   Pour des conseils sur le choix d’un protocole et la préparation de vos appareils, voir Comprendre la sécurité des téléchargements (TLS) dans Mise à jour des appareils pour IoT Hub.

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

   

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

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

    

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

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.

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>

Les appareils téléchargent par défaut le contenu mis à jour via HTTPS. Pour utiliser HTTP à la place, ajoutez le paramètre optionnel --download-security décrit dans Utiliser des arguments optionnels.

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"

Pour choisir le protocole utilisé par les appareils pour télécharger le contenu de mise à jour, ajoutez le paramètre optionnel --download-security . Les valeurs acceptées sont HTTPS (recommandées) et HTTP. Si vous omets le paramètre, le déploiement utilise par défaut HTTPSle paramètre . Pour des conseils sur le choix d’un protocole et la préparation de vos appareils, voir Comprendre la sécurité des téléchargements (TLS) dans Mise à jour des appareils pour IoT Hub.

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> \
    --download-security <HTTPS or HTTP>

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

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

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.

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

Cette commande reprend l’argument --class-id , qui est généré à partir de l’identifiant du modèle et des propriétés de compatibilité rapportés 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>