Installer le logiciel AWS IoT Greengrass Core

Pour désinstaller le logiciel AWS IoT Greengrass principal et conserver les informations de configuration

• Exécutez la commande suivante pour supprimer les AWS IoT Greengrass principaux packages logiciels et conserver les informations de configuration dans le /greengrass dossier.

  sudo apt remove aws-iot-greengrass-core aws-iot-greengrass-keyring

Pour désinstaller le logiciel AWS IoT Greengrass principal et supprimer les informations de configuration

1. Exécutez la commande suivante pour supprimer les AWS IoT Greengrass principaux packages logiciels et supprimer les informations de configuration du/greengrass folder.

   sudo apt purge aws-iot-greengrass-core aws-iot-greengrass-keyring

2. Supprimez le référentiel logiciel AWS IoT Greengrass principal de votre liste de sources. Pour plus d’informations, consultez Supprimer les AWS IoT Greengrass principales sources du référentiel de logiciels.

Pour supprimer le dépôt APT de la liste des sources

• Exécutez les commandes suivantes pour supprimer le référentiel logiciel AWS IoT Greengrass principal de la liste des sources.

  sudo rm /etc/apt/sources.list.d/greengrass.list
  sudo apt update

1. Installez le core18 snap en exécutant la commande suivante sur le terminal de votre appareil :

   sudo snap install core18

   Le core18 snap est un snap de base qui fournit un environnement d'exécution avec des bibliothèques couramment utilisées. Ce snap est construit à partir d'Ubuntu 18.04 LTS.

2. Effectuez snapd la mise à niveau en exécutant la commande suivante :

   sudo snap install --channel=edge snapd; sudo snap refresh --channel=edge snapd

3. Exécutez la snap list commande pour vérifier si le AWS IoT Greengrass snap est installé.

   L'exemple de réponse suivant montre que cela snapd est installé, mais ne l'aws-iot-greengrassest pas.

   Name              Version               Rev    Tracking         Publisher   Notes
   amazon-ssm-agent  3.0.161.0             2996   latest/stable/…  aws✓        classic
   core              16-2.48               10444  latest/stable    canonical✓  core
   core18            20200929              1932   latest/stable    canonical✓  base
   lxd               4.0.4                 18150  4.0/stable/…     canonical✓  -
   snapd             2.48+git548.g929ccfb  10526  latest/edge      canonical✓  snapd

