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.

Installation et exécutionAWS IoT Greengrasssur l'appareil principal

Note

Ce didacticiel fournit des instructions vous permettant d'exécuterAWS IoT GreengrassUn Raspberry Pi, mais vous pouvez utiliser n'importe quel appareil pris en charge.

Dans cette section, vous allez configurer, installer et exécuter leAWS IoT GreengrassLogiciel Core sur l'appareil noyau.

Pour installer et exécuterAWS IoT Greengrass

De laAWS IoT GreengrassLogiciel Corede ce guide, téléchargezAWS IoT GreengrassPackage d'installation du logiciel Core. Choisissez le package qui correspond le mieux à l'architecture du processeur, à la distribution et au système d'exploitation de votre appareil principal.
- Pour Raspberry Pi, téléchargez le package pour l'architecture Armv7l et le système d'exploitation Linux.
- Pour une instance Amazon EC2, téléchargez le package pour l'architecture x86_64 et le système d'exploitation Linux.
- Pour NVIDIA Jetson TX2, téléchargez le package pour l'architecture Armv8 (AArch64) et le système d'exploitation Linux.
- Pour Intel Atom, téléchargez le package pour l'architecture x86_64 et le système d'exploitation Linux.
Au cours des étapes précédentes, vous avez téléchargé cinq fichiers sur votre ordinateur :
- greengrass-OS-architecture-1.11.6.tar.gz— Ce fichier compressé contient leAWS IoT GreengrassLogiciel qui s'exécute sur l'appareil noyau.
- certificateId-certificate.pem.crt— Fichier de certificat de l'appareil.
- certificateId-public.pem.key— Fichier de clé publique du certificat de l'appareil.
- certificateId-private.pem.key— Fichier de clé privée du certificat de l'appareil.
- AmazonRootCA1.pem— Fichier de l'autorité de certification (CA) racine (CA) racine Amazon.
Au cours de cette étape, vous transférez ces fichiers depuis votre ordinateur vers l'appareil noyau. Procédez comme suit :
1. Si vous ne connaissez pas l'adresse IP de votre appareil noyau Greengrass, ouvrez une fenêtre de terminal sur l'appareil noyau et exécutez la commande suivante.
  
  Note
  Cette commande peut ne pas renvoyer l'adresse IP correcte pour certains appareils. Consultez la documentation de votre appareil pour récupérer votre adresse IP.
```
hostname -I
```
2. Transférez ces fichiers depuis votre ordinateur vers l'appareil noyau. Ces étapes varient en fonction du système d'exploitation de votre ordinateur. Choisissez votre système d'exploitation pour les étapes qui montrent comment transférer des fichiers vers votre appareil Raspberry Pi.
  
  Note
  Pour un Raspberry Pi, le nom d'utilisateur par défaut est pi et le mot de passe par défaut est raspberry.
  Pour un NVIDIA Jetson TX2, le nom d'utilisateur par défaut est nvidia et le mot de passe par défaut est nvidia.
  Windows
  Pour transférer les fichiers compressés depuis votre ordinateur vers un appareil noyau Raspberry Pi, utilisez un outil tel que WinSCP ou la commande PuTTY pscp. Pour utiliser la commande pscp, ouvrez une fenêtre d'invite de commande sur votre ordinateur et exécutez les éléments suivants :
  
  cd path-to-downloaded-files pscp -pw Pi-password greengrass-OS-architecture-1.11.6.tar.gz pi@IP-address:/home/pi pscp -pw Pi-password certificateId-certificate.pem.crt pi@IP-address:/home/pi pscp -pw Pi-password certificateId-public.pem.key pi@IP-address:/home/pi pscp -pw Pi-password certificateId-private.pem.key pi@IP-address:/home/pi pscp -pw Pi-password AmazonRootCA1.pem pi@IP-address:/home/pi
  
  Note
  Le numéro de version de cette commande doit correspondre à la version de votre package logiciel AWS IoT Greengrass Core.
  macOS
  Pour transférer les fichiers compressés depuis votre Mac vers un appareil noyau Raspberry Pi, ouvrez une fenêtre de terminal sur votre ordinateur et exécutez les commandes suivantes. Lepath-to-downloaded-filesest généralement~/Downloads.
  
  Note
  Il se peut que vous soyez invité à saisir deux mots de passe. Dans ce cas, le premier mot de passe est celui de la commande sudo du Mac, et le deuxième celui du Raspberry Pi.
  
  cd path-to-downloaded-files scp greengrass-OS-architecture-1.11.6.tar.gz pi@IP-address:/home/pi scp certificateId-certificate.pem.crt pi@IP-address:/home/pi scp certificateId-public.pem.key pi@IP-address:/home/pi scp certificateId-private.pem.key pi@IP-address:/home/pi scp AmazonRootCA1.pem pi@IP-address:/home/pi
  
  Note
  Le numéro de version de cette commande doit correspondre à la version de votre package logiciel AWS IoT Greengrass Core.
  UNIX-like system
  Pour transférer les fichiers compressés depuis votre ordinateur vers un appareil noyau Raspberry Pi, ouvrez une fenêtre de terminal sur votre ordinateur et exécutez les commandes suivantes :
  
  cd path-to-downloaded-files scp greengrass-OS-architecture-1.11.6.tar.gz pi@IP-address:/home/pi scp certificateId-certificate.pem.crt pi@IP-address:/home/pi scp certificateId-public.pem.key pi@IP-address:/home/pi scp certificateId-private.pem.key pi@IP-address:/home/pi scp AmazonRootCA1.pem pi@IP-address:/home/pi
  
  Note
  Le numéro de version de cette commande doit correspondre à la version de votre package logiciel AWS IoT Greengrass Core.
  Raspberry Pi web browser
  
  Si vous avez utilisé le navigateur web du Raspberry Pi pour télécharger les fichiers compressés, ceux-ci doivent se trouver dans le fichier Pi.~/Downloadsdossier, tel que/home/pi/Downloads. À défaut, les fichiers compressés doivent se trouver dans les Pi~dossier, tel que/home/pi.
