Exécution de AWS IoT Greengrass dans un conteneur Docker - AWS IoT Greengrass
PrérequisObtenir l'image deAWS IoT Greengrass conteneur auprès d'Amazon ECRCréer et configurer le groupe et le noyau GreengrassExécuter AWS IoT Greengrass localementConfigurer la conteneurisation « Aucun conteneur » pour le groupeDéployez des fonctions Lambda dans le conteneur Docker(Facultatif) Déployez des appareils clients qui interagissent avec Greengrass dans le conteneur DockerArrêt du conteneur Docker AWS IoT GreengrassRésolution des problèmes liés à AWS IoT Greengrass dans un conteneur Docker

AWS IoT Greengrass Version 1 est entré dans la phase de durée de vie prolongée le 30 juin 2023. Pour plus d'informations, consultez la politique de AWS IoT Greengrass V1 maintenance. Après cette date, AWS IoT Greengrass V1 ne publiera pas de mises à jour fournissant des fonctionnalités, des améliorations, des corrections de bogues ou des correctifs de sécurité. Les appareils qui fonctionnent AWS IoT Greengrass V1 sous tension ne seront pas perturbés et continueront à fonctionner et à se connecter au cloud. Nous vous recommandons vivement de migrer vers AWS IoT Greengrass Version 2, qui ajoute de nouvelles fonctionnalités importantes et prend en charge des plateformes supplémentaires.

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.

Exécution de AWS IoT Greengrass dans un conteneur Docker

AWS IoT Greengrass peut être configuré pour s'exécuter dans un conteneur Docker.

Vous pouvez télécharger un Dockerfile via Amazon surCloudFront lequel le logicielAWS IoT Greengrass Core et ses dépendances sont installés. Pour modifier l'image Docker afin qu'elle s'exécute sur différentes architectures de plateforme ou pour réduire la taille de l'image Docker, consultez le fichier README dans le package de téléchargement Docker.

Pour vous aider à commencer à expérimenter avec AWS IoT Greengrass, AWS fournit également des images Docker prédéfinies dans lesquelles sont installés le logiciel AWS IoT Greengrass Core et les dépendances. Vous pouvez télécharger une image depuis Docker Hub ou Amazon Elastic Container Registry (Amazon ECR). Ces images prédéfinies utilisent des images de base Amazon Linux 2 (x86_64) et Alpine Linux (x86_64, Armv7l ou AArch64).

Important

Le 30 juin 2022, la maintenance des images Docker v1.x du logicielAWS IoT Greengrass Core publiées sur Amazon Elastic Container Registry (Amazon ECR) et Docker Hub aAWS IoT Greengrass pris fin. Vous pouvez continuer à télécharger ces images Docker depuis Amazon ECR et Docker Hub jusqu'au 30 juin 2023, soit 1 an après la fin de la maintenance. Toutefois, les images Docker du logicielAWS IoT Greengrass Core v1.x ne reçoivent plus de correctifs de sécurité ni de corrections de bogues après la fin de la maintenance le 30 juin 2022. Si vous exécutez une charge de travail de production qui dépend de ces images Docker, nous vous recommandons de créer vos propres images Docker à l'aide des DockerfilesAWS IoT Greengrass fournis. Pour plus d'informations, veuillez consulter AWS IoT Greengrass Logiciel Docker.

Cette rubrique explique comment télécharger l'imageAWS IoT Greengrass Docker depuis Amazon ECR et l'exécuter sur une plateforme Windows, macOS ou Linux (x86_64). Cette rubrique comporte les étapes suivantes :

  1. Obtenir l'image deAWS IoT Greengrass conteneur auprès d'Amazon ECR

  2. Créer et configurer le groupe et le noyau Greengrass

  3. Exécuter AWS IoT Greengrass localement

  4. Configurer la conteneurisation « Aucun conteneur » pour le groupe

  5. Déployez des fonctions Lambda dans le conteneur Docker

  6. (Facultatif) Déployez des appareils clients qui interagissent avec Greengrass dans le conteneur Docker

