Importer une mise à jour dans Azure Device Update pour IoT Hub

Pour déployer une mise à jour sur des appareils à l’aide d’Azure Device Update pour IoT Hub, commencez par importer les fichiers de mise à jour dans le service Device Update, qui stocke la mise à jour importée pour le déploiement sur les appareils. Dans cet article, vous apprenez à importer une mise à jour dans le service Device Update à l’aide du portail Azure, d’Azure CLI ou des API Device Update.

Prérequis

• Un compte et une instance Device Update configurés avec un hub IoT.

• Un dispositif IoT ou un simulateur approvisionné pour la mise à jour des appareils au sein du hub IoT.

• Mettez à jour les fichiers pour votre appareil et un fichier manifeste d’importation associé créé en suivant les instructions fournies dans Préparer l’importation d’une mise à jour dans Device Update.

• Un compte de stockage Azure et un conteneur pour conserver les fichiers importés. Vous pouvez également créer un compte de stockage et un conteneur dans le cadre du processus d’importation basé sur le portail Azure.

  Important

  Vérifiez que le compte de stockage que vous utilisez ou créez n’a pas de points de terminaison privés activés. Pour voir si les points de terminaison privés sont activés, vous pouvez rechercher le nom de votre compte de stockage Azure sous Points de terminaison privés dans le Centre Private Link.

Azure portal

• Navigateurs pris en charge : Microsoft Edge ou Google Chrome.

Azure CLI

• Environnement Bash.

  Vous pouvez utiliser l’environnement Bash dans Azure Cloud Shell pour exécuter les commandes indiquées dans cet article. 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.

Importer une mise à jour

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

Pour importer une mise à jour, vous chargez d’abord les fichiers manifestes de mise à jour et d’importation dans un conteneur de stockage Azure. Vous importez ensuite la mise à jour à partir du Stockage Azure dans Device Update pour IoT Hub, qui la stocke pour le déploiement sur les appareils.

Azure portal

1. Dans le portail Azure, sur la page IoT Hub de votre instance Device Update, sélectionnez Gestion des appareils>Mises à jour dans le volet de navigation gauche.

   

2. Sur la page Mises à jour, sélectionnez Importer une nouvelle mise à jour.

   

3. Sur la page Importer une mise à jour, sélectionnez Sélectionner dans le conteneur de stockage.

4. Sur la page Comptes de stockage, sélectionnez un compte de stockage existant ou créez-en un en sélectionnant Compte de stockage. Vous utilisez le compte de stockage d’un conteneur pour indexer les fichiers de mise à jour.

5. Sur la page Conteneurs, sélectionnez un conteneur existant ou créez-en un en sélectionnant Conteneur. Le conteneur vous permet d’indexer les fichiers de mise à jour pour l’importation.

   

   Conseil

   L’utilisation d’un nouveau conteneur chaque fois que vous importez une mise à jour permet d’éviter l’importation accidentelle de fichiers à partir des mises à jour précédentes. Si vous n’utilisez pas de nouveau conteneur, assurez-vous de supprimer tous les précédents fichiers du conteneur existant.

6. Sur la page du conteneur, sélectionnez Charger.

   

7. Sur l’écran Charger l’objet blob, sélectionnez l’icône de dossier en regard de Fichiers. Utilisez le sélecteur de fichiers pour accéder à l’emplacement de vos fichiers manifestes de mise à jour et d’importation, sélectionnez les fichiers, puis sélectionnez Ouvrir. Vous pouvez utiliser la touche Maj pour sélectionner plusieurs fichiers.

   

8. Après avoir sélectionné tous les fichiers, sélectionnez Charger.

   

9. Une fois chargés, les fichiers s’affichent sur la page du conteneur. Sur la page du conteneur, passez en revue les fichiers à importer, sélectionnez-les, puis choisissez Sélectionner.

   

10. Sur l’écran Importer la mise à jour, sélectionnez Importer la mise à jour.

    

Le processus d’importation commence et l’écran Mises à jour s’affiche. À l’issue de l’importation, celle-ci apparaît sous l’onglet Mises à jour. Pour résoudre les erreurs, consultez Résolution des problèmes de mise à jour de proxy.

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 après les avoir 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 à indexer.
• --storage-account : nom du compte de stockage vers lequel indexer la mise à jour.
• --storage-container : nom du conteneur dans le compte de stockage sélectionné vers lequel 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 indiquant s’il faut importer la mise à jour dans Device Update après l’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

Vous pouvez inclure plusieurs manifestes d’importation 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 avec des arguments préremplis.

Utilisez az iot du update list pour vérifier que vos mises à jour sont 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

Importation à l’aide d’API Device Update

Vous pouvez également importer une mise à jour par programmation en utilisant l’une des méthodes suivantes :

• Les API Device Update dans les SDK Azure pour .NET, Java, JavaScript ou Python
• L’API REST Importer la mise à jour de Device Update
• Exemples de modules PowerShell (nécessite PowerShell 5 ou une version ultérieure pour Linux, macOS ou Windows)

Remarque

Consultez Rôles et accès utilisateur Device Update pour obtenir l’autorisation d’API requise.

Vous devez charger les fichiers de mise à jour et le manifeste d’importation dans un conteneur Azure Storage Blob pour l’indexation. 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’une des méthodes suivantes pour améliorer les performances :

• AZCopy
• Azure Storage Explorer

Contenu connexe

• Groupes d’appareils
• Manifeste d’importation Device Update