Mettre à jour IoT Edge

S'applique à :IoT Edge 1.5 coché IoT Edge 1.5 IoT Edge 1.4 coché IoT Edge 1.4

À mesure que le service IoT Edge publie de nouvelles versions, mettez à jour vos appareils IoT Edge pour obtenir les dernières fonctionnalités et améliorations de sécurité. Cet article fournit des informations sur la mise à jour de vos appareils IoT Edge lorsqu’une nouvelle version est disponible.

Deux composants logiques d’un appareil IoT Edge doivent être mis à jour si vous souhaitez passer à une version plus récente.

• Sous-système de sécurité : il s’exécute sur l’appareil, gère les tâches basées sur la sécurité, et démarre les modules au démarrage de l’appareil. Vous ne pouvez mettre à jour le sous-système de sécurité qu’à partir de l’appareil lui-même.

• IoT Edge runtime : le runtime IoT Edge est constitué du hub IoT Edge (edgeHub) et de l’agent IoT Edge (edgeAgent). Selon la façon dont vous structurez votre déploiement, vous pouvez mettre à jour le runtime à partir de l’appareil ou à distance.

Comment effectuer la mise à jour

Utilisez les sections de cet article pour mettre à jour le sous-système de sécurité et les conteneurs d’exécution sur un appareil.

Mises à jour correctives

Lorsque vous effectuez une mise à niveau entre des versions correctives, par exemple de la version 1.5.1 vers la version 1.5.2, l’ordre de mise à niveau n’est pas important. Vous pouvez mettre à niveau le sous-système de sécurité ou les conteneurs d’exécution avant ou après l’autre. Pour effectuer une mise à jour entre versions correctives :

1. Mettre à jour le sous-système de sécurité
2. Mettre à jour les conteneurs d’exécution
3. Vérifier que les versions correspondent

Vous pouvez résoudre les problèmes liés au processus de mise à niveau à tout moment.

Versions majeures ou mineures

Lorsque vous effectuez une mise à niveau entre des versions majeures ou mineures, telles que de 1.4 à 1.5, mettez à jour le sous-système de sécurité et les conteneurs d’exécution. Avant une version, l’équipe produit teste le sous-système de sécurité et la combinaison de versions du conteneur d’exécution. Pour effectuer une mise à jour entre des versions majeures ou mineures du produit :

1. Sur l’appareil, arrêtez IoT Edge à l’aide de la commande sudo iotedge system stop et uninstall.

2. Sur l’appareil, mettez à niveau votre moteur de conteneur, Docker ou Moby.

3. Sur l’appareil, installez IoT Edge.

   Si vous importez une ancienne configuration à l'aide de iotedge config import, modifiez l'image [agent.config] du fichier généré /etc/aziot/config.toml pour utiliser l'image 1.5 pour edgeAgent.

   Pour plus d’informations, consultez Configure IoT Edge paramètres de l’appareil.

4. Dans IoT Hub, mettez à jour le déploiement du module pour référencer les modules système les plus récents.

5. Sur l’appareil, démarrez le IoT Edge à l’aide de sudo iotedge config apply.

Vous pouvez résoudre les problèmes liés au processus de mise à niveau à tout moment.

Mettre à jour le sous-système de sécurité

Le sous-système de sécurité IoT Edge inclut un ensemble de composants natifs que vous devez mettre à jour à l’aide du gestionnaire de package sur l’appareil IoT Edge.

Vérifiez la version du sous-système de sécurité qui s’exécute sur votre appareil à l’aide de la commande iotedge version. Si vous utilisez IoT Edge pour Linux sur Windows, vous devez connecter SSH à la machine virtuelle Linux pour vérifier la version.

sudo apt-get update

apt list -a aziot-edge

sudo apt-get install aziot-edge

yum list aziot-edge

sudo yum install aziot-edge

Ensuite, réappliquez la configuration pour garantir que le système est entièrement mis à jour.

sudo iotedge config apply

Mettre à jour les conteneurs d’exécution

La façon dont vous mettez à jour l’agent IoT Edge et les conteneurs de hub IoT Edge varient selon que vous utilisez des balises propagées (comme 1.5) ou des balises spécifiques (comme 1.5.1) dans votre déploiement.

Vérifiez la version de l’agent IoT Edge et des modules hub IoT Edge actuellement sur votre appareil à l’aide des commandes iotedge logs edgeAgent ou iotedge logs edgeHub. Si vous utilisez IoT Edge pour Linux sur Windows, vous devez connecter SSH à la machine virtuelle Linux pour vérifier les versions du module d'exécution.

Comprendre les balises IoT Edge

L'agent IoT Edge et les images hub IoT Edge utilisent des balises qui correspondent à la version IoT Edge à laquelle elles sont associées. Utilisez deux méthodes différentes pour baliser les images runtime :

• Étiquettes évolutives : utilisez uniquement les deux premières valeurs du numéro de version pour obtenir la dernière image qui correspond à ces chiffres. Par exemple, la version 1.5 est mise à jour lorsqu'une nouvelle version est publiée pour pointer vers la dernière version 1.5.x. Si le runtime de conteneur sur votre appareil IoT Edge extrait à nouveau l’image, les modules runtime sont mis à jour vers la dernière version. Les déploiements à partir du portail Azure sont par défaut des balises propagées. Utilisez cette approche à des fins de développement.

