Installation AWS IoT Greengrass du logiciel Core avec provisionnement automatique des ressources

Pour configurer un appareil Linux pour AWS IoT Greengrass V2

1. Installez le moteur d'exécution Java, dont le logiciel AWS IoT Greengrass Core a besoin pour fonctionner. Nous vous recommandons d'utiliser les versions de support à long terme Amazon Corretto ou JDK Open. La version 8 ou supérieure est requise. Les commandes suivantes indiquent comment installer Open JDK sur votre appareil.

   • Pour les distributions basées sur Debian ou Ubuntu :

     sudo apt install default-jdk

   • Pour les distributions basées sur Red Hat :

     sudo yum install java-11-openjdk-devel

   • Dans Amazon Linux 2:

     sudo amazon-linux-extras install java-openjdk11

   • Pour Amazon Linux 2023 :

     sudo dnf install java-11-amazon-corretto -y

   Lorsque l'installation est terminée, exécutez la commande suivante pour vérifier que Java s'exécute sur votre appareil Linux.

   java -version

   La commande affiche la version de Java exécutée sur le périphérique. Par exemple, sur une distribution basée sur Debian, le résultat peut ressembler à celui de l'exemple suivant.

   openjdk version "11.0.9.1" 2020-11-04
   OpenJDK Runtime Environment (build 11.0.9.1+1-post-Debian-1deb10u2)
   OpenJDK 64-Bit Server VM (build 11.0.9.1+1-post-Debian-1deb10u2, mixed mode)

2. (Facultatif) Créez l'utilisateur système et le groupe par défaut qui exécutent les composants sur le périphérique. Vous pouvez également choisir de laisser le programme d'installation du logiciel AWS IoT Greengrass Core créer cet utilisateur et ce groupe lors de l'installation avec l'argument --component-default-user installer. Pour de plus amples informations, veuillez consulter Arguments d'installation.

   sudo useradd --system --create-home ggc_user
   sudo groupadd --system ggc_group

3. Vérifiez que l'utilisateur qui exécute le logiciel AWS IoT Greengrass Core (généralementroot) est autorisé à exécuter sudo avec n'importe quel utilisateur et n'importe quel groupe.

   1. Exécutez la commande suivante pour ouvrir le /etc/sudoers fichier.

      sudo visudo

   2. Vérifiez que l'autorisation accordée à l'utilisateur ressemble à l'exemple suivant.

      root    ALL=(ALL:ALL) ALL

4. (Facultatif) Pour exécuter des fonctions Lambda conteneurisées, vous devez activer cgroups v1, et vous devez activer et monter les cgroups de mémoire et de périphériques. Si vous ne prévoyez pas d'exécuter des fonctions Lambda conteneurisées, vous pouvez ignorer cette étape.

   Pour activer ces options cgroups, démarrez le périphérique avec les paramètres du noyau Linux suivants.

   cgroup_enable=memory cgroup_memory=1 systemd.unified_cgroup_hierarchy=0

   Pour plus d'informations sur l'affichage et la définition des paramètres du noyau de votre appareil, consultez la documentation de votre système d'exploitation et de votre chargeur de démarrage. Suivez les instructions pour définir définitivement les paramètres du noyau.

5. Installez toutes les autres dépendances requises sur votre appareil, comme indiqué dans la liste des exigences figurant dansExigences relatives aux dispositifs.

Pour configurer un appareil Windows pour AWS IoT Greengrass V2

1. Installez le moteur d'exécution Java, dont le logiciel AWS IoT Greengrass Core a besoin pour fonctionner. Nous vous recommandons d'utiliser les versions de support à long terme Amazon Corretto ou JDK Open. La version 8 ou supérieure est requise.

2. Vérifiez si Java est disponible sur la variable PATHsystème, et ajoutez-le dans le cas contraire. Le LocalSystem compte exécute le logiciel AWS IoT Greengrass Core. Vous devez donc ajouter Java à la variable PATH système au lieu de la variable PATH utilisateur de votre utilisateur. Procédez comme suit :

   1. Appuyez sur la touche Windows pour ouvrir le menu de démarrage.

   2. Tapez environment variables pour rechercher les options du système dans le menu Démarrer.

   3. Dans les résultats de recherche du menu Démarrer, choisissez Modifier les variables d'environnement du système pour ouvrir la fenêtre des propriétés du système.

   4. Choisissez les variables d'environnement... pour ouvrir la fenêtre des variables d'environnement.

   5. Sous Variables système, sélectionnez Chemin, puis Modifier. Dans la fenêtre Modifier la variable d'environnement, vous pouvez afficher chaque chemin sur une ligne distincte.

   6. Vérifiez si le chemin d'accès au bin dossier d'installation de Java est présent. Le chemin peut ressembler à celui de l'exemple suivant.

      C:\\Program Files\\Amazon Corretto\\jdk11.0.13_8\\bin

   7. Si le bin dossier de l'installation Java est absent de Path, choisissez Nouveau pour l'ajouter, puis OK.

