Avis de fin de support : le 7 octobre 2026, AWS le support de. AWS IoT Greengrass Version 1 Après le 7 octobre 2026, vous ne pourrez plus accéder aux AWS IoT Greengrass V1 ressources. Pour plus d'informations, rendez-vous sur [Migrer depuis AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html).
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écution AWS IoT Greengrass sur le périphérique principal
**Note**
Ce didacticiel fournit des instructions pour exécuter le logiciel AWS IoT Greengrass Core sur un Raspberry Pi, mais vous pouvez utiliser n'importe quel appareil compatible.
Dans cette section, vous allez configurer, installer et exécuter le logiciel AWS IoT Greengrass Core sur votre appareil principal.
**Pour installer et exécuter AWS IoT Greengrass**
1. Dans la section du [logiciel AWS IoT Greengrass Core](what-is-gg.md#gg-core-download-tab) de ce guide, téléchargez le package d'installation du logiciel AWS IoT Greengrass 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 le Raspberry Pi, téléchargez le package pour l'architecture ARMv7L et le système d'exploitation Linux.
+ Pour une EC2 instance Amazon, téléchargez le package pour l'architecture x86\$164 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\$164 et le système d'exploitation Linux.
1. 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 le logiciel AWS IoT Greengrass principal qui s'exécute sur le périphérique principal.
+ `certificateId-certificate.pem.crt`— Le fichier de certificat de l'appareil.
+ `certificateId-public.pem.key`— Le fichier de clé publique du certificat de l'appareil.
+ `certificateId-private.pem.key`— Le fichier de clé privée du certificat de l'appareil.
+ `AmazonRootCA1.pem`— Le fichier de l'autorité de certification racine (CA) Amazon.
Au cours de cette étape, vous transférez ces fichiers de votre ordinateur vers votre appareil principal. Procédez comme suit :
1. Si vous ne connaissez pas l'adresse IP de votre appareil principal Greengrass, ouvrez un terminal sur l'appareil principal 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
```
1. Transférez ces fichiers de votre ordinateur vers votre appareil principal. Les étapes de transfert de fichiers 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](https://winscp.net/eng/download.php) ou la commande [PuTTY](https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html) **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 indiqué dans cette commande doit correspondre à la version de votre progiciel 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. *path-to-downloaded-files*C'est 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 indiqué dans cette commande doit correspondre à la version de votre progiciel 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 indiqué dans cette commande doit correspondre à la version de votre progiciel 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, les fichiers doivent se trouver dans le `~/Downloads` dossier du Raspberry Pi, par exemple`/home/pi/Downloads`. Sinon, les fichiers compressés doivent se trouver dans le `~` dossier du Pi, par exemple`/home/pi`.
------
1. Sur l'appareil principal Greengrass, ouvrez un terminal et accédez au dossier contenant le logiciel et les AWS IoT Greengrass certificats Core. *path-to-transferred-files*Remplacez-le par le chemin où vous avez transféré les fichiers sur le périphérique principal. Par exemple, sur un Raspberry Pi, lancez`cd /home/pi`.
```
cd path-to-transferred-files
```
1. Déballez le logiciel AWS IoT Greengrass Core sur le périphérique principal. Exécutez la commande suivante pour décompresser l'archive logicielle que vous avez transférée sur le périphérique principal. Cette commande utilise l'`-C /`argument pour créer le `/greengrass` dossier dans le dossier racine du périphérique principal.
```
sudo tar -xzvf greengrass-OS-architecture-1.11.6.tar.gz -C /
```
**Note**
Le numéro de version indiqué dans cette commande doit correspondre à la version de votre progiciel AWS IoT Greengrass Core.
1. Déplacez les certificats et les clés vers le dossier du logiciel AWS IoT Greengrass principal. Exécutez les commandes suivantes pour créer un dossier pour les certificats et y déplacer les certificats et les clés. *path-to-transferred-files*Remplacez-le par le chemin où vous avez transféré les fichiers sur le périphérique principal, et remplacez-le *certificateId* par l'ID du certificat dans les noms de fichiers. Par exemple, sur un Raspberry Pi, remplacez *path-to-transferred-files* par **/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
```
1. Le logiciel AWS IoT Greengrass Core utilise un fichier de configuration qui spécifie les paramètres du logiciel. Ce fichier de configuration indique les chemins des fichiers de certificats et les AWS Cloud points de terminaison à utiliser. Au cours de cette étape, vous créez le fichier de configuration du logiciel AWS IoT Greengrass Core pour votre cœur. Procédez comme suit :
1. Obtenez le nom de ressource Amazon (ARN) correspondant à votre activité AWS IoT principale. Procédez comme suit :
1. Dans la [AWS IoT console](https://console.aws.amazon.com/iot), sous **Gérer**, sous **Appareils Greengrass**, choisissez **Groups (V1)**.
1. Sur la page des **groupes Greengrass**, choisissez le groupe que vous avez créé précédemment.
1. Sous **Vue d'ensemble**, choisissez **Greengrass core**.
1. Sur la page de détails de base, copiez l'**ARN de l'AWS IoT objet** et enregistrez-le pour l'utiliser dans le fichier de configuration AWS IoT Greengrass Core.
1. Obtenez le point de terminaison de données de votre AWS IoT appareil Compte AWS dans la région actuelle. Les appareils utilisent ce point de terminaison pour se connecter AWS en tant qu' AWS IoT objets. Procédez comme suit :
1. Dans la [AWS IoT console](https://console.aws.amazon.com/iot), choisissez **Réglages**.
1. Sous Point de **terminaison des données de l'appareil**, copiez le **point de terminaison** et enregistrez-le pour l'utiliser dans le fichier de configuration AWS IoT Greengrass principal.
1. Créez le fichier de configuration du logiciel AWS IoT Greengrass Core. 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 Amazon Root CA différent de celui d'Amazon Root CA 1, remplacez chaque instance de *AmazonRootCA1.pem* par le nom du fichier Amazon Root CA.
+ Remplacez chaque instance de *certificateId* par l'ID du certificat dans le nom du certificat et des fichiers clés.
+ *arn:aws:iot:*region*:*account-id*:thing/MyGreengrassV1Core*Remplacez-le par l'ARN de l'objet de votre cœur que vous avez enregistré plus tôt.
+ *MyGreengrassV1core*Remplacez-le par le nom de votre objet principal.
+ *device-data-prefix-ats.iot.region.amazonaws.com*Remplacez-le par le point de terminaison de données de l' AWS IoT appareil que vous avez enregistré précédemment.
+ *region*Remplacez-le par votre Région AWS.
Pour plus d'informations sur les options de configuration que vous pouvez spécifier dans ce fichier de configuration, consultez[AWS IoT Greengrass fichier de configuration de base](gg-core.md#config-json).
1. Vérifiez que votre appareil noyau est connecté à Internet. Ensuite, commencez AWS IoT Greengrass sur votre appareil principal.
```
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 périphérique principal afin qu'il démarre AWS IoT Greengrass au démarrage du système, consultez[Configuration du système d'initialisation pour le lancement du démon Greengrass](gg-core.md#start-on-boot).
Vous pouvez exécuter la commande suivante pour vérifier que le logiciel AWS IoT Greengrass principal (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 lors du démarrage AWS IoT Greengrass, consultez[Résolution des problèmes AWS IoT Greengrass](gg-troubleshooting.md).