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 du logiciel AWS IoT Greengrass Core (console)
<a name="install-greengrass-v2-console"></a>

1. Connectez-vous à la [console AWS IoT Greengrass](https://console.aws.amazon.com/greengrass).

1. Sous **Commencer avec Greengrass**, choisissez **Configurer l'appareil principal**.

1. Dans **Étape 1 : Enregistrer un appareil Greengrass Core**, dans le champ **Nom de l'appareil Core**, entrez le nom de l' AWS IoT appareil Greengrass Core. Si l'objet n'existe pas, le programme d'installation le crée.

1. Dans **Étape 2 : Ajouter à un groupe d'objets pour appliquer un déploiement continu**, pour le **groupe** d'objets, choisissez le AWS IoT groupe d'objets auquel vous souhaitez ajouter votre appareil principal. 
   + Si vous sélectionnez **Entrez un nouveau nom de groupe**, dans **Nom du groupe** d'objets, entrez le nom du nouveau groupe à créer. Le programme d'installation crée le nouveau groupe pour vous.
   + Si vous sélectionnez **Sélectionner un groupe existant**, dans **Nom du groupe** d'objets, choisissez le groupe existant que vous souhaitez utiliser.
   + Si vous sélectionnez **Aucun groupe**, le programme d'installation n'ajoute pas le périphérique principal à un groupe d'objets.

1. Dans **Étape 3 : Installation du logiciel Greengrass Core, effectuez** les étapes suivantes.

------
#### [ Nucleus classic ]

   1. Choisissez **Nucleus classic** comme moteur d'exécution du logiciel principal de votre appareil.

   1. Choisissez le système d'exploitation de votre appareil principal : **Linux** ou **Windows**.

   1. <a name="installer-export-aws-credentials"></a>Fournissez vos AWS informations d'identification à l'appareil afin que le programme d'installation puisse fournir les ressources AWS IoT et IAM pour votre appareil principal. Pour renforcer la sécurité, nous vous recommandons d'obtenir des informations d'identification temporaires pour un rôle IAM qui n'accorde 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](provision-minimal-iam-policy.md).
