Avis de fin de support : le 7 octobre 2026, AWS le support pour 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.
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.
Configuration d'une instance Amazon EC2
Suivez les étapes décrites dans cette rubrique pour configurer une instance Amazon EC2 à utiliser comme instance AWS IoT Greengrass principale.
Astuce
Ou, pour utiliser un script qui configure votre environnement et installe le logiciel AWS IoT Greengrass Core pour vous, consultezDémarrage rapide : Configuration de l'appareil Greengrass.
Bien que vous puissiez suivre ce didacticiel à l'aide d'une instance Amazon EC2, AWS IoT Greengrass il devrait idéalement être utilisé avec du matériel physique. Nous vous recommandons de configurer un Raspberry Pi au lieu d'utiliser une instance Amazon EC2 lorsque cela est possible. Si vous utilisez un Raspberry Pi, vous n'avez pas besoin de suivre les étapes de cette rubrique.
-
Connectez-vous au Console de gestion AWS
et lancez une instance Amazon EC2 à l'aide d'une AMI Amazon Linux. Pour plus d'informations sur les instances Amazon EC2, consultez le guide de démarrage d'Amazon EC2. -
Une fois que votre instance Amazon EC2 est en cours d'exécution, activez le port 8883 pour autoriser les communications MQTT entrantes afin que d'autres appareils puissent se connecter au cœur. AWS IoT Greengrass
-
Dans le volet de navigation de la console Amazon EC2, choisissez Security Groups.
-
Sélectionnez le groupe de sécurité pour l'instance que vous venez de lancer, puis choisissez l'onglet Règles entrantes.
-
Choisissez Modifier les règles entrantes.
Pour activer le port 8883, vous devez ajouter une règle TCP personnalisée au groupe de sécurité. Pour plus d'informations, consultez la section Ajouter des règles à un groupe de sécurité dans le guide de l'utilisateur Amazon EC2.
-
Sur la page Modifier les règles entrantes, choisissez Ajouter une règle, entrez les paramètres suivants, puis choisissez Enregistrer.
-
Pour Type, choisissez Règle TCP personnalisée.
-
Dans la zone Plage de ports, entrez
8883. -
Pour Source, choisissez N'importe où.
-
Pour Description, saisissez
MQTT Communications.
-
-
-
Connectez-vous à votre instance EC2 Amazon.
-
Dans le panneau de navigation, choisissez Instances, puis sélectionnez votre instance et choisissez Connexion.
-
Suivez les instructions de la page Connectez-vous à votre instance pour vous connecter à votre instance l'aide de SSH et de votre fichier de clé privée.
Vous pouvez utiliser PuTTY pour Windows ou Terminal pour macOS. Pour plus d'informations, consultez la section Connexion à votre instance Linux dans le guide de l'utilisateur Amazon EC2.
Vous êtes maintenant prêt à configurer votre instance Amazon EC2 pour AWS IoT Greengrass.
-
-
Une fois connecté à votre instance Amazon EC2, créez les
ggc_groupcomptesggc_useret :sudo adduser --system ggc_user sudo groupadd --system ggc_groupNote
Si la commande
addusern'est pas disponible sur votre système, utilisez la commande suivante.sudo useradd --system ggc_user -
Pour améliorer la sécurité, assurez-vous que les protections contre les liens physiques et les liens logiciels (liens symboliques) sont activées sur le système d'exploitation de l'instance Amazon EC2 au démarrage.
Note
Les étapes permettant d'activer les protections hardlink et softlink varient selon le système d'exploitation. Consultez la documentation de votre distribution.
-
Exécutez la commande suivante pour vérifier si les protections hardlink et softlink sont activées :
sudo sysctl -a | grep fs.protectedSi les protections hardlink et softlinks sont définies sur
1, vos protections sont correctement activées. Passez à l'étape 6.Note
Les protections softlink sont représentées par
fs.protected_symlinks. -
Si les protections hardlink et softlink ne sont pas définies sur
1, activez ces protections. Accédez au fichier de configuration du système.cd /etc/sysctl.d ls -
À l'aide de l'éditeur de texte de votre choix (tel que Leafpad, GNU nano ou vi), ajoutez les deux lignes suivantes à la fin du fichier de configuration du système. Sur Amazon Linux 1, il s'agit du fichier
00-defaults.conf. Sur Amazon Linux 2, il s'agit du fichier99-amazon.conf. Vous devrez peut-être modifier les autorisations du fichier (à l'aide de la commandechmod) afin de pouvoir écrire sur ce fichier, ou utiliser la commandesudopour le modifier en tant qu'utilisateur racine (par exemple,sudo nano).00-defaults.conffs.protected_hardlinks = 1 fs.protected_symlinks = 1 -
Redémarrez l'instance Amazon EC2.
sudo rebootAprès quelques minutes, connectez-vous à votre instance à l'aide de SSH, puis exécutez la commande suivante pour confirmer la modification.
sudo sysctl -a | grep fs.protectedVous devriez voir que les protections hardlink et softlink sont définies avec la valeur 1.
-
-
Extrayez et exécutez le script suivant pour monter des groupes de contrôle Linux
(cgroups). Cela permet AWS IoT Greengrass de définir la limite de mémoire pour les fonctions Lambda. Les groupes C doivent également s'exécuter AWS IoT Greengrass dans le mode de Considérations à prendre en compte lors du choix de la conteneurisation des fonctions Lambda conteneurisation par défaut. curl https://raw.githubusercontent.com/tianon/cgroupfs-mount/951c38ee8d802330454bdede20d85ec1c0f8d312/cgroupfs-mount > cgroupfs-mount.sh chmod +x cgroupfs-mount.sh sudo bash ./cgroupfs-mount.shVotre instance Amazon EC2 devrait maintenant être prête pour AWS IoT Greengrass.
-
Facultatif. Installez l'environnement d'exécution Java 8, qui est requis par le gestionnaire de flux. Ce didacticiel n'utilise pas le gestionnaire de flux, mais il utilise le flux de travail Default Group creation (Création du groupe par défaut) qui active le gestionnaire de flux par défaut. Utilisez les commandes suivantes pour installer l'environnement d'exécution Java 8 sur l'appareil principal, ou désactivez le gestionnaire de flux avant de déployer votre groupe. Les instructions permettant de désactiver le gestionnaire de flux sont fournies dans le module 3.
-
Pour les Debian-based distributions :
sudo apt install openjdk-8-jdk -
Pour les Hat-based distributions Red :
sudo yum install java-1.8.0-openjdk
-
-
Pour vous assurer que vous disposez de toutes les dépendances requises, téléchargez et exécutez le vérificateur de dépendances Greengrass depuis le référentiel
AWS IoT Greengrass Samples sur. GitHub Ces commandes téléchargent, décompressent et exécutent le script de vérification des dépendances dans votre instance Amazon EC2. mkdir greengrass-dependency-checker-GGCv1.11.x cd greengrass-dependency-checker-GGCv1.11.x wget https://github.com/aws-samples/aws-greengrass-samples/raw/master/greengrass-dependency-checker-GGCv1.11.x.zip unzip greengrass-dependency-checker-GGCv1.11.x.zip cd greengrass-dependency-checker-GGCv1.11.x sudo ./check_ggc_dependencies | moreImportant
Ce didacticiel nécessite le moteur d'exécution Python 3.7 pour exécuter les fonctions Lambda locales. Lorsque le gestionnaire de flux est activé, il a également besoin de l'environnement d'exécution Java 8. Si le script
check_ggc_dependenciesgénère des avertissements concernant des environnements d'exécution prérequis manquants, veillez à installer ces environnements d'exécution avant de continuer. Vous pouvez ignorer les avertissements concernant d'autres environnements d'exécution facultatifs manquants.
La configuration de votre instance Amazon EC2 est terminée. Passez au Module 2 : Installation du AWS IoT Greengrass Logiciel de base.