Déploiement d’une mise à jour logicielle dans un groupe (aperçu)

Azure Device Registry utilise des tâches pour appliquer des mises à jour logicielles à des groupes d’appareils connectés à IoT Hub. Une tâche de mise à jour logicielle cible un groupe d’appareils et applique une mise à jour logicielle aux membres compatibles de ce groupe. En revanche, un travail de mise à jour d’intégration cible les appareils qui s’intègrent à un espace de noms. Déployer une mise à jour logicielle en tant que travail vous permet de déployer la même mise à jour sur plusieurs appareils simultanément, afin de garder vos appareils connectés à l’IoT Hub à jour sans mettre à jour chaque appareil individuellement.

Cet article vous montre comment définir ou valider un groupe cible, utiliser le portail Azure ou Bicep pour créer une tâche standard de mise à jour logicielle, exécuter ou planifier la tâche, et surveiller les résultats. Utilisez cet article après avoir importé la mise à jour logicielle que vous souhaitez appliquer. Pour comprendre comment les travaux, les groupes et les mises à jour logicielles fonctionnent ensemble, consultez Mises à jour logicielles dans Azure Device Registry.

Important

Les mises à jour logicielles d’Azure Device Registry sont actuellement en aperçu. L’aperçu actuel concerne les appareils connectés à l’IoT Hub. Cet aperçu est fourni sans accord de niveau de service, et la fonctionnalité ainsi que son expérience de portail peuvent évoluer avant qu’elle ne devienne généralement disponible. Pour plus d’informations, consultez Conditions d'utilisation supplémentaires pour les versions préliminaires de Microsoft Azure.

Note

Dans la version préliminaire, vous pouvez utiliser uniquement les mises à jour logicielles avec les IoT hubs qui ne disposent pas d’une instance existante de Device Update pour IoT Hub. Pour utiliser des mises à jour logicielles, liez une instance IoT Hub sans Device Update pour IoT Hub à votre espace de noms, ou supprimez l’instance existante avant de lier le hub. Pour plus d’informations, consultez Mises à jour logicielles et Mise à jour des appareils pour IoT Hub.

Prerequisites

  • Appareils connectés à l’IoT Hub dont les propriétés identifient les appareils que vous souhaitez mettre à jour. Utilisez ces propriétés pour définir le groupe cible.
  • Une mise à jour logicielle a été importée dans l’espace de noms. Pour en savoir plus, voir Importer une mise à jour logicielle (aperçu).
  • Les mises à jour logicielles sont activées sur l’espace de noms contenant vos appareils. Pour en savoir plus, consultez Commencer avec Azure Device Registry.
  • Autorisations du plan de contrôle Azure Resource Manager, telles que le rôle Contributeur, pour créer, lire, mettre à jour et supprimer des travaux.
  • Pour exécuter des jobs, l’identité gérée de l’espace de noms doit avoir accès à l’instance de mises à jour logicielles liée à cet espace. Si vous activez les mises à jour logicielles dans le portail Azure, ces attributions de rôles sont créées pour vous.

Définir ou valider le groupe cible

Un job de mise à jour logicielle cible un groupe plutôt que tous les appareils de l’espace de noms. Créez un groupe avec un filtre qui ne sélectionne que les appareils connectés à IoT Hub devant recevoir la mise à jour, ou réutilisez un groupe existant dont l’appartenance correspond à cette étendue. Par exemple, utilisez des propriétés de dispositifs telles que le fabricant, le modèle ou la révision logicielle pour cibler une cohorte spécifique d’appareils. Utilisez le portail Azure ou Bicep pour créer le groupe.

Pour créer un groupe sur le portail Azure :

  1. Dans la navigation d’espace de noms, ouvrez Opérations>Groupes (version préliminaire), puis lancez la création de groupes depuis la barre de commandes.

  2. Sur la page Notions de base, saisissez un nom descriptif et, éventuellement, une description qui identifie la cohorte d’appareils visée.

  3. Sur la page Définition, sous Définir les conditions de filtre, saisissez une requête qui sélectionne les appareils connectés à l’IoT Hub que vous souhaitez mettre à jour.

    Capture d’écran de la page Définition avec l’éditeur de requêtes de l’appareil.

    Les filtres de groupe ne peuvent pas être modifiés une fois créés. Pour utiliser différents critères d’adhésion, créez un autre groupe avec une requête différente.

  4. Sur la page Vérifier, vérifiez les Concepts de base, la Définition et le Filtre de requête, puis sélectionnez Créer.

    Capture d’écran de la page Review montrant le nom du groupe, la description et le filtre de requête.

