AWS IoT Greengrass Version 1 est entré dans la phase de durée de vie prolongée le 30 juin 2023. Pour plus d'informations, consultez la politique de AWS IoT Greengrass V1 maintenance. Après cette date, AWS IoT Greengrass V1 ne publiera pas de mises à jour fournissant des fonctionnalités, des améliorations, des corrections de bogues ou des correctifs de sécurité. Les appareils qui fonctionnent AWS IoT Greengrass V1 sous tension ne seront pas perturbés et continueront à fonctionner et à se connecter au cloud. Nous vous recommandons vivement de migrer vers AWS IoT Greengrass Version 2, qui ajoute de nouvelles fonctionnalités importantes et prend en charge des plateformes supplémentaires.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Mises à jour OTA du logiciel AWS IoT Greengrass Core

Le package logiciel AWS IoT Greengrass Core inclut un agent de mise à jour qui peut effectuer des mises à jour over-the-air (OTA) du AWS IoT Greengrass logiciel. Vous pouvez utiliser les mises à jour OTA pour installer la dernière version du logiciel AWS IoT Greengrass Core ou du logiciel de l'agent de mise à jour OTA sur un ou plusieurs cœurs. Avec les mises à jour OTA, vos appareils principaux n'ont pas besoin d'être physiquement présents.

Nous vous recommandons d'utiliser les mises à jour OTA dès que possible. Elles fournissent un mécanisme que vous pouvez utiliser pour suivre l'état et l'historique des mises à jour. En cas d'échec de la mise à jour, l'agent de mise à jour OTA revient à la version logicielle précédente.

Les mises à jour OTA permettent de mieux :

Cette fonction s'intègre aux tâches AWS IoT.

Prérequis

Les conditions suivantes s'appliquent aux mises à jour OTA du logiciel AWS IoT Greengrass.

Autorisations IAM pour les mises à jour OTA

Lors AWS IoT Greengrass de la publication d'une nouvelle version du logiciel AWS IoT Greengrass Core, AWS IoT Greengrass met à jour les artefacts logiciels stockés dans Amazon S3 qui sont utilisés pour la mise à jour OTA.

Vous Compte AWS devez inclure un rôle de signataire d'URL Amazon S3 qui peut être utilisé pour accéder à ces artefacts. Le rôle doit disposer d'une politique d'autorisations qui autorise l's3:GetObjectaction sur les compartiments des ciblesRégion AWS. Le rôle doit également avoir une stratégie d'approbation qui permet à iot.amazonaws.com d'assumer le rôle en tant qu'entité approuvée.

En outre, l'utilisateur qui initie une mise à jour OTA doit être autorisé à utiliser greengrass:CreateSoftwareUpdateJob et iot:CreateJob, et à utiliser iam:PassRole pour transmettre les autorisations du rôle de signataire. Voici un exemple de politique IAM :

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Action": [
                "greengrass:CreateSoftwareUpdateJob"
            ],
            "Effect": "Allow",
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": [
                "iot:CreateJob"
            ],
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": [
                "iam:PassRole"
            ],
            "Resource": "arn-of-s3-url-signer-role"
        }
    ]
}

Considérations

Avant de lancer une mise à jour OTA du logiciel Greengrass Core, vous devez connaître l'impact sur les appareils de votre groupe Greengrass, tant sur l'appareil principal que sur les appareils clients connectés localement à ce noyau :

Les informations d'état suivantes sont conservées pendant une mise à jour OTA :

Agent de mise à jour OTA Greengrass

L'agent de mise à jour Greengrass OTA est le composant logiciel de l'appareil qui gère les tâches de mise à jour créées et déployées dans le cloud. L'agent de mise à jour OTA est distribué dans le même progiciel que le logiciel AWS IoT Greengrass Core. Cet agent est situé dans /greengrass-root/ota/ota_agent/ggc-ota. Il écrit les journaux dans /var/log/greengrass/ota/ggc_ota.txt.

Vous pouvez démarrer l'agent de mise à jour OTA en exécutant le fichier binaire manuellement ou en l'intégrant dans un script d'initialisation, tel qu'un fichier de service systemd. Si vous exécutez le binaire manuellement, il doit être exécuté en tant que root. Au démarrage, l'agent de mise à jour OTA écoute les tâches de mise à jour AWS IoT Greengrass logicielle AWS IoT Core et les exécute de manière séquentielle. L'agent de mise à jour OTA ignore tous les autres types de AWS IoT tâches.

L'extrait suivant montre un exemple de fichier de service systemd permettant de démarrer, d'arrêter et de redémarrer l'agent de mise à jour OTA :

[Unit]
Description=Greengrass OTA Daemon