Sur l'appareil noyau Greengrass, ouvrez une fenêtre de terminal et accédez au dossier contenant leAWS IoT GreengrassLogiciels et certificats de base. Remplacezpath-to-transferred-filesavec le chemin d'accès où vous avez transféré les fichiers sur l'appareil noyau. Par exemple, sur un Raspberry Pi, exécutezcd /home/pi.
```
cd path-to-transferred-files
```
DéballezAWS IoT GreengrassLogiciel Core sur l'appareil principal. Exécutez la commande suivante pour décompresser l'archive du logiciel que vous avez transférée sur l'appareil noyau. Cette commande utilise la-C /pour créer l'argument/greengrassdans le dossier racine du périphérique noyau.
```
sudo tar -xzvf greengrass-OS-architecture-1.11.6.tar.gz -C /
```
Note
Le numéro de version de cette commande doit correspondre à la version de votre package logiciel AWS IoT Greengrass Core.
Déplacez les certificats et les clés vers leAWS IoT GreengrassDossier logiciel Core. Exécutez les commandes suivantes pour créer un dossier pour les certificats et y déplacer les certificats et les clés. Remplacezpath-to-transferred-filespar le chemin d'accès où vous avez transféré les fichiers sur le périphérique principal, et remplacezcertificateIdavec l'ID du certificat dans les noms de fichiers. Par exemple, sur un Raspberry Pi, remplacezpath-to-transferred-filesavec/home/pi
```
sudo mv path-to-transferred-files/certificateId-certificate.pem.crt /greengrass/certs
sudo mv path-to-transferred-files/certificateId-public.pem.key /greengrass/certs
sudo mv path-to-transferred-files/certificateId-private.pem.key /greengrass/certs
sudo mv path-to-transferred-files/AmazonRootCA1.pem /greengrass/certs
```
LeAWS IoT GreengrassLe logiciel principal utilise un fichier de configuration qui spécifie les paramètres du logiciel. Ce fichier de configuration spécifie les chemins d'accès aux fichiers de certificats et auxAWS CloudLes points de terminaison à utiliser. Au cours de cette étape, vous allez créer laAWS IoT GreengrassFichier de configuration du logiciel principal pour votre cœur. Procédez comme suit :
1. Obtenez l'Amazon Resource Name (ARN) pour votre noyauAWS IoTUn. Procédez comme suit :
  1. DansAWS IoTconsole, UNDERGérer, UNDERAppareils Greengrass, choisissezGroupes (V1).
  2. Dans la pageGroupes Greengrass, choisissez le groupe que vous avez créé précédemment.
  3. UNDERPrésentation, choisissezNoyau Greengrass.
  4. Sur la page des détails du noyau, copiez leAWS IoTARN d'objetet enregistrez-le pour l'utiliser dans leAWS IoT GreengrassFichier de configuration de Core.