L’appartenance au groupe est calculée et mise en cache lors de la création ou de l’actualisation du groupe. Avant d’utiliser un groupe pour une tâche de mise à jour logicielle :

  • Actualisez l’appartenance au groupe si les propriétés de l’appareil ont pu changer. Dans le portail Azure, Refresh est disponible dans la barre de commandes des détails du groupe.
  • Attendez que le statut du groupe soit Prêt.
  • Dans la vue détail du groupe, vérifiez le filtre de requête résolu et le nombre de membres. La liste des membres présente jusqu’à 10 appareils, donc considérez cela comme une vérification ponctuelle plutôt qu’une liste complète, et confirmez que le nombre de membres correspond aux appareils que vous comptez mettre à jour.

Créer une tâche de mise à jour logicielle

Un travail de mise à jour logicielle vise un groupe d’appareils et applique une mise à jour logicielle importée aux membres compatibles de ce groupe. Utilisez le portail Azure ou Bicep pour créer le travail.

  1. Dans le portail Azure, accédez à votre Azure Device Registry et sélectionnez l’espace de noms contenant les appareils que vous souhaitez mettre à jour.

  2. Dans l’espace de noms, sélectionnez Opérations>Jobs. L’écran Jobs liste les jobs définis avec leur statut, leur type de poste et leur groupe cible. Depuis cet écran, vous pouvez également voir les groupes et les mises à jour logicielles dans l’espace de noms.

    Capture d’écran de la page Jobs montrant des jobs définis avec leur type, statut et groupe cible.

  3. Sélectionnez Créer pour créer un travail.

  4. Sur la page Notions de base, fournissez un nom et une description pour le travail.

  5. Pour le type de tâche, sélectionnez Mise à jour logicielle.

    Dans l’aperçu, les types de tâches disponibles sont Mise à jour logicielle et Mise à jour d’intégration. Un travail de mise à jour logicielle cible un groupe d’appareils, et un travail de mise à jour d’intégration cible les appareils intégrant un espace de noms. Cet article traite de la tâche de mise à jour logicielle.

  6. Sélectionnez le groupe que vous souhaitez viser. Utilisez le sélecteur de groupe pour rechercher et sélectionner un groupe. Le sélecteur affiche le nombre approximatif d’appareils dans chaque groupe.

    Pour des informations sur la façon dont l’appartenance à un groupe est actualisée, voir Concepts de groupes (aperçu).

  7. Garde la sélection du groupe. Le portail affiche un échantillon des appareils du groupe ainsi que le nombre d’appareils.

  8. Définissez l’action à exécuter en sélectionnant l’une des mises à jour logicielles importées dans l’espace de noms. Chaque mise à jour logicielle inclut un contrôle de compatibilité qui détermine si elle s’applique à un appareil. Le portail effectue une vérification de compatibilité pour le groupe sélectionné afin de déterminer si la mise à jour logicielle est compatible.

    Capture d’écran de la page Jobs montrant la définition de l’action pour un job de mise à jour logicielle.

  9. Sélectionnez Suivant pour consulter un résumé de la tâche. Le résumé montre le nombre de membres du groupe et une estimation du nombre de membres compatibles que le travail est susceptible de mettre à jour avec succès.

    Capture d’écran de la page Tâches montrant l’examen d’une tâche de mise à jour logicielle.

  10. Cliquez sur Créer. Le statut du travail affiche En cours de création, puis passe à Prêt au bout d’un instant.

Exécuter ou planifier le travail

Une fois qu’une tâche est prête, vous pouvez l’exécuter immédiatement ou la programmer pour plus tard.

  1. Dans l’écran Jobs, sélectionnez le job que vous souhaitez exécuter.

  2. Sélectionnez l’une des options suivantes :

    • Exécuter maintenant : La tâche se lance immédiatement.
    • Planifiez pour plus tard : Choisissez un moment dans les sept prochains jours. La tâche s’exécute à l’heure que vous sélectionnez.

Après avoir lancé ou planifié la tâche, le portail passe à l’onglet Exécutions .

Surveillez l’exécution de la tâche

L’onglet Exécutions affiche les travaux, y compris les exécutions en cours, les exécutions terminées et les exécutions planifiées.

  1. Sélectionnez l’onglet Exécutions pour voir les exécutions et leur statut.

  2. Sélectionnez une exécution terminée pour consulter ses statistiques. Les détails de l’exécution montrent le nombre d’appareils mis à jour et les détails de ces appareils.

  3. Vérifie un appareil spécifique. Pour confirmer si un appareil spécifique a été mis à jour, utilisez la barre de recherche dans les détails de l’exécution pour trouver l’appareil.