3. Ouvrez l'invite de commande Windows (cmd.exe) en tant qu'administrateur.

4. Créez l'utilisateur par défaut dans le LocalSystem compte sur l'appareil Windows. Remplacez password avec un mot de passe sécurisé.

   net user /add ggc_user password

   Astuce

   En fonction de votre configuration Windows, le mot de passe de l'utilisateur peut être configuré pour expirer à une date ultérieure. Pour vous assurer que vos applications Greengrass continuent de fonctionner, suivez la date d'expiration du mot de passe et mettez-le à jour avant son expiration. Vous pouvez également définir le mot de passe de l'utilisateur pour qu'il n'expire jamais.

   • Pour vérifier la date d'expiration d'un utilisateur et de son mot de passe, exécutez la commande suivante.

     net user ggc_user | findstr /C:expires

   • Pour définir le mot de passe d'un utilisateur de manière à ce qu'il n'expire jamais, exécutez la commande suivante.

     wmic UserAccount where "Name='ggc_user'" set PasswordExpires=False

   • Si vous utilisez Windows 10 ou une version ultérieure où la wmiccommande est obsolète, exécutez la commande suivante PowerShell .

     Get-CimInstance -Query "SELECT * from Win32_UserAccount WHERE name = 'ggc_user'" | Set-CimInstance -Property @{PasswordExpires="False"}

5. Téléchargez et installez l'PsExecutilitaire de Microsoft sur l'appareil.

6. Utilisez l' PsExec utilitaire pour stocker le nom d'utilisateur et le mot de passe de l'utilisateur par défaut dans l'instance Credential Manager du LocalSystem compte. Remplacez password avec le mot de passe utilisateur que vous avez défini précédemment.

   psexec -s cmd /c cmdkey /generic:ggc_user /user:ggc_user /pass:password

   S'il PsExec License Agreements'ouvre, choisissez Acceptd'accepter la licence et exécutez la commande.

   Note

   Sur les appareils Windows, le LocalSystem compte exécute le noyau Greengrass, et vous devez utiliser l' PsExec utilitaire pour stocker les informations utilisateur par défaut dans le LocalSystem compte. L'application Credential Manager stocke ces informations dans le compte Windows de l'utilisateur actuellement connecté, plutôt que dans le LocalSystem compte.

Pour fournir des AWS informations d'identification à l'appareil