4. Choisissez l'une des options suivantes pour installer AWS IoT Greengrass snap 1.11.x.

   • Pour installer le AWS IoT Greengrass snap, exécutez la commande suivante :

     sudo snap install aws-iot-greengrass

     Exemple de réponse :

     aws-iot-greengrass 1.11.5 from Amazon Web Services (aws) installed

   • Pour migrer d'une version antérieure vers la version v1.11.x ou effectuer une mise à jour vers la dernière version de correctif disponible, exécutez la commande suivante :

     sudo snap refresh --channel=1.11.x aws-iot-greengrass

   Comme les autres snaps, le AWS IoT Greengrass snap utilise des canaux pour gérer les versions mineures. Les snaps sont automatiquement mis à jour avec la dernière version disponible de la chaîne actuelle. Par exemple, si vous le spécifiez--channel=1.11.x, votre AWS IoT Greengrass snap est mis à jour vers la version v1.11.5.

   Vous pouvez exécuter la snap info aws-iot-greengrass commande pour obtenir la liste des chaînes disponibles pourAWS IoT Greengrass.

   Exemple de réponse :

   name:      aws-iot-greengrass
   summary:   AWS supported software that extends cloud capabilities to local devices.
   publisher: Amazon Web Services (aws✓)
   store-url: https://snapcraft.io/aws-iot-greengrass
   contact:   https://repost.aws/tags/TA4ckIed1sR4enZBey29rKTg/aws-io-t-greengrass
   license:   Proprietary
   description: |
     AWS IoT Greengrass seamlessly extends AWS onto edge devices so they can act locally on the data
     they generate, while still using the cloud for management, analytics, and durable storage.
     AWS IoT Greenrgrass snap v1.11.0 enables you to run a limited version of AWS IoT Greengrass with
     all necessary dependencies in a containerized environment.
     The AWS IoT Greengrass snap doesn't support connectors and machine learning (ML) inference.
     By downloading this software you agree to the Greengrass Core Software License Agreement
     (https://s3-us-west-2.amazonaws.com/greengrass-release-license/greengrass-license-v1.pdf).
     For more information, see Run AWS IoT Greengrass in a snap
     (https://docs.aws.amazon.com/greengrass/latest/developerguide/install-ggc.html#gg-snap-support) in
     the AWS IoT Greengrass Developer.
     If you need help, try the AWS IoT Greengrass tag on AWS re:Post
     (https://repost.aws/tags/TA4ckIed1sR4enZBey29rKTg/aws-io-t-greengrass) or connect with an AWS IQ expert
     (https://iq.aws.amazon.com/services/aws/greengrass).
   snap-id: SRDuhPJGj4XPxFNNZQKOTvURAp0wxKnd
   channels:
     latest/stable:    1.11.3 2021-06-15 (59) 111MB -
     latest/candidate: 1.11.3 2021-06-14 (59) 111MB -
     latest/beta:      1.11.3 2021-06-14 (59) 111MB -
     latest/edge:      1.11.3 2021-06-14 (59) 111MB -
     1.11.x/stable:    1.11.3 2021-06-15 (59) 111MB -
     1.11.x/candidate: 1.11.3 2021-06-15 (59) 111MB -
     1.11.x/beta:      1.11.3 2021-06-15 (59) 111MB -
     1.11.x/edge:      1.11.3 2021-06-15 (59) 111MB -

5. Pour accéder aux ressources spécifiques dont vos fonctions Lambda ont besoin, vous pouvez vous connecter à des interfaces supplémentaires.

   Exécutez la commande suivante pour obtenir la liste des interfaces prises en charge par AWS IoT Greengrass Snap :

   snap connections aws-iot-greengrass

   Exemple de réponse :

   Interface                Plug                                                Slot                 Notes
   camera                   aws-iot-greengrass:camera                           -                    -
   dvb                      aws-iot-greengrass:dvb                              -                    -
   gpio                     aws-iot-greengrass:gpio                             -                    -
   gpio-memory-control      aws-iot-greengrass:gpio-memory-control              -                    -
   greengrass-support       aws-iot-greengrass:greengrass-support-no-container  :greengrass-support  -
   hardware-observe         aws-iot-greengrass:hardware-observe                 :hardware-observe    manual
   hardware-random-control  aws-iot-greengrass:hardware-random-control          -                    -
   home                     aws-iot-greengrass:home-for-greengrassd             -                    -
   home                     aws-iot-greengrass:home-for-hooks                   :home                manual
   hugepages-control        aws-iot-greengrass:hugepages-control                :hugepages-control   manual
   i2c                      aws-iot-greengrass:i2c                              -                    -
   iio                      aws-iot-greengrass:iio                              -                    -
   joystick                 aws-iot-greengrass:joystick                         -                    -
   log-observe              aws-iot-greengrass:log-observe                      :log-observe         manual
   mount-observe            aws-iot-greengrass:mount-observe                    :mount-observe       manual
   network                  aws-iot-greengrass:network                          :network             -
   network-bind             aws-iot-greengrass:network-bind                     :network-bind        -
   network-control          aws-iot-greengrass:network-control                  :network-control     -
   opengl                   aws-iot-greengrass:opengl                           :opengl              -
   optical-drive            aws-iot-greengrass:optical-drive                    :optical-drive       -
   process-control          aws-iot-greengrass:process-control                  :process-control     -
   raw-usb                  aws-iot-greengrass:raw-usb                          -                    -
   removable-media          aws-iot-greengrass:removable-media                  -                    -
   serial-port              aws-iot-greengrass:serial-port                      -                    -
   spi                      aws-iot-greengrass:spi                              -                    -
   system-observe           aws-iot-greengrass:system-observe                   :system-observe      -

   Si vous voyez un tiret (-) dans la colonne Emplacement, cela signifie que l'interface correspondante n'est pas connectée.

6. Suivez Installer le logiciel AWS IoT Greengrass Core pour créer un AWS IoT objet, un groupe Greengrass, des ressources de sécurité permettant des communications sécurisées avec et le AWS IoT fichier de configuration du logiciel AWS IoT Greengrass Core. Le fichier de configuration contient une configuration spécifique à votre base Greengrass, telle que l'emplacement des fichiers de certificat et le point de terminaison des données de l'AWS IoTappareil. config.json

   Note

   Si vous avez téléchargé le fichier sur un autre appareil, suivez cette étape pour transférer les fichiers vers le périphérique AWS IoT Greengrass principal.

7. Pour le AWS IoT Greengrass snap, assurez-vous de mettre à jour le fichier config.json, comme indiqué ci-dessous :

   • Remplacez chaque instance de CertificateID par l'ID du certificat dans le nom du certificat et des fichiers clés.

   • Si vous avez téléchargé un certificat d'autorité de certification racine Amazon différent de celui d'Amazon Root CA 1, remplacez chaque instance de AmazonRootCA1.pem par le nom du fichier d'autorité de certification racine d'Amazon.

   {
     ...
     "crypto" : {
       "principals" : {
         "SecretsManager" : {
           "privateKeyPath" : "file:///snap/aws-iot-greengrass/current/greengrass/certs/certificateId-private.pem.keyy"
         },
         "IoTCertificate" : {
           "privateKeyPath" : "file:///snap/aws-iot-greengrass/current/greengrass/certs/certificateId-private.pem.key",
           "certificatePath" : "file:///snap/aws-iot-greengrass/current/greengrass/certs/certificateId-certificate.pem.crt"
         }
       },
       "caPath" : "file:///snap/aws-iot-greengrass/current/greengrass/certs/AmazonRootCA1.pem"
     },
     "writeDirectory": "/var/snap/aws-iot-greengrass/current/ggc-write-directory",
     "pidFileDirectory": "/var/snap/aws-iot-greengrass/current/pidFileDirectory"
   }

8. Exécutez la commande suivante pour ajouter votre AWS IoT Greengrass certificat et vos fichiers de configuration :

   sudo snap set aws-iot-greengrass gg-certs=/home/ubuntu/my-certs

1. Exécutez la commande suivante pour démarrer le AWS IoT Greengrass daemon :

   sudo snap start aws-iot-greengrass

   Exemple de réponse :

   Started.

   Note

   En cas d'erreur, vous pouvez utiliser la snap run commande pour afficher un message d'erreur détaillé. Pour plus d'informations sur la résolution des problèmes, consultezerreur : impossible d'effectuer les tâches suivantes : - Exécutez la commande de service « start » pour les services ["greengrassd"] de snap "aws-iot-greengrass" ([start snap. aws-iot-greengrass.greengrassd.service] a échoué avec le statut de sortie 1 : Job for snap. aws-iot-greengrass.greengrassd.service a échoué car le processus de contrôle s'est terminé avec un code d'erreur. Voir « systemctl status snap ». aws-iot-greengrass.greengrassd.service » et « journalctl -xe » pour plus de détails.).

2. Exécutez la commande suivante pour vérifier que le daemon est en cours d'exécution :

   snap services aws-iot-greengrass.greengrassd

   Exemple de réponse :

   Service                         Startup   Current  Notes
   aws-iot-greengrass.greengrassd  disabled  active   -

3. Suivez le module 3 (partie 1) : Lambda fonctionne AWS IoT Greengrass pour créer et déployer une fonction Lambda Hello World. Toutefois, avant de déployer la fonction Lambda, passez à l'étape suivante.

4. Assurez-vous que votre fonction Lambda s'exécute en tant qu'snap_daemonutilisateur et en mode sans conteneur. Pour mettre à jour les paramètres de votre groupe Greengrass, procédez comme suit dans la AWS IoT Greengrass console :

   1. Connectez-vous à la AWS IoT Greengrass console.

   2. Dans le volet de navigation de la AWS IoT console, sous Gérer, développez les appareils Greengrass, puis choisissez Groups (V1).

   3. Sous Greengrass groups, choisissez le groupe cible.

   4. Sur la page de configuration du groupe, dans le volet de navigation, choisissez l'onglet Fonctions Lambda.

   5. Dans Environnement d'exécution de la fonction Lambda par défaut, choisissez Modifier, puis procédez comme suit :

      1. Pour Utilisateur et groupe système par défaut, choisissez Autre ID utilisateur/ID de groupe, puis entrez 584788 à la fois l'ID utilisateur du système (numéro) et l'ID du groupe système (numéro).

      2. Pour la conteneurisation de la fonction Lambda par défaut, sélectionnez Aucun conteneur.

      3. Choisissez Enregistrer.

Pour archiver l'installation actuelle et installer une nouvelle version

1. Téléchargez le package d'installation du logiciel AWS IoT Greengrass Core vers lequel vous souhaitez effectuer la mise à niveau.

2. Copiez le package dans l'appareil principal de destination. Pour obtenir des instructions sur le transfert de fichiers, consultez cette étape.

   Note

   Vous copierez ultérieurement vos certificats, vos clés et votre fichier de configuration actuels dans la nouvelle installation.

   Exécutez les commandes des étapes suivantes dans votre terminal principal.

3. Assurez-vous que le démon Greengrass est arrêté sur l'appareil principal.

   1. Pour vérifier si le démon est en cours d'exécution :

      ps aux | grep -E 'greengrass.*daemon'

      Si la sortie contient une entrée root pour /greengrass/ggc/packages/ggc-version/bin/daemon, le démon est en cours d'exécution.

      Note

      Cette procédure suppose que le logiciel AWS IoT Greengrass Core soit installé dans le répertoire /greengrass.

   2. Pour arrêter le démon  :

      cd /greengrass/ggc/core/
      sudo ./greengrassd stop

4. Déplacez le répertoire racine Greengrass actuel vers un autre répertoire.

   sudo mv /greengrass /greengrass_backup

5. Décompressez le nouveau logiciel sur l'appareil principal. Remplacez les espaces réservés os-architecture et version dans la commande.

   sudo tar –zxvf greengrass-os-architecture-version.tar.gz –C /

6. Copiez les certificats, les clés et le fichier de configuration archivés dans la nouvelle installation.

   sudo cp /greengrass_backup/certs/* /greengrass/certs
   sudo cp /greengrass_backup/config/* /greengrass/config

7. Lancez le démon :

   cd /greengrass/ggc/core/
   sudo ./greengrassd start

Pour restaurer l'installation archivée

1. Arrêtez le démon.

2. Supprimez le nouveau répertoire /greengrass.

3. Replacez le répertoire /greengrass_backup dans /greengrass.

4. Lancez le démon.