Importer une mise à jour dans Device Update pour IoT Hub

Découvrez comment obtenir une nouvelle mise à jour et l’importer dans Device Update pour IoT Hub. Si vous ne l’avez pas encore fait, veillez à passer en revue les concepts d’importation clés et le guide préparation d’une mise à jour à importer.

Prérequis

• Accéder àun IoT Hub avec Device Update pour IoT Hub activé.

• Un conteneur Stockage Azure sans Point de terminaison privé activé.

  • Si vous ne savez pas si Point de terminaison privé est activé, accédez à Centre Private Link, sélectionnez « Points de terminaison privés » sur la gauche, puis recherchez le nom de votre compte Stockage Azure dans la colonne « Ressources ».

• Un appareil (ou un simulateur) IoT provisionné pour Device Update dans IoT Hub.

• Suivez les étapes décrites dans Préparer une mise à jour à importer dans Device Update pour IoT Hub afin de créer le manifeste d’importation pour vos fichiers de mise à jour.

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.

Importer une mise à jour

Cette section montre comment importer une mise à jour à l’aide du Portail Azure ou d’Azure CLI. Vous pouvez également utiliser les API Device Update pour IoT Hub pour importer une mise à jour.

Pour importer une mise à jour, vous devez d’abord charger les fichiers de mise à jour et importer le manifeste dans un conteneur de stockage Azure. Ensuite, vous importez la mise à jour à partir de Stockage Azure dans Device Update pour IoT Hub, où elle sera stockée pour vous permettre de la déployer sur des appareils.

Azure portal

1. Dans le Portail Azure, accédez à votre IoT Hub avec Device Update.

2. Sur le côté gauche de la page, sélectionnez Mises à jour sous Gestion des périphériques.

   

3. Sélectionnez l’onglet Mises à jour dans la liste des onglets en haut de l’écran.

   

4. Sélectionnez + Importer une nouvelle mise à jour sous l’en-tête Mises à jour disponibles.

   

5. Sélectionnez + Sélectionner dans le conteneur de stockage. L’interface utilisateur des comptes de stockage s’affiche. Sélectionnez un compte existant ou créez-en un en utilisant + Compte de stockage. Ce compte est utilisé pour un conteneur afin de préparer vos mises à jour pour l’importation. Les points de terminaison publics et privés du compte ne doivent pas être activés en même temps.

   

6. Une fois que vous avez sélectionné un compte de stockage, l’interface utilisateur Conteneurs s’affiche. Sélectionnez un conteneur existant ou créez-en un avec + Conteneur. Ce conteneur est utilisé pour indexer vos fichiers de mise à jour pour l’importation

   Nous vous recommandons d’utiliser un nouveau conteneur pour chaque importation de mise à jour. Toujours utiliser de nouveaux conteneurs vous permet d’éviter d’importer accidentellement des fichiers à partir de mises à jour précédentes. Si vous n’utilisez pas un nouveau conteneur, veillez à supprimer tous les fichiers du conteneur existant avant de terminer cette étape.

   

7. Dans votre conteneur, sélectionnez Charger. L’interface utilisateur Charger est présentée.

   

8. Sélectionnez l’icône de dossier à droite de la section Fichiers sous l’en-tête Charger un blob. Utilisez le sélecteur de fichiers pour accéder à l’emplacement de vos fichiers de mise à jour et au manifeste d’importation, sélectionnez tous les fichiers, puis sélectionnez Ouvrir. Pour sélectionner plusieurs fichiers, vous pouvez maintenir la touche Maj enfoncée tout en cliquant sur chaque fichier.

   

9. Une fois que vous avez sélectionné tous vos fichiers de mise à jour, sélectionnez Charger.

   

10. Sélectionnez les fichiers chargés pour indiquer de les importer. Sélectionnez ensuite le bouton Sélectionner pour revenir à la page Importer la mise à jour.

    

11. Dans la page Importer la mise à jour, passez en revue les fichiers à importer. Sélectionnez ensuite Importer la mise à jour pour démarrer le processus d’importation. Pour résoudre les erreurs, consultez Résolution des problèmes de mise à jour de proxy.

    