• Fournissez vos AWS informations d'identification à l'appareil afin que le programme d'installation puisse fournir les IAM ressources AWS IoT et les ressources pour votre appareil principal. Pour renforcer la sécurité, nous vous recommandons d'obtenir des informations d'identification temporaires pour un IAM rôle qui n'autorise que les autorisations minimales nécessaires au provisionnement. Pour de plus amples informations, veuillez consulter Politique IAM minimale permettant au programme d'installation de provisionner les ressources.

  Note

  Le programme d'installation n'enregistre ni ne stocke vos informations d'identification.

  Sur votre appareil, effectuez l'une des opérations suivantes pour récupérer les informations d'identification et les mettre à la disposition du programme d'installation du logiciel AWS IoT Greengrass Core :

  • (Recommandé) Utilisez des informations d'identification temporaires provenant de AWS IAM Identity Center

    1. Fournissez l'ID de la clé d'accès, la clé d'accès secrète et le jeton de session depuis le IAM Identity Center. Pour plus d'informations, voir Actualisation manuelle des informations d'identification dans la section Obtenir et actualiser des informations d'identification temporaires dans le guide de l'utilisateur d'IAMIdentity Center.

    2. Exécutez les commandes suivantes pour fournir les informations d'identification au logiciel AWS IoT Greengrass Core.

       Linux or Unix

       export AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
       export AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
       export AWS_SESSION_TOKEN=AQoDYXdzEJr1K...o5OytwEXAMPLE=

       Windows Command Prompt (CMD)

       set AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
       set AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
       set AWS_SESSION_TOKEN=AQoDYXdzEJr1K...o5OytwEXAMPLE=

       PowerShell

       $env:AWS_ACCESS_KEY_ID="AKIAIOSFODNN7EXAMPLE"
       $env:AWS_SECRET_ACCESS_KEY="wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY"
       $env:AWS_SESSION_TOKEN="AQoDYXdzEJr1K...o5OytwEXAMPLE="

  • Utilisez les informations d'identification de sécurité temporaires d'un IAM rôle :

    1. Fournissez l'ID de clé d'accès, la clé d'accès secrète et le jeton de session correspondant à un IAM rôle que vous assumez. Pour plus d'informations sur la façon de récupérer ces informations d'identification, consultez la section Demande d'informations d'identification de sécurité temporaires dans le guide de IAM l'utilisateur.

    2. Exécutez les commandes suivantes pour fournir les informations d'identification au logiciel AWS IoT Greengrass Core.

       Linux or Unix

       export AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
       export AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
       export AWS_SESSION_TOKEN=AQoDYXdzEJr1K...o5OytwEXAMPLE=

       Windows Command Prompt (CMD)

       set AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
       set AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
       set AWS_SESSION_TOKEN=AQoDYXdzEJr1K...o5OytwEXAMPLE=

       PowerShell

       $env:AWS_ACCESS_KEY_ID="AKIAIOSFODNN7EXAMPLE"
       $env:AWS_SECRET_ACCESS_KEY="wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY"
       $env:AWS_SESSION_TOKEN="AQoDYXdzEJr1K...o5OytwEXAMPLE="

  • Utilisez les informations d'identification à long terme d'un IAM utilisateur :

    1. Fournissez l'identifiant de la clé d'accès et la clé d'accès secrète de votre IAM utilisateur. Vous pouvez créer un IAM utilisateur pour le provisionnement, que vous supprimerez ultérieurement. Pour connaître la IAM politique à appliquer à l'utilisateur, voirPolitique IAM minimale permettant au programme d'installation de provisionner les ressources. Pour plus d'informations sur la façon de récupérer des informations d'identification à long terme, consultez la section Gestion des clés d'accès pour IAM les utilisateurs dans le Guide de IAM l'utilisateur.

    2. Exécutez les commandes suivantes pour fournir les informations d'identification au logiciel AWS IoT Greengrass Core.

       Linux or Unix

       export AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
       export AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY

       Windows Command Prompt (CMD)

       set AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
       set AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY

       PowerShell

       $env:AWS_ACCESS_KEY_ID="AKIAIOSFODNN7EXAMPLE"
       $env:AWS_SECRET_ACCESS_KEY="wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY"

    3. (Facultatif) Si vous avez créé un IAM utilisateur pour approvisionner votre appareil Greengrass, supprimez-le.

    4. (Facultatif) Si vous avez utilisé l'ID de clé d'accès et la clé d'accès secrète d'un IAM utilisateur existant, mettez à jour les clés de l'utilisateur afin qu'elles ne soient plus valides. Pour plus d'informations, consultez la section Mise à jour des clés d'accès dans le guide de AWS Identity and Access Management l'utilisateur.

Pour télécharger le logiciel AWS IoT Greengrass Core

1. Sur votre appareil principal, téléchargez le logiciel AWS IoT Greengrass Core dans un fichier nommégreengrass-nucleus-latest.zip.

   Linux or Unix

   curl -s https://d2s8p88vqu9w66.cloudfront.net/releases/greengrass-nucleus-latest.zip > greengrass-nucleus-latest.zip

   Windows Command Prompt (CMD)

   curl -s https://d2s8p88vqu9w66.cloudfront.net/releases/greengrass-nucleus-latest.zip > greengrass-nucleus-latest.zip

   PowerShell

   iwr -Uri https://d2s8p88vqu9w66.cloudfront.net/releases/greengrass-nucleus-latest.zip -OutFile greengrass-nucleus-latest.zip

   Si vous téléchargez ce logiciel, vous acceptez le contrat de licence du logiciel Greengrass Core.