Les fonctions suivantes ne sont pas prises en charge lorsque vous exécutez AWS IoT Greengrass dans un conteneur Docker :

  • Connecteurs qui s'exécutent en mode Greengrass container (Conteneur Greengrass). Pour exécuter un connecteur dans un conteneur Docker, le connecteur doit s'exécuter en mode No container (Aucun conteneur). Pour rechercher des connecteurs prenant en charge le mode No container (Aucun conteneur) veuillez consulter AWS- connecteurs Greengrass fournis. Certains de ces connecteurs ont un paramètre de mode d'isolement que vous devez définir sur Aucun conteneur.

  • Ressources de volumes et d'appareils locales. Vos fonctions Lambda définies par l'utilisateur qui s'exécutent dans le conteneur Docker doivent accéder directement aux appareils et aux volumes situés sur le noyau.

Ces fonctionnalités ne sont pas prises en charge lorsque l'environnement d'exécution Lambda du groupe Greengrass est défini sur Aucun conteneur, ce qui est requis pour fonctionnerAWS IoT Greengrass dans un conteneur Docker.

Prérequis

Avant de commencer ce didacticiel, vous devez effectuer les opérations suivantes.

  • Vous devez installer les logiciels et les versions suivants sur votre ordinateur hôte en fonction de la versionAWS Command Line Interface (AWS CLI) que vous choisissez.

    AWS CLI version 2

    • Docker version 18.09 ou ultérieure. Les versions antérieures peuvent également fonctionner, mais nous recommandons la version 18.09 ou ultérieure.

    • AWS CLI2.0.0 0 0

      Note

      Pour effectuer la mise à niveau vers uneAWS CLI version 2 ultérieure sur un ordinateur Windows, vous devez répéter le processus d'installation MSI.

    AWS CLI version 1

    • Docker version 18.09 ou ultérieure. Les versions antérieures peuvent également fonctionner, mais nous recommandons la version 18.09 ou ultérieure.

    • Python ultérieure.

    • pip version 18.1 ou suivante.

    • AWS CLIversion 1.17.10 ou ultérieure

      Note

      Si vous utilisez l'installation MSI de laAWS CLI version 1 sous Windows, tenez compte des points suivants :

      • Si l'installation de laAWS CLI version 1 ne parvient pas à installer botocore, essayez d'utiliser l'installation Python et pip.

      • Pour effectuer la mise à niveau vers uneAWS CLI version 1 ultérieure, vous devez répéter le processus d'installation MSI.

  • Pour accéder aux ressources Amazon Elastic Container Registry (Amazon ECR), vous devez accorder l'autorisation suivante.

    • Amazon ECR exige que les utilisateurs aient accordé l'ecr:GetAuthorizationTokenautorisation via une politiqueAWS Identity and Access Management (IAM) avant qu'ils puissent s'authentifier auprès d'un référentiel et envoyer ou récupérer des images à partir d'un référentiel Amazon ECR. Pour plus d'informations, consultez les exemples de règles relatives aux référentiels Amazon ECR et l'accès à un référentiel Amazon ECR dans le guide de l'utilisateur d'Amazon Elastic Container Registry.

Étape 1 : Obtenir l'image deAWS IoT Greengrass conteneur auprès d'Amazon ECR

AWS fournit des images Docker dans lesquelles le logiciel AWS IoT Greengrass Core est installé.

Avertissement

À partir de la version 1.11.6 du logicielAWS IoT Greengrass Core, les images Greengrass Docker n'incluent plus Python 2.7, car Python 2.7 a atteint end-of-life en 2020 et ne reçoit plus de mises à jour de sécurité. Si vous choisissez d'effectuer la mise à jour vers ces images Docker, nous vous recommandons de vérifier que vos applications fonctionnent avec les nouvelles images Docker avant de déployer les mises à jour sur les appareils de production. Si vous avez besoin de Python 2.7 pour votre application qui utilise une image Greengrass Docker, vous pouvez modifier le Greengrass Dockerfile pour inclure Python 2.7 pour votre application.

Pour suivre les étapes expliquant comment extraire l'latestimage d'Amazon ECR, choisissez votre système d'exploitation :