12. Le processus d’importation commence et l’écran passe à la section Historique d’importation. Sélectionnez Actualiser pour voir la progression jusqu’à la fin du processus d’importation (selon la taille de la mise à jour, cette opération peut prendre quelques minutes ou durer plus longtemps).

    

13. Lorsque la colonne État indique que l’importation a réussi, sélectionnez l’en-tête Mises à jour disponibles. Vous devez maintenant voir votre mise à jour importée dans la liste.

    

Azure CLI

La commande az iot du update stage gère les étapes préalables à l’importation d’une mise à jour, notamment le chargement des fichiers de mise à jour dans un conteneur de stockage cible. Un indicateur facultatif permet également à cette commande d’importer automatiquement les fichiers une fois qu’ils sont préparés. Sinon, la commande az iot du update import termine le processus.

La commande stage prend les trois arguments suivants :

• --account : nom du compte Device Update.
• --instance : nom de l’instance Device Update.
• --manifest-path : chemin d’accès au fichier du manifeste d’importation qui doit être indexé.
• --storage-account : nom du compte de stockage pour indexer la mise à jour.
• --storage-container : nom du conteneur dans le compte de stockage sélectionné pour indexer la mise à jour.
• --overwrite : indicateur facultatif qui indique s’il faut remplacer les blobs existants dans le conteneur de stockage en cas de conflit.
• --then-import : indicateur facultatif qui indique si la mise à jour doit être importée dans Device Update après son indexation.

az iot du update stage \
    --account <Replace with your Device Update account name> \
    --instance <Replace with your Device Update instance name> \
    --manifest-path <Replace with the full path to your import manifest> \
    --storage-account <Replace with your Storage account name> \
    --storage-container <Replace with your container name> \
    --overwrite --then-import

Par exemple :

az iot du update stage \
    --account deviceUpdate001 \
    --instance myInstance \
    --manifest-path /my/apt/manifest/file.importmanifest.json \
    --storage-account deviceUpdateStorage \
    --storage-container deviceUpdateDemo \
    --overwrite --then-import

Si vous avez plusieurs manifestes d’importation, vous pouvez tous les inclure dans une seule commande. Par exemple :

az iot du update stage \
    --account deviceUpdate001 \
    --instance myInstance \
    --manifest-path /my/apt/manifest/parent.importmanifest.json \
    --manifest-path /my/apt/manifest/child1.importmanifest.json \
    --manifest-path /my/apt/manifest/child2.importmanifest.json \
    --storage-account deviceUpdateStorage \
    --storage-container deviceUpdateDemo \
    --overwrite --then-import

Si vous n’utilisez pas l’indicateur --then-import, la sortie de la commande stage inclut une invite pour exécuter az iot du update import, y compris les arguments préremplis.

Utilisez az iot du update list pour vérifier que votre ou vos mises à jour ont été correctement importées.

az iot du update list \
    --account <Replace with your Device Update account name> \
    --instance <Replace with your Device Update instance name> \
    -o table

Si vous importez plutôt via des APIs

Vous pouvez également importer une mise à jour par programme en :

• Avec Azure SDK pour .NET, Java, JavaScript ou Python
• Avec l’API REST Importer la mise à jour
• Avec des exemples de modules PowerShell
  • Exige PowerShell 5 ou version ultérieure (y compris les installations Linux, macOS et Windows)

Remarque

Pour l’autorisation d’API requise, consultez les rôles d’utilisateur et l’accès à Device Update.

Vous devez charger les fichiers de mise à jour et le manifeste d’importation dans un conteneur Azure Storage Blob pour la préproduction. Pour importer les fichiers de préproduction, fournissez l’URL de l’objet blob, ou la signature d’accès partagé (SAS) pour les objets blob privés, à l’API Device Update. Si vous utilisez une SAS, veillez à fournir une fenêtre d’expiration de trois heures ou plus

Conseil

Pour charger des fichiers de mise à jour volumineux dans un conteneur Azure Storage Blob, vous pouvez utiliser l’un des éléments suivants pour améliorer les performances :

• AZCopy
• Azure Storage Explorer

Étapes suivantes

• Créer des groupes
• En savoir plus sur les concepts d’importation