2. (Facultatif) Pour vérifier la signature du logiciel Greengrass Nucleus

   Note

   Cette fonctionnalité est disponible avec Greengrass nucleus version 2.9.5 et versions ultérieures.

   1. Utilisez la commande suivante pour vérifier la signature de votre artefact Greengrass nucleus :

      Linux or Unix

      jarsigner -verify -certs -verbose greengrass-nucleus-latest.zip

      Windows Command Prompt (CMD)

      Le nom du fichier peut être différent selon la JDK version que vous installez. Remplacez jdk17,0,6_10 avec la JDK version que vous avez installée.

      "C:\\Program Files\\Amazon Corretto\\jdk17.0.6_10\\bin\\jarsigner.exe" -verify -certs -verbose greengrass-nucleus-latest.zip

      PowerShell

      Le nom du fichier peut être différent selon la JDK version que vous installez. Remplacez jdk17,0,6_10 avec la JDK version que vous avez installée.

      'C:\\Program Files\\Amazon Corretto\\jdk17.0.6_10\\bin\\jarsigner.exe' -verify -certs -verbose greengrass-nucleus-latest.zip

   2. L'jarsignerinvocation produit une sortie qui indique les résultats de la vérification.

      1. Si le fichier zip Greengrass nucleus est signé, le résultat contient l'instruction suivante :

         jar verified.

      2. Si le fichier zip Greengrass nucleus n'est pas signé, le résultat contient l'instruction suivante :

         jar is unsigned.

   3. Si vous avez fourni l'-certsoption Jarsigner en même temps que les -verbose options -verify et, le résultat inclut également des informations détaillées sur le certificat du signataire.

3. Décompressez le logiciel AWS IoT Greengrass Core dans un dossier de votre appareil. Remplacez GreengrassInstaller avec le dossier que vous souhaitez utiliser.

   Linux or Unix

   unzip greengrass-nucleus-latest.zip -d GreengrassInstaller && rm greengrass-nucleus-latest.zip

   Windows Command Prompt (CMD)

   mkdir GreengrassInstaller && tar -xf greengrass-nucleus-latest.zip -C GreengrassInstaller && del greengrass-nucleus-latest.zip

   PowerShell

   Expand-Archive -Path greengrass-nucleus-latest.zip -DestinationPath .\\GreengrassInstaller
   rm greengrass-nucleus-latest.zip

4. (Facultatif) Exécutez la commande suivante pour voir la version du logiciel AWS IoT Greengrass Core.

   java -jar ./GreengrassInstaller/lib/Greengrass.jar --version

Pour installer le logiciel AWS IoT Greengrass Core