Exécutez les commandes suivantes dans le terminal de votre ordinateur.

  1. Connectez-vous auAWS IoT Greengrass registre dans Amazon ECR.

    aws ecr get-login-password --region  us-west-2 | docker login --username AWS --password-stdin https://216483018798.dkr.ecr.us-west-2.amazonaws.com

    En cas de succès, la sortie imprime Login Succeeded.

  2. Récupérez l'image de conteneur AWS IoT Greengrass.

    docker pull 216483018798.dkr.ecr.us-west-2.amazonaws.com/aws-iot-greengrass:latest
    Note

    L'image latest contient la dernière version stable du logiciel AWS IoT Greengrass Core installée sur une image de base Amazon Linux 2. Vous pouvez également extraire d'autres images du référentiel. Pour trouver toutes les images disponibles, consultez la page Tags (Balises) sur Docker Hub ou utilisez la commande aws ecr list-images. Par exemple :

    aws ecr list-images --region us-west-2 --registry-id 216483018798 --repository-name aws-iot-greengrass

  3. Activez les protections symlink and hardlink. Si vous testez l'exécution d'AWS IoT Greengrass dans un conteneur, vous pouvez activer les paramètres pour le démarrage actuel uniquement.

    Note

    Vous devrez peut-être utiliser sudo pour exécuter ces commandes.

    • Pour activer les paramètres pour le démarrage en cours uniquement :

      echo 1 > /proc/sys/fs/protected_hardlinks
echo 1 > /proc/sys/fs/protected_symlinks

    • Pour activer les paramètres afin qu'ils persistent entre les redémarrages :

      echo '# AWS IoT Greengrass' >> /etc/sysctl.conf 
echo 'fs.protected_hardlinks = 1' >> /etc/sysctl.conf 
echo 'fs.protected_symlinks = 1' >> /etc/sysctl.conf

sysctl -p

  4. Activez le réacheminement réseau IPv4, qui est nécessaire pour que le déploiement cloud d'AWS IoT Greengrass et les communications MQTT fonctionnent sur Linux. Dans le fichier/etc/sysctl.conf, définissez net.ipv4.ip_forward sur 1, puis rechargez sysctls.

    sudo nano /etc/sysctl.conf
# set this net.ipv4.ip_forward = 1
sudo sysctl -p
    Note

    Vous pouvez utiliser l'éditeur de votre choix à la place de nano.

Exécutez les commandes suivantes dans le terminal de votre ordinateur.

  1. Connectez-vous auAWS IoT Greengrass registre dans Amazon ECR.

    aws ecr get-login-password --region  us-west-2 | docker login --username AWS --password-stdin https://216483018798.dkr.ecr.us-west-2.amazonaws.com

    En cas de succès, la sortie imprime Login Succeeded.

  2. Récupérez l'image de conteneur AWS IoT Greengrass.

    docker pull 216483018798.dkr.ecr.us-west-2.amazonaws.com/aws-iot-greengrass:latest
    Note

    L'image latest contient la dernière version stable du logiciel AWS IoT Greengrass Core installée sur une image de base Amazon Linux 2. Vous pouvez également extraire d'autres images du référentiel. Pour trouver toutes les images disponibles, consultez la page Tags (Balises) sur Docker Hub ou utilisez la commande aws ecr list-images. Par exemple :

    aws ecr list-images --region us-west-2 --registry-id 216483018798 --repository-name aws-iot-greengrass

Dans une invite de commande, exécutez les commandes suivantes. Pour pouvoir utiliser des commandes Docker sur Windows, Docker Desktop doit être en cours d'exécution.

  1. Connectez-vous auAWS IoT Greengrass registre dans Amazon ECR.

    aws ecr get-login-password --region  us-west-2 | docker login --username AWS --password-stdin https://216483018798.dkr.ecr.us-west-2.amazonaws.com

    En cas de succès, la sortie imprime Login Succeeded.

  2. Récupérez l'image de conteneur AWS IoT Greengrass.

    docker pull 216483018798.dkr.ecr.us-west-2.amazonaws.com/aws-iot-greengrass:latest
    Note

    L'image latest contient la dernière version stable du logiciel AWS IoT Greengrass Core installée sur une image de base Amazon Linux 2. Vous pouvez également extraire d'autres images du référentiel. Pour trouver toutes les images disponibles, consultez la page Tags (Balises) sur Docker Hub ou utilisez la commande aws ecr list-images. Par exemple :

    aws ecr list-images --region us-west-2 --registry-id 216483018798 --repository-name aws-iot-greengrass