[Service]
Type=forking
Restart=on-failure
ExecStart=/greengrass/ota/ota_agent/ggc-ota

[Install]
WantedBy=multi-user.target

Un cœur qui est la cible d'une mise à jour ne doit pas exécuter deux instances de l'agent de mise à jour OTA. Cela conduirait les deux agents à traiter les mêmes tâches, ce qui créerait des conflits.

Intégration à des systèmes d'initialisation

Lors d'une mise à jour OTA, l'agent de mise à jour OTA redémarre les fichiers binaires sur le périphérique principal. Si les fichiers binaires sont en cours d'exécution, cela peut entraîner des conflits lorsqu'un système d'initialisation surveille l'état du logiciel AWS IoT Greengrass Core ou l'agent pendant la mise à jour. Pour vous aider à intégrer le mécanisme de mise à jour OTA à vos stratégies de surveillance d'initialisation, vous pouvez écrire des scripts shell qui s'exécutent avant et après une mise à jour. Par exemple, vous pouvez utiliser le ggc_pre_update.sh script pour sauvegarder des données ou arrêter des processus avant que l'appareil ne s'arrête.

Pour demander à l'agent de mise à jour OTA d'exécuter ces scripts, vous devez inclure l'"managedRespawn" : trueindicateur dans le fichier config.json. Ce paramètre est illustré dans l'extrait suivant :

{
   "coreThing": {                                                     
       …
   },
   "runtime": {                                                       
       …
   },
   "managedRespawn": true
       …
}

Commande managedRespawn avec mises à jour OTA

Les exigences suivantes s'appliquent aux mises à jour OTA managedRespawn définies sur true :

L'agent de mise à jour OTA exécute les scripts du/greengrass-root/usr/scripts. L'arborescence doit être similaire à ce qui suit :

<greengrass_root>
|-- certs
|-- config
|   |-- config.json
|-- ggc
|-- usr/scripts
|   |-- ggc_pre_update.sh
|   |-- ggc_post_update.sh
|   |-- ota_pre_update.sh
|   |-- ota_post_update.sh
|-- ota

Lorsque managedRespawn ce paramètre est défini surtrue, l'agent de mise à jour OTA vérifie la présence de ces scripts dans le /greengrass-root/usr/scripts répertoire avant et après la mise à jour logicielle. Si les scripts n'existent pas, la mise à jour échoue. AWS IoT Greengrassne valide pas le contenu de ces scripts. La meilleure pratique consiste à vérifier que vos scripts fonctionnent correctement et à émettre les codes de sortie appropriés en cas d'erreur.

Création d'une mise à jour OTA

Procédez comme suit pour effectuer une mise à jour OTA du logiciel AWS IoT Greengrass sur un ou plusieurs noyaux :

API CreateSoftwareUpdateJob

Vous pouvez utiliser l'CreateSoftwareUpdateJobAPI pour mettre à jour le logiciel AWS IoT Greengrass Core ou le logiciel de l'agent de mise à jour OTA sur vos appareils principaux. Cette API crée une tâche d'instantané AWS IoT qui avertit les périphériques lorsqu'une mise à jour est disponible. Après avoir appelé CreateSoftwareUpdateJob, vous pouvez utiliser d'autres commandes de tâche AWS IoT pour suivre la mise à jour logicielle. Pour plus d'informations, consultez la section Jobs du Guide du AWS IoT développeur.

L'exemple suivant montre comment utiliser l'AWS CLI pour créer une tâche de mise à jour du logiciel AWS IoT Greengrass Core sur un appareil principal :

aws greengrass create-software-update-job \
--update-targets-architecture x86_64 \
--update-targets [\"arn:aws:iot:region:123456789012:thing/myCoreDevice\"] \
--update-targets-operating-system ubuntu \
--software-to-update core \
--s3-url-signer-role arn:aws:iam::123456789012:role/myS3UrlSignerRole \
--update-agent-log-level WARN \
--amzn-client-token myClientToken1

La commande create-software-update-job renvoie une réponse JSON qui contient l'ID de tâche, l'ARN de la tâche et la version du logiciel qui a été installée par la mise à jour :

{
    "IotJobId": "GreengrassUpdateJob_c3bd7f36-ee80-4d42-8321-a1da0EXAMPLE",
    "IotJobArn": "arn:aws:iot:region:123456789012:job/GreengrassUpdateJob_c3bd7f36-ee80-4d42-8321-a1da0EXAMPLE",
    "PlatformSoftwareVersion": "1.9.2"
}

Pour consulter les étapes pour utiliser create-software-update-job afin de mettre à jour un appareil principal, veuillez consulter Création d'une mise à jour OTA.

La commande create-software-update-job est paramétrée comme suit :