2. ObtenezAWS IoTpoint de terminaison de données de votre appareilCompte AWSdans la région actuelle. Les appareils utilisent ce point de terminaison pour se connecter àAWScommeAWS IoTthings. Procédez comme suit :
  1. DansAWS IoTconsole, choisissezParamètres.
  2. UNDERPoint de terminaison des données, copiez lePoint de terminaisonet enregistrez-le pour l'utiliser dans leAWS IoT GreengrassFichier de configuration de Core.
3. Création de l'AWS IoT GreengrassFichier de configuration du logiciel principal. Par exemple, vous pouvez exécuter la commande suivante pour utiliser GNU nano pour créer le fichier.
```
sudo nano /greengrass/config/config.json
```
  Remplacez le contenu du fichier par le document JSON suivant.
```
{
  "coreThing" : {
    "caPath": "AmazonRootCA1.pem",
    "certPath": "certificateId-certificate.pem.crt",
    "keyPath": "certificateId-private.pem.key",
    "thingArn": "arn:aws:iot:region:account-id:thing/MyGreengrassV1Core",
    "iotHost": "device-data-prefix-ats.iot.region.amazonaws.com",
    "ggHost": "greengrass-ats.iot.region.amazonaws.com",
    "keepAlive": 600
  },
  "runtime": {
    "cgroup": {
      "useSystemd": "yes"
    }
  },
  "managedRespawn": false,
  "crypto": {
    "caPath": "file:///greengrass/certs/AmazonRootCA1.pem",
    "principals": {
      "SecretsManager": {
        "privateKeyPath": "file:///greengrass/certs/certificateId-private.pem.key"
      },
      "IoTCertificate": {
        "privateKeyPath": "file:///greengrass/certs/certificateId-private.pem.key",
        "certificatePath": "file:///greengrass/certs/certificateId-certificate.pem.crt"
      }
    }
  }
}
```
  Ensuite, procédez comme suit :
  - Si vous avez téléchargé un certificat d'autorité de certification racine Amazon différent de celui de l'autorité de certification racine Amazon 1, remplacez chaque instance deAmazonRootCA1.pemavec le nom du fichier CA racine Amazon.
  - Remplacez chaque instance decertificateIdavec l'ID du certificat dans le nom du certificat et des fichiers clés.
  - Remplacezarn:aws:IoT :région :id-compte:thingMyGreengrassCœur V1ARN de l'élément de noyau que vous avez enregistré précédemment.
  - RemplacezMyGreengrassNoyau V1Avec le nom de l'appareil de noyau.
  - Remplacezdevice-data-prefix-ats---iot---region.amazonaws.com.rproxy.goskope.comavec leAWS IoTPoint de terminaison de données d'appareil que vous avez enregistré précédemment.
  - RemplacezrégionAvec vos recettesRégion AWS.
  Pour en savoir plus sur les options de configuration que vous pouvez spécifier dans ce fichier de configuration, consultez la section.Fichier de configuration de AWS IoT Greengrass Core.
Vérifiez que votre appareil noyau est connecté à Internet. Ensuite, lancezAWS IoT GreengrassSur l'appareil noyau.
```
cd /greengrass/ggc/core/
sudo ./greengrassd start
```
Vous devez voir un message Greengrass successfully started. Notez le PID du rôle.

Note
Pour configurer votre appareil principal de manière à lancer AWS IoT Greengrass au démarrage du système, consultez Configuration du système d'initialisation pour le lancement du démon Greengrass.

Vos pouvez exécuter la commande suivante pour vérifier que le logiciel AWS IoT Greengrass Core (démon Greengrass) fonctionne. Remplacez PID-number par votre PID :
```
ps aux | grep PID-number
```
Vous devriez voir une entrée pour le PID avec un chemin vers le démon Greengrass en cours d'exécution (par exemple, /greengrass/ggc/packages/1.11.6/bin/daemon). Si vous rencontrez des problèmes pour démarrer AWS IoT Greengrass, consultez Résolution des problèmes de AWS IoT Greengrass.

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Création d'un groupe Greengrass

Module 3 (partie 1) : Fonctions Lambda surAWS IoT Greengrass