Étape 2 : Créer et configurer le groupe et le noyau Greengrass

L'image Docker comprend le logiciel AWS IoT Greengrass Core installé, mais vous devez créer un noyau et un groupe Greengrass. Cela inclut le téléchargement des certificats et du fichier de configuration du noyau.

Étape 3 : Exécuter AWS IoT Greengrass localement

Une votre groupe configuré, vous êtes prêt à configurer et démarrer le noyau. Pour les étapes qui montrent comment procéder, choisissez votre système d'exploitation :

Exécutez les commandes suivantes dans le terminal de votre ordinateur.

  1. Créez un dossier pour les ressources de sécurité de l'appareil et déplacez le certificat et les clés dans ce dossier. Exécutez les commandes suivantes. Remplacez path-to-security-filespar le chemin d'accès aux ressources de sécurité et remplacez certificateId par l'ID de certificat figurant dans les noms de fichiers.

    mkdir /tmp/certs
mv path-to-security-files/certificateId-certificate.pem.crt /tmp/certs
mv path-to-security-files/certificateId-public.pem.key /tmp/certs
mv path-to-security-files/certificateId-private.pem.key /tmp/certs
mv path-to-security-files/AmazonRootCA1.pem /tmp/certs

  2. Créez un dossier pour la configuration de l'appareil et déplacez le fichier de configurationAWS IoT Greengrass Core vers ce dossier. Exécutez les commandes suivantes. Remplacez path-to-config-filepar le chemin d'accès au fichier de configuration.

    mkdir /tmp/config
mv path-to-config-file/config.json /tmp/config

  3. Démarrez AWS IoT Greengrass et créez un montage lié des certificats et du fichier de configuration dans le conteneur Docker.

    Remplacez /tmp par le chemin d'accès où vous avez décompressé vos certificats et le fichier de configuration.

    docker run --rm --init -it --name aws-iot-greengrass \
--entrypoint /greengrass-entrypoint.sh \
-v /tmp/certs:/greengrass/certs \
-v /tmp/config:/greengrass/config \
-p 8883:8883 \
216483018798.dkr.ecr.us-west-2.amazonaws.com/aws-iot-greengrass:latest

    La sortie doit se présenter comme cet exemple :

    Setting up greengrass daemon
Validating hardlink/softlink protection
Waiting for up to 30s for Daemon to start

Greengrass successfully started with PID: 10

Exécutez les commandes suivantes dans le terminal de votre ordinateur.

  1. Créez un dossier pour les ressources de sécurité de l'appareil et déplacez le certificat et les clés dans ce dossier. Exécutez les commandes suivantes. Remplacez path-to-security-filespar le chemin d'accès aux ressources de sécurité et remplacez certificateId par l'ID de certificat figurant dans les noms de fichiers.

    mkdir /tmp/certs
mv path-to-security-files/certificateId-certificate.pem.crt /tmp/certs
mv path-to-security-files/certificateId-public.pem.key /tmp/certs
mv path-to-security-files/certificateId-private.pem.key /tmp/certs
mv path-to-security-files/AmazonRootCA1.pem /tmp/certs

  2. Créez un dossier pour la configuration de l'appareil et déplacez le fichier de configurationAWS IoT Greengrass Core vers ce dossier. Exécutez les commandes suivantes. Remplacez path-to-config-filepar le chemin d'accès au fichier de configuration.

    mkdir /tmp/config
mv path-to-config-file/config.json /tmp/config

  3. Démarrez AWS IoT Greengrass et créez un montage lié des certificats et du fichier de configuration dans le conteneur Docker.

    Remplacez /tmp par le chemin d'accès où vous avez décompressé vos certificats et le fichier de configuration.

    docker run --rm --init -it --name aws-iot-greengrass \