**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 clé d'accès, la clé d'accès secrète et le jeton de session provenant du centre d'identité IAM. Pour plus d'informations, voir Actualisation **manuelle des informations d'identification dans la section Obtenir et actualiser** [des informations d'identification temporaires](https://docs.aws.amazon.com/singlesignon/latest/userguide/howtogetcredentials.html#how-to-get-temp-credentials) dans le guide de l'*utilisateur d'IAM Identity Center*.

        1. 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 issues d'un rôle IAM :

        1. Fournissez l'ID de clé d'accès, la clé d'accès secrète et le jeton de session correspondant au rôle IAM 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](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_request.html) dans le *guide de l'utilisateur IAM*.

        1. 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 utilisateur IAM :

        1. Fournissez l'ID de clé d'accès et la clé d'accès secrète pour votre utilisateur IAM. Vous pouvez créer un utilisateur IAM pour le provisionnement, que vous supprimerez ultérieurement. Pour connaître la politique IAM à communiquer à l'utilisateur, consultez[Politique IAM minimale permettant au programme d'installation de provisionner les ressources](provision-minimal-iam-policy.md). 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 les utilisateurs IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html) dans le guide de l'*utilisateur IAM*.

        1. 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}}"
           ```

------

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

        1. (Facultatif) Si vous avez utilisé l'ID de clé d'accès et la clé d'accès secrète d'un utilisateur IAM existant, mettez à jour les clés de cet utilisateur afin qu'elles ne soient plus valides. Pour plus d'informations, consultez la section [Mise à jour des clés d'accès](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html#Using_RotateAccessKey) dans le *guide de Gestion des identités et des accès AWS l'utilisateur*.

   1. Sous **Exécuter le programme d'installation**, effectuez les étapes suivantes.

      1. Sous **Télécharger le programme d'installation**, choisissez **Copier** et exécutez la commande copiée sur votre appareil principal. Cette commande télécharge la dernière version du logiciel AWS IoT Greengrass Core et la décompresse sur votre appareil.

      1. Sous **Exécuter le programme d'installation**, choisissez **Copier, puis** exécutez la commande copiée sur votre appareil principal. Cette commande utilise les AWS IoT noms d'objets et de groupes d'objets que vous avez spécifiés précédemment pour exécuter le programme d'installation du logiciel AWS IoT Greengrass Core et configurer les AWS ressources pour votre périphérique principal.

         Cette commande effectue également les opérations suivantes :
         + <a name="install-argument-system-service"></a>Configurez le logiciel AWS IoT Greengrass Core en tant que service système qui s'exécute au démarrage. Sur les appareils Linux, cela nécessite le [système d'initialisation Systemd](https://en.wikipedia.org/wiki/Systemd).
**Important**  <a name="windows-system-service-requirement-important-note"></a>
Sur les appareils Windows Core, vous devez configurer le logiciel AWS IoT Greengrass Core en tant que service système.
         + <a name="install-argument-dev-tools"></a>Déployez le [composant AWS IoT Greengrass CLI](gg-cli.md), qui est un outil de ligne de commande qui vous permet de développer des composants Greengrass personnalisés sur le périphérique principal.
         + <a name="install-argument-component-default-user"></a>Spécifiez l'utilisation de l'utilisateur `ggc_user` du système pour exécuter les composants logiciels sur le périphérique principal. Sur les appareils Linux, cette commande indique également d'utiliser le groupe `ggc_group` système, et le programme d'installation crée l'utilisateur et le groupe système pour vous.

         Lorsque vous exécutez cette commande, les messages suivants devraient s'afficher pour indiquer que le programme d'installation a réussi.

         ```
         Successfully configured Nucleus with provisioned resource details!
         Configured Nucleus to deploy aws.greengrass.Cli component
         Successfully set up Nucleus as a system service
         ```
**Note**  <a name="installer-linux-no-systemd-message"></a>
Si vous possédez un appareil Linux et qu'il n'est pas doté de [systemd](https://en.wikipedia.org/wiki/Systemd), le programme d'installation ne configurera pas le logiciel en tant que service système et vous ne verrez pas le message de confirmation de configuration du noyau en tant que service système.

------
#### [ Nucleus lite ]

   1. Choisissez **Nucleus lite** comme moteur d'exécution du logiciel principal de votre appareil.

   1. Sélectionnez la méthode de configuration de votre appareil pour connecter votre appareil à un appareil Greengrass Core.

   **Option 1 : configurer un appareil avec téléchargement du package (environ 1 Mo)**

   1. Créez un AWS IoT objet et un rôle pour Greengrass.

   1. Téléchargez le fichier zip contenant AWS IoT les ressources auxquelles votre appareil doit se connecter AWS IoT :
      + Un certificat et une clé privée générés à l'aide AWS IoT de l'autorité de certification.
      + Un fichier de schéma pour lancer l'installation de Greengrass sur votre appareil.

   1. Téléchargez le package qui installera le dernier runtime Greengrass Nucleus lite sur votre Raspberry Pi.

   1. Provisionnez votre appareil pour qu'il devienne un appareil AWS IoT Greengrass Core et connectez-le à AWS IoT :

      1. a. Transférez le package Greengrass et le kit de connexion sur votre appareil à l'aide d'une clé USB, d'un SCP/FTP ou d'une carte SD.

      1. b. Décompressez le fichier greengrass-package.zip dans le GreengrassInstaller répertoire/de l'appareil.

      1. c. Décompressez le fichier zip du kit de connexion dans le répertoire /de l'appareil. 

      1. d. Exécutez la commande fournie sur le périphérique à installer AWS IoT Greengrass

   1. Choisissez ensuite **Afficher les principaux appareils**.

   **Option 2 : configurer un appareil avec un téléchargement d'exemple d'image préconfiguré sur l'ensemble du disque (environ 100 Mo)**

   1. Créez un AWS IoT objet et un rôle pour Greengrass.

   1. Téléchargez le fichier zip contenant AWS IoT les ressources auxquelles votre appareil doit se connecter AWS IoT :
      + Un certificat et une clé privée générés à l'aide AWS IoT de l'autorité de certification.
      + Un fichier de schéma pour lancer l'installation de Greengrass sur votre appareil.

   1. Téléchargez l'image d'exemple de disque entier préconfigurée qui contient Greengrass et le système d'exploitation.

      1. Pour transférer le kit de connexion et flasher l'image sur votre appareil, suivez le fichier readme téléchargé avec l'image.

      1. Pour démarrer l'installation de Greengrass, allumez et démarrez l'appareil à partir de l'image clignotée

   1. Choisissez ensuite **Afficher les principaux appareils**.

   **Option 3 : configurer un appareil avec votre propre version personnalisée**

   1. Créez un AWS IoT objet et un rôle pour Greengrass.

   1. Téléchargez le fichier zip contenant AWS IoT les ressources auxquelles votre appareil doit se connecter AWS IoT :
      + Un certificat et une clé privée générés à l'aide AWS IoT de l'autorité de certification.
      + Un fichier de schéma pour lancer l'installation de Greengrass sur votre appareil.

   1. Pour personnaliser et créer votre propre image à l'aide de Yocto à partir du code source, puis utiliser le kit de connexion pour installer Nucleus Lite, suivez les instructions ci-dessous. GitHub

      1. Choisissez ensuite **Afficher les principaux appareils**.

------