• Étiquettes spécifiques : utilisez les trois valeurs du numéro de version pour définir explicitement la version de l’image. Par exemple, la version 1.5.0 ne change pas après sa version initiale. Vous pouvez déclarer un nouveau numéro de version dans le manifeste de déploiement quand vous êtes prêt à effectuer une mise à jour. Utilisez cette approche à des fins de production.

Mettre à jour une image avec des étiquettes évolutives

Si vous utilisez des balises roulantes dans votre déploiement (par exemple, mcr.microsoft.com/azureiotedge-hub:**1.5**), vous devez forcer l'environnement d'exécution du conteneur sur votre appareil à télécharger la dernière version de l'image.

Supprimez la version locale de l’image de votre appareil IoT Edge. Sur Windows machines, la désinstallation du sous-système de sécurité supprime également les images d'exécution. Vous n'avez donc pas besoin d'effectuer cette étape à nouveau.

docker rmi mcr.microsoft.com/azureiotedge-hub:1.5
docker rmi mcr.microsoft.com/azureiotedge-agent:1.5

Vous devrez peut-être utiliser l’indicateur de force -f pour supprimer les images.

Le service IoT Edge extrait les dernières versions des images runtime et les redémarre automatiquement sur votre appareil.

Mettre à jour une image d'étiquette spécifique

Si vous utilisez des balises spécifiques dans votre déploiement (par exemple, mcr.microsoft.com/azureiotedge-hub:**1.5.1**) mettez à jour la balise dans votre manifeste de déploiement et appliquez les modifications à votre appareil.

1. Dans le IoT Hub du portail Azure, sélectionnez votre appareil IoT Edge, puis sélectionnez Set Modules.

2. Sous l’onglet Modules, sélectionnez Paramètres du runtime.

3. Dans Paramètres du runtime, mettez à jour la valeur URI d’image dans la section Agent Edge avec la version souhaitée. Par exemple, mcr.microsoft.com/azureiotedge-agent:1.5.1 Ne sélectionnez pas encore Appliquer.

4. Sélectionnez l’onglet Hub Edge et mettez à jour la valeur URI d’image avec la même version souhaitée. Par exemple : mcr.microsoft.com/azureiotedge-hub:1.5.1.

5. Sélectionnez Appliquer pour enregistrer les modifications.

6. Sélectionnez Vérifier + créer, passez en revue le déploiement comme indiqué dans le fichier JSON, puis sélectionner Créer.

Mettre à jour des URI de module partenaire

Si vous utilisez des modules partenaires, mettez à jour vos déploiements de modules avec des URI d’image fournis par le partenaire. Contactez l’éditeur de module IoT Edge pour obtenir l’URI d’image conteneur mis à jour. Mettez à jour les configurations de votre appareil avec le nouvel URI d’image fourni par l’éditeur.

1. Connectez-vous au portail Azure et accédez à votre IoT Hub.
2. Dans le volet de gauche, sélectionnez Appareils sous le menu Gestion des appareils.
3. Sélectionnez l’appareil IoT Edge qui utilise le module partenaire dans la liste.
4. Dans la barre supérieure, sélectionnez Définir des modules.
5. Choisissez le module partenaire IoT Edge que vous souhaitez mettre à jour avec le nouvel URI d’image.
6. Mettez à jour la valeur URI de l’image avec le nouvel URI d’image fourni par l’éditeur.
7. Sélectionnez Appliquer pour enregistrer les modifications.
8. Sélectionnez Vérifier + créer, passez en revue le déploiement comme indiqué dans le fichier JSON, puis sélectionner Créer.

Vérifier que les versions correspondent

1. Sur votre appareil, utilisez iotedge version pour vérifier la version du sous-système de sécurité. La sortie inclut les numéros de version principale, mineure et de révision. Par exemple, iotedge 1.5.13.

2. Dans les paramètres du runtime de déploiement de votre appareil, vérifiez que les versions d’URI d’image edgeHub et edgeAgent correspondent à la version majeure et mineure du sous-système de sécurité. Si la version du sous-système de sécurité est 1.5.15, les versions d’image sont 1.5. Par exemple, mcr.microsoft.com/azureiotedge-hub:1.5 et mcr.microsoft.com/azureiotedge-agent:1.5.

Dépannage

Vous pouvez afficher les journaux de votre système à tout moment en exécutant les commandes suivantes à partir de votre appareil.

• Commencez à résoudre les problèmes à l’aide de la commande check. Elle exécute une collection de tests de configuration et de connectivité pour les problèmes courants.

  sudo iotedge check --verbose
  

• Pour afficher l’état du système IoT Edge, exécutez :

  sudo iotedge system status 
  

• Pour afficher les journaux des composants hôtes, exécutez :

  sudo iotedge system logs
  

• Pour rechercher les problèmes récurrents signalés par edgeAgent et edgeHub, exécutez :

  Veillez à remplacer <module> par le nom de votre propre module. S’il n’y a aucun problème, aucune sortie n’est visible.

  sudo iotedge logs <module>
  

Pour plus d’informations, consultez Dépannage de votre appareil IoT Edge.

Étapes suivantes

Affichez les dernières versions Azure IoT Edge.