--entrypoint /greengrass-entrypoint.sh \
-v /tmp/certs:/greengrass/certs \
-v /tmp/config:/greengrass/config \
-p 8883:8883 \
216483018798.dkr.ecr.us-west-2.amazonaws.com/aws-iot-greengrass:latest

    La sortie doit se présenter comme cet exemple :

    Setting up greengrass daemon
Validating hardlink/softlink protection
Waiting for up to 30s for Daemon to start

Greengrass successfully started with PID: 10

  1. Créez un dossier pour les ressources de sécurité de l'appareil et déplacez le certificat et les clés dans ce dossier. Dans une invite de commande, exécutez les commandes suivantes. Remplacez path-to-security-filespar le chemin d'accès aux ressources de sécurité et remplacez certificateId par l'ID de certificat figurant dans les noms de fichiers.

    mkdir C:\Users\%USERNAME%\Downloads\certs
move path-to-security-files\certificateId-certificate.pem.crt C:\Users\%USERNAME%\Downloads\certs
move path-to-security-files\certificateId-public.pem.key C:\Users\%USERNAME%\Downloads\certs
move path-to-security-files\certificateId-private.pem.key C:\Users\%USERNAME%\Downloads\certs
move path-to-security-files\AmazonRootCA1.pem C:\Users\%USERNAME%\Downloads\certs

  2. Créez un dossier pour la configuration de l'appareil et déplacez le fichier de configurationAWS IoT Greengrass Core vers ce dossier. Dans une invite de commande, exécutez les commandes suivantes. Remplacez path-to-config-filepar le chemin d'accès au fichier de configuration.

    mkdir C:\Users\%USERNAME%\Downloads\config
move path-to-config-file\config.json C:\Users\%USERNAME%\Downloads\config

  3. Démarrez AWS IoT Greengrass et créez un montage lié des certificats et du fichier de configuration dans le conteneur Docker. Dans votre invite de commande, exécutez les commandes suivantes.

    docker run --rm --init -it --name aws-iot-greengrass --entrypoint /greengrass-entrypoint.sh -v c:/Users/%USERNAME%/Downloads/certs:/greengrass/certs -v c:/Users/%USERNAME%/Downloads/config:/greengrass/config -p 8883:8883 216483018798.dkr.ecr.us-west-2.amazonaws.com/aws-iot-greengrass:latest

    Lorsque Docker vous invite à partager votre lecteur C:\ avec le démon Docker, laissez-le créer un montage lié du répertoire C:\ dans le conteneur Docker. Pour plus d'informations, consultez la section Disques partagés dans la documentation Docker.

    La sortie doit se présenter comme cet exemple :

    Setting up greengrass daemon
Validating hardlink/softlink protection
Waiting for up to 30s for Daemon to start

Greengrass successfully started with PID: 10
Note

Si le conteneur n'ouvre pas le shell et se ferme immédiatement, vous pouvez résoudre le problème en procédant à un montage lié des journaux du runtime Greengrass lorsque vous démarrez l'image. Pour plus d'informations, veuillez consulter Pour conserver les journaux d'exécution Greengrass en dehors du conteneur Docker.

Étape 4 : Configurer la conteneurisation « Aucun conteneur » pour le groupe Greengrass

Lorsque vous exécutezAWS IoT Greengrass dans un conteneur Docker, toutes les fonctions Lambda doivent s'exécuter sans conteneurisation. Dans cet étape, vous définissez la conteneurisation par défaut du groupe sur Aucun conteneur. Vous devez effectuer cette opération avant le premier déploiement du groupe.

  1. Dans le volet de navigation de laAWS IoT console, sous Gérer, développez les appareils Greengrass, puis choisissez Groupes (V1).

  2. Choisissez le groupe dont vous voulez modifier les paramètres.

  3. Choisissez l'onglet Fonctions Lambda.

  4. Dans Environnement d'exécution des fonctions Lambda par défaut, choisissez Modifier.

  5. Dans l'environnement d'exécution de la fonction Lambda par défaut Modifier, sous Conteneurisation de la fonction Lambda par défaut, modifiez les paramètres de conteneurisation.

  6. Choisissez Save (Enregistrer).