1. Exécutez le programme d'installation AWS IoT Greengrass Core. Remplacez les valeurs des arguments dans votre commande comme suit.

   Note

   Pour Windows, la limitation de la longueur du chemin est de 260 caractères. Si vous utilisez Windows, utilisez un dossier racine tel que C:\greengrass\v2 ou D:\greengrass\v2 pour conserver les chemins des composants Greengrass en dessous de la limite de 260 caractères.

   1. /greengrass/v2 ou C:\greengrass\v2: chemin d'accès au dossier racine à utiliser pour installer le logiciel AWS IoT Greengrass Core.

   2. GreengrassInstaller. Le chemin d'accès au dossier dans lequel vous avez décompressé le programme d'installation du logiciel AWS IoT Greengrass Core.

   3. region. L' Région AWS endroit dans lequel trouver ou créer des ressources.

   4. MyGreengrassCore. Le nom de l' AWS IoT appareil principal de votre Greengrass. Si l'objet n'existe pas, le programme d'installation le crée. Le programme d'installation télécharge les certificats pour s'authentifier en tant qu' AWS IoT objet. Pour de plus amples informations, veuillez consulter Authentification et autorisation d'appareil pour AWS IoT Greengrass.

      Note

      Le nom de l'objet ne peut pas contenir de caractères deux-points (:).

   5. MyGreengrassCoreGroup. Le nom du AWS IoT groupe d'objets de votre appareil Greengrass principal. Si le groupe d'objets n'existe pas, le programme d'installation le crée et y ajoute l'objet. Si le groupe d'objets existe et fait l'objet d'un déploiement actif, le périphérique principal télécharge et exécute le logiciel spécifié par le déploiement.

      Note

      Le nom du groupe d'objets ne peut pas contenir de deux-points (:).

   6. GreengrassV2IoTThingPolicy. Le nom de la AWS IoT politique qui permet aux appareils principaux de Greengrass de communiquer avec AWS IoT et. AWS IoT Greengrass Si la AWS IoT politique n'existe pas, le programme d'installation crée une AWS IoT politique permissive portant ce nom. Vous pouvez restreindre les autorisations de cette politique pour votre cas d'utilisation. Pour de plus amples informations, veuillez consulter AWS IoTPolitique minimale pour les appareils AWS IoT Greengrass V2 principaux.

   7. GreengrassV2TokenExchangeRole. Nom du IAM rôle qui permet à l'appareil principal de Greengrass d'obtenir des informations d'identification temporaires AWS . Si le rôle n'existe pas, le programme d'installation le crée, puis crée et attache une politique nomméeGreengrassV2TokenExchangeRoleAccess. Pour de plus amples informations, veuillez consulter Autoriser les appareils principaux à interagir avec les AWS services.

   8. GreengrassCoreTokenExchangeRoleAlias. Alias du IAM rôle qui permet à l'appareil principal de Greengrass d'obtenir des informations d'identification temporaires ultérieurement. Si l'alias de rôle n'existe pas, le programme d'installation le crée et le pointe vers le IAM rôle que vous spécifiez. Pour de plus amples informations, veuillez consulter Autoriser les appareils principaux à interagir avec les AWS services.

   Linux or Unix

   sudo -E java -Droot="/greengrass/v2" -Dlog.store=FILE \
     -jar ./GreengrassInstaller/lib/Greengrass.jar \
     --aws-region region \
     --thing-name MyGreengrassCore \
     --thing-group-name MyGreengrassCoreGroup \
     --thing-policy-name GreengrassV2IoTThingPolicy \
     --tes-role-name GreengrassV2TokenExchangeRole \
     --tes-role-alias-name GreengrassCoreTokenExchangeRoleAlias \
     --component-default-user ggc_user:ggc_group \
     --provision true \
     --setup-system-service true

   Windows Command Prompt (CMD)

   java -Droot="C:\greengrass\v2" "-Dlog.store=FILE" ^
     -jar ./GreengrassInstaller/lib/Greengrass.jar ^
     --aws-region region ^
     --thing-name MyGreengrassCore ^
     --thing-group-name MyGreengrassCoreGroup ^
     --thing-policy-name GreengrassV2IoTThingPolicy ^
     --tes-role-name GreengrassV2TokenExchangeRole ^
     --tes-role-alias-name GreengrassCoreTokenExchangeRoleAlias ^
     --component-default-user ggc_user ^
     --provision true ^
     --setup-system-service true

   PowerShell

   java -Droot="C:\greengrass\v2" "-Dlog.store=FILE" `
     -jar ./GreengrassInstaller/lib/Greengrass.jar `
     --aws-region region `
     --thing-name MyGreengrassCore `
     --thing-group-name MyGreengrassCoreGroup `
     --thing-policy-name GreengrassV2IoTThingPolicy `
     --tes-role-name GreengrassV2TokenExchangeRole `
     --tes-role-alias-name GreengrassCoreTokenExchangeRoleAlias `
     --component-default-user ggc_user `
     --provision true `
     --setup-system-service true

   Important

   Sur les appareils Windows Core, vous --setup-system-service true devez spécifier de configurer le logiciel AWS IoT Greengrass Core en tant que service système.

   Le programme d'installation affiche les messages suivants en cas de succès :

   • Si vous le spécifiez--provision, le programme d'installation imprime Successfully configured Nucleus with provisioned resource details s'il a correctement configuré les ressources.

   • Si vous le spécifiez--deploy-dev-tools, le programme d'installation affiche Configured Nucleus to deploy aws.greengrass.Cli component s'il a créé le déploiement avec succès.

   • Si vous le spécifiez--setup-system-service true, le programme d'installation affiche Successfully set up Nucleus as a system service s'il a configuré et exécuté le logiciel en tant que service.

   • Si vous ne le spécifiez pas--setup-system-service true, le programme d'installation affiche Launched Nucleus successfully s'il a réussi et a exécuté le logiciel.

2. Ignorez cette étape si vous avez installé la Noyau de Greengrass version 2.0.4 ou une version ultérieure. Si vous avez téléchargé la dernière version du logiciel, vous avez installé la version 2.0.4 ou ultérieure.

   Exécutez la commande suivante pour définir les autorisations de fichier requises pour le dossier racine de votre logiciel AWS IoT Greengrass Core. Remplacez /greengrass/v2 par le dossier racine que vous avez spécifié dans votre commande d'installation, puis remplacez /greengrass avec le dossier parent de votre dossier racine.

   sudo chmod 755 /greengrass/v2 && sudo chmod 755 /greengrass