Les modifications prennent effet lorsque le groupe est déployé.

Pour plus d'informations, veuillez consulter Configuration de la conteneurisation par défaut pour les fonctions Lambda dans un groupe.

Note

Par défaut, les fonctions Lambda utilisent le paramètre de conteneurisation des groupes. Si vous remplacez le paramètre Aucun conteneur pour une fonction LambdaAWS IoT Greengrass exécutée dans un conteneur Docker, le déploiement échoue.

Étape 5 : Déployer des fonctions Lambda dans le conteneurAWS IoT Greengrass Docker

Vous pouvez déployer des fonctions Lambda durables dans le conteneur Greengrass Docker.

Étape 6 : (Facultatif) Déployez des appareils clients qui interagissent avec Greengrass s'exécutant dans le conteneur Docker

Vous pouvez également déployer des appareils clients avec lesquels il interagitAWS IoT Greengrass lorsqu'il s'exécute dans un conteneur Docker.

Arrêt du conteneur Docker AWS IoT Greengrass

Pour arrêter le conteneur Docker AWS IoT Greengrass, appuyez sur Ctrl+C dans votre terminal ou dans la ligne de commande. Cette action envoieSIGTERM au processus démon Greengrass pour détruire le processus démon Greengrass et tous les processus Lambda qui ont été démarrés par le processus démon. Le conteneur Docker est initialisé avec le processus /dev/init défini comme PID 1, qui permet d'éliminer tous les processus zombies restants. Pour plus d'informations, consultez le guide de référence d'exécution Docker.

Résolution des problèmes liés à AWS IoT Greengrass dans un conteneur Docker

Aidez-vous des informations suivantes pour résoudre les problèmes que vous êtes susceptible de rencontrer lors de l'exécution d'AWS IoT Greengrass dans un conteneur Docker.

Erreur : Impossible d'effectuer une connexion interactive à partir d'un appareil autre que TTY.

Solution : cette erreur peut se produire lorsque vous exécutez la commande aws ecr get-login-password. Assurez-vous d'avoir installé la dernièreAWS CLI version 2 ou la version 1. Nous vous recommandons d'AWS CLIutiliser la 2 Pour plus d'informations, consultez Installation d'AWS CLI dans le Guide de l'utilisateur AWS Command Line Interface.

Erreur : options inconnues : -no-include-email.

Solution : cette erreur peut se produire lorsque vous exécutez la commande aws ecr get-login. Assurez-vous que vous disposez de la dernière version de l'interface de ligne de commande AWS CLI installée (par exemple, exécutez : pip install awscli --upgrade --user). Si vous utilisez Windows et avez installé l'interface de ligne de commande à l'aide du programme d'installation MSI, vous devez répéter le processus d'installation. Pour plus d'informations, consultez la section Installation deAWS Command Line Interface sur Microsoft Windows dans le Guide deAWS Command Line Interface l'utilisateur.

Avertissement : IPv4 est désactivé. La mise en réseau ne fonctionnera pas.

Solution : vous pouvez recevoir cet avertissement ou un message similaire lors de l'exécution d'AWS IoT Greengrass sur un ordinateur Linux. Activez le réacheminement réseau IPv4 comme décrit dans cette étape. Le déploiement cloud AWS IoT Greengrass et les communications MQTT ne fonctionnent pas lorsque le réacheminement IPv4 n'est pas activé. Pour plus d'informations, consultez Configurer les paramètres du noyau dans un espace de noms (sysctls) lors de l'exécution dans la documentation Docker.

Erreur : Un pare-feu bloque le partage de fichiers entre les fenêtres et les conteneurs.

Solution : vous pouvez recevoir cette erreur ou un message Firewall Detected lors de l'exécution de Docker sur un ordinateur Windows. Ce problème peut également survenir si vous êtes connecté à un réseau privé virtuel (VPN) et que vos paramètres réseau empêchent le montage du lecteur partagé. Dans ce cas, désactivez le VPN et réexécutez le conteneur Docker.

Erreur : une erreur s'est produite (AccessDeniedException) lors de l'appel de l'GetAuthorizationTokenopération : L'utilisateur : arn:aws:iam : ::user/ <account-id><user-name>n'est pas autorisé à exécuter : ecr : onGetAuthorizationToken resource : *

Cette erreur peut s'afficher lors de l'exécution de laaws ecr get-login-password commande si vous ne disposez pas des autorisations nécessaires pour accéder à un référentiel Amazon ECR. Pour plus d'informations, consultez les exemples de règles relatives aux référentiels Amazon ECR et l'accès à un référentiel Amazon ECR dans le guide de l'utilisateur Amazon ECR.

Pour l'aide à la résolution des problèmes AWS IoT Greengrass généraux, consultez Résolution des problèmes de AWS IoT Greengrass.

Débogage de AWS IoT Greengrass dans un conteneur Docker

Pour déboguer les problèmes avec un conteneur Docker, vous pouvez conserver les journaux d'exécution Greengrass ou attacher un shell interactif au conteneur Docker.

Pour conserver les journaux d'exécution Greengrass en dehors du conteneur Docker

Vous pouvez exécuter le conteneur Docker AWS IoT Greengrass après avoir procédé au montage lié du répertoire /greengrass/ggc/var/log. Les journaux sont conservés après la fermeture ou la suppression du conteneur.

Sur Linux ou macOS

Arrêtez les conteneurs Docker Greengrass en cours d'exécution sur l'hôte, puis exécutez la commande suivante dans un terminal. Elle procède au montage lié du répertoire log Greengrass et démarre l'image Docker.

Remplacez /tmp par le chemin d'accès où vous avez décompressé vos certificats et le fichier de configuration.

docker run --rm --init -it --name aws-iot-greengrass \
      --entrypoint /greengrass-entrypoint.sh \
      -v /tmp/certs:/greengrass/certs \
      -v /tmp/config:/greengrass/config \
      -v /tmp/log:/greengrass/ggc/var/log \
      -p 8883:8883 \
      216483018798.dkr.ecr.us-west-2.amazonaws.com/aws-iot-greengrass:latest

Vous pouvez alors vérifier vos journaux à l'emplacement /tmp/log sur votre hôte afin de voir ce qui s'est passé lors de l'exécution de Greengrass dans le conteneur Docker.

Sous Windows

Arrêtez les conteneurs Docker Greengrass en cours d'exécution sur l'hôte, puis exécutez la commande suivante dans une invite de commande. Elle procède au montage lié du répertoire log Greengrass et démarre l'image Docker.

cd C:\Users\%USERNAME%\Downloads
mkdir log
docker run --rm --init -it --name aws-iot-greengrass --entrypoint /greengrass-entrypoint.sh -v c:/Users/%USERNAME%/Downloads/certs:/greengrass/certs -v c:/Users/%USERNAME%/Downloads/config:/greengrass/config -v c:/Users/%USERNAME%/Downloads/log:/greengrass/ggc/var/log -p 8883:8883 216483018798.dkr.ecr.us-west-2.amazonaws.com/aws-iot-greengrass:latest

Vous pouvez alors vérifier vos journaux à l'emplacement C:/Users/%USERNAME%/Downloads/log sur votre hôte afin de voir ce qui s'est passé lors de l'exécution de Greengrass dans le conteneur Docker.

Pour attacher un shell interactif au conteneur Docker

Vous pouvez attacher un shell interactif à un conteneur Docker AWS IoT Greengrass en cours d'exécution. Cela peut vous aider à étudier l'état du conteneur Docker Greengrass.

Sur Linux ou macOS

Pendant que le conteneur Docker Greengrass est en cours d'exécution, exécutez la commande suivante dans un autre terminal.

docker exec -it $(docker ps -a -q -f "name=aws-iot-greengrass") /bin/bash
Sous Windows

Pendant que le conteneur Docker Greengrass est en cours d'exécution, exécutez les commandes suivantes dans une invite de commande distincte.

docker ps -a -q -f "name=aws-iot-greengrass"

Remplacez gg-container-idpar lecontainer_id résultat de la commande précédente.

docker exec -it gg-container-id /bin/bash