Versions Exigences relatives aux dispositifs Plateformes prises en charge Système d’exploitation Prérequis Dépendances Téléchargement et installation Configuration Fichier journal local Journal des modifications

Noyau Greengrass

Le composant Greengrass nucleus (aws.greengrass.Nucleus) est un composant obligatoire et constitue la configuration minimale requise pour exécuter le logiciel AWS IoT Greengrass Core sur un appareil. Vous pouvez configurer ce composant pour personnaliser et mettre à jour votre logiciel AWS IoT Greengrass Core à distance. Déployez ce composant pour configurer des paramètres tels que le proxy, le rôle de l'appareil et AWS IoT la configuration des objets sur vos appareils principaux.

Note

À partir de la version 2.14.0 de Greengrass, une version optimisée de l'empreinte mémoire de l'environnement d'exécution des périphériques Nucleus est disponible pour les appareils périphériques contraints. Consultez Greengrass nucleus lite pour plus d'informations sur sa configuration et son utilisation.

Important

Lorsque la version du composant du noyau change ou lorsque vous modifiez certains paramètres de configuration, le logiciel AWS IoT Greengrass Core, qui inclut le noyau et tous les autres composants de votre appareil, redémarre pour appliquer les modifications.

Lorsque vous déployez un composant, AWS IoT Greengrass installe les dernières versions prises en charge de toutes les dépendances de ce composant. De ce fait, de nouvelles versions de correctif des composants publics AWS fournis peuvent être automatiquement déployées sur vos appareils principaux si vous ajoutez de nouveaux appareils à un groupe d'objets ou si vous mettez à jour le déploiement qui cible ces appareils. Certaines mises à jour automatiques, telles qu'une mise à jour du noyau, peuvent entraîner un redémarrage inattendu de vos appareils.

Pour éviter les mises à jour involontaires d'un composant qui s'exécute sur votre appareil, nous vous recommandons d'inclure directement votre version préférée de ce composant lorsque vous créez un déploiement. Pour plus d'informations sur le comportement des mises à jour pour les logiciels AWS IoT Greengrass Core, consultezMettez à jour le AWS IoT Greengrass Logiciel de base (OTA).

Versions

Les versions de ce composant sont les suivantes :

2,18x
2,17x
2,16.x
2,15. x
2.14x
2.13x
2.12x
2.11x
2.10.x
2,9. x
2.8.x
2.7.x
2.6.x
2.5.x
2.4.x
2.3.x
2.2.x
2.1.x
2.0.x

Exigences relatives aux dispositifs

Note

Vous pouvez utiliser AWS IoT Device Tester for AWS IoT Greengrass pour vérifier que votre appareil peut exécuter le logiciel AWS IoT Greengrass Core et communiquer avec le AWS Cloud. Pour de plus amples informations, veuillez consulter Utilisation AWS IoT Device Tester for AWS IoT Greengrass V2.

Linux

L'utilisation d'Région AWSun support AWS IoT Greengrass V2. Pour obtenir la liste des régions prises en charge, consultez Points de terminaison et quotas AWS IoT Greengrass V2 dans le Références générales AWS.
256 Mo d'espace disque minimum disponible pour le logiciel AWS IoT Greengrass Core. Cette exigence n'inclut pas les composants déployés sur le périphérique principal.
Au moins 96 Mo de RAM sont alloués au logiciel AWS IoT Greengrass Core. Cette exigence n'inclut pas les composants qui s'exécutent sur le périphérique principal. Pour de plus amples informations, veuillez consulter Contrôlez l'allocation de mémoire grâce aux options JVM.
Java Runtime Environment (JRE) version 8 ou supérieure. Java doit être disponible sur la variable d'environnement PATH de l'appareil. Pour utiliser Java afin de développer des composants personnalisés, vous devez installer un kit de développement Java (JDK). Nous vous recommandons d'utiliser les versions de support à long terme d'Amazon Corretto ou d'OpenJDK. La version 8 ou supérieure est requise.
Bibliothèque GNU C (glibc) version 2.25 ou supérieure.
Vous pouvez exécuter le logiciel AWS IoT Greengrass Core en tant qu'utilisateur root. Utilisezsudo, par exemple. Vous pouvez également exécuter le logiciel AWS IoT Greengrass Core en tant qu'utilisateur non root. Pour de plus amples informations, veuillez consulter Configuration AWS IoT Greengrass V2 périphériques principaux en tant que périphériques non root.
L'utilisateur root qui exécute le logiciel AWS IoT Greengrass Core, par exempleroot, doit être autorisé à s'exécuter sudo avec n'importe quel utilisateur et n'importe quel groupe. Le /etc/sudoers fichier doit autoriser cet utilisateur à s'exécuter sudo en tant qu'autre groupe. L'autorisation accordée à l'utilisateur /etc/sudoers doit ressembler à l'exemple suivant.
```
root    ALL=(ALL:ALL) ALL
```
Le périphérique principal doit être capable d'effectuer des requêtes sortantes vers un ensemble de terminaux et de ports. Pour de plus amples informations, veuillez consulter Autoriser le trafic des appareils via un proxy ou un pare-feu.
Le /tmp répertoire doit être monté avec des exec autorisations.
Toutes les commandes shell suivantes :
- ps -ax -o pid,ppid
- sudo
- sh
- kill
- cp
- chmod
- rm
- ln
- echo
- exit
- id
- uname
- grep
Votre appareil peut également nécessiter les commandes shell facultatives suivantes :
- (Facultatif) systemctl. Cette commande est utilisée pour configurer le logiciel AWS IoT Greengrass Core en tant que service système.
- (Facultatif) useraddgroupadd, etusermod. Ces commandes sont utilisées pour configurer l'utilisateur du ggc_user ggc_group système et le groupe de systèmes.
- (Facultatif) mkfifo. Cette commande est utilisée pour exécuter des fonctions Lambda en tant que composants.
Pour configurer les limites de ressources système pour les processus de composants, votre appareil doit exécuter la version 2.6.24 ou ultérieure du noyau Linux.
Pour exécuter les fonctions Lambda, votre appareil doit répondre à des exigences supplémentaires. Pour de plus amples informations, veuillez consulter Exigences relatives à la fonction Lambda.

Important

Sur Ubuntu 25.10 et versions ultérieures, l'sudoimplémentation par défaut ne prend pas en charge l'indicateur -E (préservation de l'environnement). Sans cet indicateur, le système ne transmet pas les variables d'environnement aux composants qui s'exécutent en tant qu'utilisateur système différent. Par conséquent, ces composants ne démarrent pas.

Pour résoudre ce problème, passez à l'sudoimplémentation classique (sudo.ws). Vous devez effectuer cette modification car AWS IoT Greengrass utilise l'-Eindicateur pour transmettre des variables d'environnement aux processus des composants.


sudo update-alternatives --set sudo /usr/bin/sudo.ws

Windows

L'utilisation d'Région AWSun support AWS IoT Greengrass V2. Pour obtenir la liste des régions prises en charge, consultez Points de terminaison et quotas AWS IoT Greengrass V2 dans le Références générales AWS.
256 Mo d'espace disque minimum disponible pour le logiciel AWS IoT Greengrass Core. Cette exigence n'inclut pas les composants déployés sur le périphérique principal.
Au moins 160 Mo de RAM sont alloués au logiciel AWS IoT Greengrass Core. Cette exigence n'inclut pas les composants qui s'exécutent sur le périphérique principal. Pour de plus amples informations, veuillez consulter Contrôlez l'allocation de mémoire grâce aux options JVM.
Java Runtime Environment (JRE) version 8 ou supérieure. Java doit être disponible sur la variable système PATH du périphérique. Pour utiliser Java afin de développer des composants personnalisés, vous devez installer un kit de développement Java (JDK). Nous vous recommandons d'utiliser les versions de support à long terme d'Amazon Corretto ou d'OpenJDK. La version 8 ou supérieure est requise.

Note
Pour utiliser la version 2.5.0 du noyau Greengrass, vous devez utiliser une version 64 bits du Java Runtime Environment (JRE). Greengrass Nucleus version 2.5.1 prend en charge les JRE 32 bits et 64 bits.
L'utilisateur qui installe le logiciel AWS IoT Greengrass Core doit être administrateur.
Vous devez installer le logiciel AWS IoT Greengrass Core en tant que service système. Spécifiez --setup-system-service true quand vous installez le logiciel.
Chaque utilisateur qui exécute des processus de composants doit exister dans le LocalSystem compte, et son nom et son mot de passe doivent figurer dans l'instance Credential Manager du LocalSystem compte. Vous pouvez configurer cet utilisateur en suivant les instructions d'installation du logiciel AWS IoT Greengrass Core.
Le périphérique principal doit être capable d'effectuer des requêtes sortantes vers un ensemble de terminaux et de ports. Pour de plus amples informations, veuillez consulter Autoriser le trafic des appareils via un proxy ou un pare-feu.

Plateformes prises en charge

AWS IoT Greengrass prend officiellement en charge les appareils exécutant les plateformes suivantes. Les appareils dont les plates-formes ne figurent pas dans cette liste peuvent fonctionner, mais les AWS IoT Greengrass tests ne sont effectués que sur les plates-formes spécifiées.

Considérations relatives aux fonctionnalités

Certaines AWS IoT Greengrass fonctionnalités ne sont actuellement pas prises en charge sur les appareils Windows. Passez en revue les différences de fonctionnalités pour vérifier si un appareil Windows répond à vos exigences. Pour de plus amples informations, veuillez consulter Compatibilité des fonctionnalités de Greengrass.

Pour créer un système Linux-based d'exploitation personnalisé, vous pouvez utiliser la BitBake recette AWS IoT Greengrass du meta-aws projet. Le meta-aws projet fournit des recettes que vous pouvez utiliser pour développer des fonctionnalités logicielles de AWS pointe dans les systèmes Linux intégrés qui sont construits avec OpenEmbedded les frameworks de génération de Yocto Project. Le projet Yocto est un projet de collaboration open source qui vous aide à créer des Linux-based systèmes personnalisés pour des applications intégrées, quelle que soit l'architecture matérielle. La BitBake recette pour AWS IoT Greengrass installer, configurer et exécuter automatiquement le logiciel AWS IoT Greengrass Core sur votre appareil.

Les plateformes Linux peuvent également s'exécuter AWS IoT Greengrass dans un conteneur Docker. Pour de plus amples informations, veuillez consulter Exécuter le logiciel AWS IoT Greengrass Core dans un conteneur Docker.

Système d’exploitation

Ce composant peut être installé sur les appareils principaux qui exécutent les systèmes d'exploitation suivants :

Linux
Windows

Pour de plus amples informations, veuillez consulter Plateformes prises en charge.

Prérequis

Les appareils doivent répondre à certaines exigences pour installer et exécuter le noyau Greengrass et le logiciel AWS IoT Greengrass Core. Pour de plus amples informations, veuillez consulter Exigences relatives aux dispositifs.

Le composant Greengrass Nucleus est pris en charge pour fonctionner dans un VPC. Pour déployer ce composant dans un VPC, les conditions suivantes sont requises.

Le composant Greengrass Nucleus doit être connecté à Amazon S3 AWS IoT data, à des AWS IoT informations d'identification et à Amazon S3.

Dépendances

Le noyau Greengrass ne comprend aucune dépendance de composants. Cependant, plusieurs composants AWS fournis incluent le noyau en tant que dépendance. Pour de plus amples informations, veuillez consulter AWS-composants fournis.

Pour plus d'informations sur les dépendances des composants, consultez la référence des recettes des composants.

Téléchargement et installation

Vous pouvez télécharger un programme d'installation qui configure le composant Greengrass Nucleus sur votre appareil. Ce programme d'installation configure votre appareil en tant qu'appareil principal de Greengrass. Vous pouvez effectuer deux types d'installations : une installation rapide qui crée les AWS ressources nécessaires pour vous, ou une installation manuelle dans laquelle vous créez les AWS ressources vous-même. Pour de plus amples informations, veuillez consulter Installation du logiciel AWS IoT Greengrass de base.

Vous pouvez également suivre un tutoriel pour installer le noyau Greengrass et explorer le développement des composants Greengrass. Pour de plus amples informations, veuillez consulter Tutoriel : Débuter avec AWS IoT Greengrass V2.

Configuration

Ce composant fournit les paramètres de configuration suivants que vous pouvez personnaliser lorsque vous déployez le composant. Certains paramètres nécessitent le redémarrage du logiciel AWS IoT Greengrass Core pour prendre effet. Pour plus d'informations sur les raisons et la manière de configurer ce composant, consultezConfigurez le AWS IoT Greengrass Logiciel de base.

iotRoleAlias

Alias de AWS IoT rôle qui pointe vers un rôle IAM d'échange de jetons. Le fournisseur AWS IoT d'informations d'identification assume ce rôle pour permettre au périphérique principal de Greengrass d'interagir avec les AWS services. Pour de plus amples informations, veuillez consulter Autoriser les appareils principaux à interagir avec les AWS services.

Lorsque vous exécutez le logiciel AWS IoT Greengrass Core avec --provision true cette option, le logiciel fournit un alias de rôle et définit sa valeur dans le composant principal.

interpolateComponentConfiguration

(Facultatif) Vous pouvez activer le noyau Greengrass pour interpoler les variables de recette des composants dans les configurations des composants et fusionner les mises à jour de configuration. Nous vous recommandons de définir cette option pour true que le périphérique principal puisse exécuter les composants Greengrass qui utilisent des variables de recette dans leurs configurations.

Cette fonctionnalité est disponible pour les versions 2.6.0 et ultérieures de ce composant.

Valeur par défaut : false

networkProxy

(Facultatif) Le proxy réseau à utiliser pour toutes les connexions. Pour de plus amples informations, veuillez consulter Connexion au port 443 ou via un proxy réseau.

Important

Lorsque vous déployez une modification de ce paramètre de configuration, le logiciel AWS IoT Greengrass Core redémarre pour que la modification soit prise en compte.

Cet objet contient les informations suivantes :

noProxyAddresses

(Facultatif) Une liste d'adresses IP ou de noms d'hôtes séparés par des virgules qui ne sont pas concernés par le proxy.

proxy

Le proxy auquel se connecter. Cet objet contient les informations suivantes :

url

URL du serveur proxy au formatscheme://userinfo@host:port.

scheme— Le schéma, qui doit être http ouhttps.

Important
Les appareils Greengrass Core doivent exécuter Greengrass nucleus v2.5.0 ou version ultérieure pour utiliser des proxys HTTPS.
Si vous configurez un proxy HTTPS, vous devez ajouter le certificat CA du serveur proxy au certificat CA racine Amazon de l'appareil principal. Pour de plus amples informations, veuillez consulter Permettre au périphérique principal de faire confiance à un proxy HTTPS.
userinfo— (Facultatif) Les informations relatives au nom d'utilisateur et au mot de passe. Si vous spécifiez ces informations dans leurl, le périphérique principal de Greengrass ignore les champs username etpassword.
host— Le nom d'hôte ou l'adresse IP du serveur proxy.
port— (Facultatif) Numéro de port. Si vous ne spécifiez pas le port, le périphérique principal de Greengrass utilise les valeurs par défaut suivantes :
- http— 80
- https— 443

username

(Facultatif) Le nom d'utilisateur qui authentifie le serveur proxy.

password

(Facultatif) Le mot de passe qui authentifie le serveur proxy.

mqtt

(Facultatif) La configuration MQTT pour le périphérique principal Greengrass. Pour de plus amples informations, veuillez consulter Connexion au port 443 ou via un proxy réseau.

Important

Lorsque vous déployez une modification de ce paramètre de configuration, le logiciel AWS IoT Greengrass Core redémarre pour que la modification soit prise en compte.

Cet objet contient les informations suivantes :

port

(Facultatif) Port à utiliser pour les connexions MQTT.

Valeur par défaut : 8883

keepAliveTimeoutMs

(Facultatif) Durée en millisecondes entre chaque PING message envoyé par le client pour maintenir la connexion MQTT active. Cette valeur doit être supérieure àpingTimeoutMs.

Par défaut : 60000 (60 secondes)

pingTimeoutMs

(Facultatif) Durée en millisecondes pendant laquelle le client attend de recevoir un PINGACK message du serveur. Si l'attente dépasse le délai imparti, le périphérique principal ferme et rouvre la connexion MQTT. Cette valeur doit être inférieure àkeepAliveTimeoutMs.

Par défaut : 30000 (30 secondes)

operationTimeoutMs

(Facultatif) Durée en millisecondes pendant laquelle le client attend la fin des opérations MQTT (telles que CONNECT ouPUBLISH). Cette option ne s'applique pas aux messages MQTT PING ou Keep Alive.

Par défaut : 30000 (30 secondes)

maxInFlightPublishes

(Facultatif) Le nombre maximum de messages MQTT QoS 1 non reconnus qui peuvent être en vol en même temps.

Cette fonctionnalité est disponible pour les versions 2.1.0 et ultérieures de ce composant.

Valeur par défaut : 5

Plage valide : valeur maximale de 100

maxMessageSizeInBytes

(Facultatif) Taille maximale d'un message MQTT. Si un message dépasse cette taille, le noyau Greengrass rejette le message avec une erreur.

Cette fonctionnalité est disponible pour les versions 2.1.0 et ultérieures de ce composant.

Par défaut : 131072 (128 Ko)

Plage valide : valeur maximale de 2621440 (2,5 Mo)

maxPublishRetry

(Facultatif) Le nombre maximum de fois qu'il est possible de réessayer un message dont la publication échoue. Vous pouvez spécifier -1 de réessayer un nombre illimité de fois.

Cette fonctionnalité est disponible pour les versions 2.1.0 et ultérieures de ce composant.

Valeur par défaut : 100

standaloneMqttTimeoutMs

(Facultatif) Durée, en millisecondes, pendant laquelle le noyau attend des connexions MQTT autonomes pendant les opérations du commutateur de connectivité IoT. Ce délai couvre la vérification de la connectivité avant le vol et le rapport d'état que le noyau envoie au compte source après un changement réussi.

Cette fonctionnalité nécessite la version 2.18.0 ou ultérieure de ce composant.

Par défaut : 60000 (60 secondes)

Plage valide : valeur minimale de 1

spooler

(Facultatif) La configuration du spouleur MQTT pour le périphérique principal Greengrass. Cet objet contient les informations suivantes :

storageType

Type de stockage pour le stockage des messages. S'storageTypeil est réglé surDisk, il pluginName peut être configuré. Vous pouvez spécifier Memory ou Disk.

Cette fonctionnalité est disponible pour la version 2.11.0 et les versions ultérieures du composant Greengrass nucleus.

Important

Si le spouleur MQTT storageType est réglé sur Disk et que vous souhaitez rétrograder Greengrass nucleus de la version 2.11.x vers une version antérieure, vous devez revenir à la configuration. Memory La seule configuration pour storageType cela est prise en charge dans les versions 2.10.x et antérieures de Greengrass nucleus est. Memory Le non-respect de ces instructions peut entraîner la rupture du spouleur. Cela empêcherait votre appareil principal Greengrass d'envoyer des messages MQTT au. AWS Cloud

Valeur par défaut : Memory

pluginName

(Facultatif) Le nom du composant du plug-in. Ce composant ne sera utilisé que s'il storageType est défini surDisk. Cette option est définie par défaut sur aws.greengrass.DiskSpooler et utilisera le Greengrass-provided spouleur à disque.

Cette fonctionnalité est disponible pour la version 2.11.0 et les versions ultérieures du composant Greengrass nucleus.

Valeur par défaut : "aws.greengrass.DiskSpooler"

maxSizeInBytes

(Facultatif) Taille maximale du cache dans lequel le périphérique principal stocke les messages MQTT non traités en mémoire. Si le cache est plein, les nouveaux messages sont rejetés.

Par défaut : 2621440 (2,5 Mo)

keepQos0WhenOffline

(Facultatif) Vous pouvez spouler les messages MQTT QoS 0 que le périphérique principal reçoit lorsqu'il est hors ligne. Si vous définissez cette option surtrue, le périphérique principal met en attente les messages QoS 0 qu'il ne peut pas envoyer lorsqu'il est hors ligne. Si vous définissez cette option surfalse, le périphérique principal supprime ces messages. Le périphérique principal met toujours en bobine les messages QoS 1, sauf si la bobine est pleine.

Valeur par défaut : false

version

(Facultatif) La version de MQTT. Vous pouvez spécifier mqtt3 ou mqtt5.

Cette fonctionnalité est disponible pour la version 2.10.0 et les versions ultérieures du composant Greengrass nucleus.

Valeur par défaut : mqtt5

receiveMaximum

(Facultatif) Le nombre maximum de paquets QoS1 non reconnus que le courtier peut envoyer.

Cette fonctionnalité est disponible pour la version 2.10.0 et les versions ultérieures du composant Greengrass nucleus.

Valeur par défaut : 100

sessionExpirySeconds

(Facultatif) Durée en secondes pendant laquelle vous pouvez demander la durée d'une session auprès d'IoT Core. La valeur par défaut est la durée maximale prise en charge par AWS IoT Core.

Cette fonctionnalité est disponible pour la version 2.10.0 et les versions ultérieures du composant Greengrass nucleus.

Valeur par défaut : 604800 (7 days)

minimumReconnectDelaySeconds

(Facultatif) Une option pour le comportement de reconnexion. Durée minimale en secondes pour que MQTT se reconnecte.

Cette fonctionnalité est disponible pour la version 2.10.0 et les versions ultérieures du composant Greengrass nucleus.

Valeur par défaut : 1

maximumReconnectDelaySeconds

(Facultatif) Une option pour le comportement de reconnexion. Durée maximale en secondes pour que MQTT se reconnecte.

Cette fonctionnalité est disponible pour la version 2.10.0 et les versions ultérieures du composant Greengrass nucleus.

Valeur par défaut : 120

minimumConnectedTimeBeforeRetryResetSeconds

(Facultatif) Une option pour le comportement de reconnexion. Durée en secondes pendant laquelle la connexion doit être active avant que le délai de nouvelle tentative ne soit rétabli au minimum.

Cette fonctionnalité est disponible pour la version 2.10.0 et les versions ultérieures du composant Greengrass nucleus.

Valeur par défaut : 30

jvmOptions

(Facultatif) Les options JVM à utiliser pour exécuter le logiciel AWS IoT Greengrass Core. Pour plus d'informations sur les options JVM recommandées pour exécuter le logiciel AWS IoT Greengrass Core, consultezContrôlez l'allocation de mémoire grâce aux options JVM.

Important

Lorsque vous déployez une modification de ce paramètre de configuration, le logiciel AWS IoT Greengrass Core redémarre pour que la modification soit prise en compte.

iotDataEndpoint

Le point AWS IoT de terminaison de données pour votre Compte AWS.

Lorsque vous exécutez le logiciel AWS IoT Greengrass Core avec --provision true cette option, le logiciel récupère vos données et informations d'identification à partir des points de terminaison AWS IoT et les place dans le composant Nucleus.

iotCredEndpoint

Le point de terminaison des informations d' AWS IoT identification pour votre Compte AWS.

greengrassDataPlaneEndpoint

Cette fonctionnalité est disponible dans les versions 2.7.0 et ultérieures de ce composant.

(Facultatif) Le point de terminaison du plan de données Greengrass à utiliser. Paramétrez iotdata pour utiliser le même point de terminaison que le point de terminaison de données IoT spécifié dansiotDataEndpoint.

Vous devez définir cette option sur iotdata dans les cas suivants :

Vous utilisez un certificat d'appareil signé par une autorité de certification (CA) privée. Pour de plus amples informations, veuillez consulter Utiliser un certificat d'appareil signé par une autorité de certification privée.
Vous déployez les mises à jour de configuration du noyau pour basculer la connectivité IoT de l'appareil vers une autre région Compte AWS ou une autre région. Sans ce paramètre, le plan de données reste lié au compte d'origine après le changement de connectivité. Cela interrompt les téléchargements d'artefacts des composants et les opérations du plan de contrôle. Pour de plus amples informations, veuillez consulter Passez d'un appareil Greengrass Core à un autre Compte AWS ou région.

Vous pouvez définir cette option lors du déploiement ou de l'installation à l'aide de l'argument --init-config installer.

Par défaut : "" (chaîne vide — utilise le point de terminaison du service Greengrass)

greengrassDataPlanePort

Cette fonctionnalité est disponible dans les versions 2.0.4 et ultérieures de ce composant.

(Facultatif) Port à utiliser pour les connexions au plan de données. Pour de plus amples informations, veuillez consulter Connexion au port 443 ou via un proxy réseau.

Important

Vous devez spécifier un port sur lequel l'appareil peut établir des connexions sortantes. Si vous spécifiez un port bloqué, l'appareil ne pourra pas se connecter pour AWS IoT Greengrass recevoir des déploiements.

Sélectionnez l’une des options suivantes :

443
8443

Valeur par défaut : 8443

awsRegion

Le Région AWS à utiliser.

runWithDefault

Utilisateur du système à utiliser pour exécuter les composants.

Important

Lorsque vous déployez une modification de ce paramètre de configuration, le logiciel AWS IoT Greengrass Core redémarre pour que la modification soit prise en compte.

Cet objet contient les informations suivantes :

posixUser

Le nom ou l'ID de l'utilisateur du système et, éventuellement, du groupe système que le périphérique principal utilise pour exécuter des composants génériques et Lambda. Spécifiez l'utilisateur et le groupe en les séparant par deux points (:) au format suivant : user:group. Le groupe est facultatif. Si vous ne spécifiez aucun groupe, le logiciel AWS IoT Greengrass Core utilise le groupe principal pour l'utilisateur. Par exemple, vous définissez ggc_user ou ggc_user:ggc_group. Pour de plus amples informations, veuillez consulter Configurer l'utilisateur qui exécute les composants.

Lorsque vous exécutez le programme d'installation du logiciel AWS IoT Greengrass Core avec l'--component-default-user ggc_user:ggc_groupoption, le logiciel définit ce paramètre dans le composant Nucleus.

windowsUser

Cette fonctionnalité est disponible dans les versions 2.5.0 et ultérieures de ce composant.

Nom de l'utilisateur Windows à utiliser pour exécuter ce composant sur les appareils Windows principaux. L'utilisateur doit exister sur chaque appareil Windows Core, et son nom et son mot de passe doivent être stockés dans l'instance Credentials Manager du LocalSystem compte. Pour de plus amples informations, veuillez consulter Configurer l'utilisateur qui exécute les composants.

Lorsque vous exécutez le programme d'installation du logiciel AWS IoT Greengrass Core avec l'--component-default-user ggc_useroption, le logiciel définit ce paramètre dans le composant Nucleus.

systemResourceLimits

Cette fonctionnalité est disponible dans les versions 2.4.0 et ultérieures de ce composant. AWS IoT Greengrass ne prend pas actuellement en charge cette fonctionnalité sur les appareils Windows Core.

Les limites de ressources système à appliquer par défaut aux processus de composants Lambda génériques et non conteneurisés. Vous pouvez modifier les limites de ressources système pour des composants individuels lorsque vous créez un déploiement. Pour de plus amples informations, veuillez consulter Configuration des limites de ressources système pour les composants.

Cet objet contient les informations suivantes :

cpus: Durée maximale du processeur que les processus de chaque composant peuvent utiliser sur le périphérique principal. Le temps processeur total d'un appareil principal est équivalent au nombre de cœurs processeurs de l'appareil. Par exemple, sur un périphérique principal doté de 4 cœurs de processeur, vous pouvez définir cette valeur 2 pour limiter les processus de chaque composant à 50 % d'utilisation de chaque cœur de processeur. Sur un appareil doté d'un cœur de processeur, vous pouvez définir cette valeur 0.25 pour limiter les processus de chaque composant à 25 % d'utilisation du processeur. Si vous définissez cette valeur sur un nombre supérieur au nombre de cœurs du processeur, le logiciel AWS IoT Greengrass Core ne limite pas l'utilisation du processeur par les composants.
memory: La quantité maximale de RAM (en kilo-octets) que les processus de chaque composant peuvent utiliser sur le périphérique principal.

s3EndpointType

(Facultatif) Type de point de terminaison S3. Ce paramètre ne prendra effet que pour la région USA Est (Virginie du Nordus-east-1) (). La définition de ce paramètre à partir de n'importe quelle autre région sera ignorée. Sélectionnez l’une des options suivantes :

REGIONAL— Le client S3 et l'URL présignée utilisent le point de terminaison régional.
GLOBAL— Le client S3 et l'URL présignée utilisent l'ancien point de terminaison.
DUALSTACK— L'URL présignée S3 utilise le point de terminaison Dualstack.

Valeur par défaut : GLOBAL

fipsMode

(Facultatif) Fait en sorte que Greengrass utilise les points de terminaison FIPS. Pour plus d'informations sur la façon d'activer les points de terminaison FIPS, consultez la section Points de terminaison FIPS.

Sélectionnez l’une des options suivantes :

trueLorsqu'il est défini sur true, les points de terminaison utiliseront le point de terminaison FIPS.
falseSi la valeur est fausse, les points de terminaison n'utiliseront pas le point de terminaison FIPS.

Valeur par défaut : false

logging

(Facultatif) Configuration de journalisation pour le périphérique principal. Pour plus d'informations sur la configuration et l'utilisation des journaux Greengrass, consultezAWS IoT Greengrass Journaux de surveillance.

Cet objet contient les informations suivantes :

level

(Facultatif) Le niveau minimum de messages de journal à générer.

Choisissez parmi les niveaux de journalisation suivants, répertoriés ici par ordre de niveau :

DEBUG
INFO
WARN
ERROR

Valeur par défaut : INFO

format

(Facultatif) Format de données des journaux. Sélectionnez l’une des options suivantes :

TEXT— Choisissez cette option si vous souhaitez afficher les journaux sous forme de texte.
JSON— Choisissez cette option si vous souhaitez afficher les journaux à l'aide de la commande Greengrass CLI logs ou interagir avec les journaux par programmation.

Valeur par défaut : TEXT

outputType

(Facultatif) Type de sortie pour les journaux. Sélectionnez l’une des options suivantes :

FILE— Le logiciel AWS IoT Greengrass Core génère des journaux dans les fichiers du répertoire que vous spécifiezoutputDirectory.
CONSOLE— Le logiciel AWS IoT Greengrass Core imprime les journaux surstdout. Choisissez cette option pour afficher les journaux au fur et à mesure que le périphérique principal les imprime.

Valeur par défaut : FILE

fileSizeKB

(Facultatif) Taille maximale de chaque fichier journal (en kilo-octets). Lorsqu'un fichier journal dépasse cette taille maximale, le logiciel AWS IoT Greengrass Core crée un nouveau fichier journal.

Ce paramètre s'applique uniquement lorsque vous spécifiez FILE pouroutputType.

Valeur par défaut : 1024

totalLogsSizeKB

(Facultatif) Taille totale maximale des fichiers journaux (en kilo-octets) pour chaque composant, y compris le noyau Greengrass. Les fichiers journaux du noyau Greengrass incluent également les journaux des composants du plugin. Lorsque la taille totale des fichiers journaux d'un composant dépasse cette taille maximale, le logiciel AWS IoT Greengrass Core supprime les fichiers journaux les plus anciens de ce composant.

Ce paramètre est équivalent au paramètre de limite d'espace Gestionnaire de journaux disque du composant Log Manager (diskSpaceLimit), que vous pouvez spécifier pour le noyau Greengrass (système) et chaque composant. Le logiciel AWS IoT Greengrass Core utilise le minimum des deux valeurs comme taille logarithmique totale maximale pour le noyau Greengrass et chaque composant.

Ce paramètre s'applique uniquement lorsque vous spécifiez FILE pouroutputType.

Valeur par défaut : 10240

outputDirectory

(Facultatif) Le répertoire de sortie des fichiers journaux.

Ce paramètre s'applique uniquement lorsque vous spécifiez FILE pouroutputType.

Par défaut :/greengrass/v2/logs, où se /greengrass/v2 trouve le dossier AWS IoT Greengrass racine.

fleetstatus

Ce paramètre est disponible dans les versions 2.1.0 et ultérieures de ce composant.

(Facultatif) Configuration de l'état du parc pour le périphérique principal.

Cet objet contient les informations suivantes :

periodicStatusPublishIntervalSeconds

(Facultatif) La durée (en secondes) entre laquelle le périphérique principal publie l'état de l'appareil au AWS Cloud.

Minimum : 86400 (24 heures)

Par défaut : 86400 (24 heures)

telemetry

(Facultatif) Configuration de la télémétrie d'état du système pour le périphérique principal. Pour plus d'informations sur les mesures de télémétrie et sur la manière d'agir sur les données de télémétrie, consultez. Collectez les données de télémétrie relatives à l'état du système à partir des principaux appareils AWS IoT Greengrass

Cet objet contient les informations suivantes :

enabled

(Facultatif) Vous pouvez activer ou désactiver la télémétrie.

Valeur par défaut : true

periodicAggregateMetricsIntervalSeconds

(Facultatif) Intervalle (en secondes) pendant lequel le périphérique principal regroupe les métriques.

Si vous définissez cette valeur en dessous de la valeur minimale prise en charge, le noyau utilise la valeur par défaut à la place.

Minimum : 3600

Valeur par défaut : 3600

periodicPublishMetricsIntervalSeconds

(Facultatif) La durée (en secondes) entre laquelle le périphérique principal publie des mesures de télémétrie au. AWS Cloud

Si vous définissez cette valeur en dessous de la valeur minimale prise en charge, le noyau utilise la valeur par défaut à la place.

Minimum : 86400

Valeur par défaut : 86400

deploymentPollingFrequencySeconds

(Facultatif) Période en secondes pendant laquelle vous souhaitez interroger les notifications de déploiement.

Valeur par défaut : 15

componentStoreMaxSizeBytes

(Facultatif) Taille maximale sur disque du magasin de composants, qui comprend les recettes et les artefacts des composants.

Par défaut : 10000000000 (10 Go)

bootConfigTlogCompactionThresholdBytes

Ce paramètre est disponible dans les versions 2.18.3 et ultérieures de ce composant.

(Facultatif) Seuil de taille, en octets, auquel le noyau Greengrass compacte son journal des transactions de configuration (config.tlog) lorsque le périphérique principal démarre.

Le compactage ne modifie pas votre configuration. Il supprime uniquement les entrées obsolètes du journal, ce qui réduit le temps de démarrage et l'utilisation du disque sur le périphérique principal.

Pour désactiver le compactage au démarrage, définissez cette valeur sur 0 ou sur une valeur négative.

Spécifiez le seuil sous la forme d'un nombre d'octets, par exemple10000000. Le noyau accepte également la notation scientifique, telle que1e7. Si vous définissez une valeur qui n'est pas un nombre, par exemple20MB, le noyau utilise la valeur par défaut et enregistre un avertissement dans ses journaux. Une valeur non valide ne désactive pas le compactage.

Note

Le compactage n'empêche pas le démarrage de votre appareil. Si le noyau ne parvient pas à compacter le journal, le périphérique principal démarre normalement avec le journal non compacté et enregistre l'erreur dans ses journaux. Le noyau essaie à nouveau au prochain démarrage de l'appareil principal.

Par défaut : 10000000 (10 Mo)

platformOverride

(Facultatif) Un dictionnaire d'attributs identifiant la plate-forme de l'appareil principal. Utilisez-le pour définir des attributs de plate-forme personnalisés que les recettes de composants peuvent utiliser pour identifier le cycle de vie et les artefacts appropriés pour le composant. Par exemple, vous pouvez définir un attribut de capacité matérielle pour déployer uniquement l'ensemble minimal d'artefacts nécessaires à l'exécution d'un composant. Pour plus d'informations, consultez le paramètre de plate-forme manifeste dans la recette du composant.

Vous pouvez également utiliser ce paramètre pour modifier les attributs os et la architecture plate-forme du périphérique principal.

httpClient

Ce paramètre est disponible dans les versions 2.5.0 et ultérieures de ce composant.

(Facultatif) Configuration du client HTTP pour le périphérique principal. Ces options de configuration s'appliquent à toutes les requêtes HTTP effectuées par ce composant. Si un périphérique principal fonctionne sur un réseau plus lent, vous pouvez augmenter ces durées de temporisation pour éviter que les requêtes HTTP n'expirent.

Cet objet contient les informations suivantes :

connectionTimeoutMs

(Facultatif) Durée (en millisecondes) nécessaire à l'ouverture d'une connexion avant l'expiration de la demande de connexion.

Par défaut : 2000 (2 secondes)

socketTimeoutMs

(Facultatif) Durée (en millisecondes) à attendre que les données soient transférées via une connexion ouverte avant l'expiration de la connexion.

Par défaut : 30000 (30 secondes)

deploymentConfigurationTimeSource

Ce paramètre est disponible dans les versions 2.15.0 et ultérieures de ce composant.

(Facultatif) L'horodatage à utiliser lors du traitement d'un déploiement. La valeur par défaut estdeploymentCreationTime.

Cet objet contient les valeurs suivantes :

deploymentCreationTime

La valeur par défaut dedeploymentConfigurationTimeSource. L'appareil utilise l'horodatage de création du déploiement pour résoudre les conflits de clés de configuration pendant le traitement. Lorsque ce comportement est sélectionné, la configuration du périphérique local détenue par le noyau peut avoir un horodatage plus long que celui du déploiement entrant et rejette les modifications de configuration entrantes qui sont désormais considérées comme obsolètes.

deploymentProcessingTime

L'appareil utilise son horodatage local pour résoudre les conflits de clés de configuration lors du traitement du déploiement. Une fois traitées, l'appareil met à jour les configurations en fonction de l'horodatage de traitement plutôt que de l'horodatage de création du déploiement. Ce comportement suppose que l'horloge de l'appareil est correctement calibrée.

Configurez ce paramètre principal dans l'image ou l'installation initiale de votre appareil plutôt que par le biais d'un déploiement lorsque vous souhaitez que les nouveaux appareils utilisent ce comportement lors de la première connexion. Utilisez l'--init-configoption du programme d'installation de Nucleus Classic pour cette configuration.

Cette configuration initiale est essentielle car les appareils traitent plusieurs déploiements dans un ordre arbitraire. Sans configuration initiale appropriée, un périphérique peut traiter les déploiements en utilisant le deploymentCreationTime comportement par défaut avant de recevoir le déploiement qui définit la configuration du noyau surdeploymentProcessingTime.

Exemple Exemple : fusion de configuration et mise à jour


{
  "iotRoleAlias": "GreengrassCoreTokenExchangeRoleAlias",
  "networkProxy": {
    "noProxyAddresses": "http://192.168.0.1,www.example.com",
    "proxy": {
      "url": "http://my-proxy-server:1100",
      "username": "Mary_Major",
      "password": "pass@word1357"
    }
  },
  "mqtt": {
    "port": 443
  },
  "greengrassDataPlanePort": 443,
  "jvmOptions": "-Xmx64m",
  "runWithDefault": {
    "posixUser": "ggc_user:ggc_group"
  }
}

Fichier journal local

Ce composant utilise le fichier journal suivant.

Pour afficher les journaux de ce composant

Exécutez la commande suivante sur le périphérique principal pour afficher le fichier journal de ce composant en temps réel. Remplacez /greengrass/v2 ou C:\greengrass\v2 par le chemin d'accès au dossier AWS IoT Greengrass racine.
Linux
```
sudo tail -f /greengrass/v2/logs/greengrass.log
```
Windows (PowerShell)
```
Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait
```

Journal des modifications

Le tableau suivant décrit les modifications apportées à chaque version du composant.

Version	Modifications
2,18,3	Nouvelles fonctionnalités Ajoute le paramètre `bootConfigTlogCompactionThresholdBytes` de configuration pour activer le compactage du journal des transactions de configuration au démarrage, ce qui permet de libérer de l'espace disque sur les périphériques principaux. Corrections de bugs et améliorations Résout un problème selon lequel l'échec du premier déploiement pouvait entraîner la perte de l'appartenance du noyau à un groupe d'appareils et la suppression des composants installés après un redémarrage.
2,18,2	Corrections de bugs et améliorations Résout un problème où le noyau pouvait écrire des valeurs de configuration inchangées dans le magasin de configuration.
2,18,1	Corrections de bugs et améliorations Résout un problème où le noyau pouvait ne pas récupérer les informations d'identification après un échec de connexion transitoire.
2.18.0	Nouvelles fonctionnalités Ajoute la prise en charge de la commutation de la AWS IoT connectivité d'un appareil principal vers une autre région Compte AWS ou une autre via le déploiement d'une configuration Nucleus. Le noyau valide la connectivité aux nouveaux points de terminaison avant d'appliquer la modification et signale l'état du déploiement du terminal au compte source. Ajoute la prise en charge de Windows Server 2025. Corrections de bugs et améliorations Résout un problème de synchronisation de démarrage sur les appareils systemd en démarrant le logiciel AWS IoT Greengrass Core uniquement après la synchronisation de l'horloge système. Résout un problème où un composant pouvait rencontrer des abonnements périmés après avoir fermé un flux IPC local lors d'une demande d'abonnement en cours. Correction et amélioration de bogues généraux
2.17.0	Nouvelles fonctionnalités Installe tous les certificats Amazon Root CA pendant le provisionnement automatique. Ajoute un cycle de vie de désinstallation qui s'exécute lorsqu'un déploiement supprime un composant. Permet d'installer le logiciel Greengrass Core en tant qu'utilisateur Linux normal.
2,16,1	Corrections de bugs et améliorations Ajoute une configuration pour les intervalles de nouvelle tentative d'identification après les échecs du service Token Exchange.
2.16.0	Nouvelles fonctionnalités Nucleus prend désormais en charge les cgroups V2. Corrections de bugs et améliorations Résout un problème qui empêchait le noyau de nettoyer les déploiements périmés lorsqu'un déploiement était annulé.
2,15.1	Corrections de bugs et améliorations Résout un problème en raison duquel le noyau ne parvenait pas à nettoyer les processus des composants après le délai d'arrêt de 30 secondes pendant les déploiements bootstrap.
2.15.0	Nouvelles fonctionnalités Ajoute une fonction de télémétrie pour inclure des informations sur le système hôte, telles que les détails du processeur et du système d'exploitation. Pour plus d'informations, consultez la page des composants de télémétrie. Ajoute une `deploymentConfigurationTimeSource` configuration. Pour plus d'informations, consultez la section Configuration des composants du noyau. Corrections de bugs et améliorations Nucleus donne désormais la priorité à l'utilisation de versions et d'artefacts locaux par défaut, améliorant ainsi la cohérence du déploiement et réduisant les dépendances externes. Les utilisateurs peuvent modifier ce comportement en spécifiant d'autres préférences dans le document de déploiement. Ajoute un nouveau journal d'avertissements lorsqu'un utilisateur Windows fourni ne correspond pas au jeu de caractères normalement accepté par Windows.
2,14.3	Corrections de bugs et améliorations Permet au service d'échange de jetons de redémarrer en cas de modification de la configuration des ports. Résout un problème en raison duquel le service d'état de la flotte n'envoie pas de messages de modification de l'état des composants pour les lambdas non épinglés s'ils ne sont pas déclenchés. Résout un problème en raison duquel les composants ne s'arrêtent pas automatiquement lorsqu'une nouvelle version de composant est déployée. Résout un problème où les hooks d'injection des plugins intégrés sont exécutés deux fois, ce qui entraîne des événements de cycle de vie supplémentaires et une journalisation dupliquée. Améliore la journalisation du cycle de vie des composants sur les appareils Windows.
2,14,2	Corrections de bugs et améliorations Résout un problème en raison duquel un client HTTP n'est pas configuré avec une authentification mutuelle.
2,14,1	Corrections de bugs et améliorations Résout un problème en raison duquel les composants n'étaient pas arrêtés correctement sur les nouvelles installations de Greengrass.
2.14.0	Avertissement Cette version n'est plus disponible. Les améliorations apportées à cette version sont disponibles dans les versions ultérieures de ce composant. Nouvelles fonctionnalités La nouvelle prise en charge des terminaux à double pile permet la communication réseau IPv6. Résilience accrue contre les échecs de redémarrage du noyau et la corruption `Launch` des répertoires. Corrections de bugs et améliorations Corrige les fuites de mémoire lors de la fermeture PubSub d'abonnements IPC. Corrige le cycle de vie d'exécution du composant lorsqu'il passe à l'état ERRORED en raison d'un délai de démarrage lorsque la condition skipif est vraie. Résout un problème en raison duquel le périphérique principal ne parvient pas à se connecter AWS IoT Core lorsque la politique TLS est définie sur TLS13_1_3_2022_10.
2.13.0	Nouvelles fonctionnalités Supportez le point de terminaison FIPS dans Nucleus. Corrections de bugs et améliorations Améliorations relatives à l'annulation du déploiement : les déploiements peuvent désormais être annulés pendant la fusion d'une nouvelle configuration et en attendant le démarrage des services.
2,12,6	Corrections de bugs et améliorations Résout un problème qui provoquait un plantage au démarrage de certains processeurs ARMv8, notamment le Jetson Nano.
2.12.5	Corrections de bugs et améliorations Résout un problème où la restauration du déploiement se bloque parfois lors de la restauration d'un composant précédemment cassé avec des dépendances matérielles. Résout un problème en raison duquel le noyau ne publie pas de mises à jour de statut après l'approvisionnement de la flotte. Ajoute de nouvelles tentatives pour l'`GetDeploymentConfiguration`API après avoir reçu des erreurs 404.
2,12,4	Corrections de bugs et améliorations Résout un problème où le noyau entre en état de blocage lors du démarrage sur certains appareils Linux.
2,12,3	Avertissement Cette version n'est plus disponible. Les améliorations apportées à cette version sont disponibles dans les versions ultérieures de ce composant. Corrections de bugs et améliorations Résout un problème en raison duquel le noyau ne signale pas l'état correct des composants après le redémarrage du noyau et pendant la restauration des composants. Correction et amélioration de bogues généraux
2.12.2	Corrections de bugs et améliorations Résout un problème où les anciens journaux n'étaient pas nettoyés correctement. Correction et amélioration de bogues généraux
2.12.1	Corrections de bugs et améliorations Résout un problème en raison duquel le noyau peut dupliquer les abonnements MQTT à des sujets de déploiement, ce qui entraînait une journalisation supplémentaire et des publications MQTT.
2.12.0	Nouvelles fonctionnalités Vous permet d'exécuter les étapes du cycle de vie du bootstrap dans le cadre d'un déploiement de restauration.
2,11,3	Corrections de bugs et améliorations Résout un problème dans le noyau qui pouvait démarrer un composant de manière incorrecte lorsque ses dépendances échouent. Nouvelles fonctionnalités Ajoute un type de point de terminaison S3 configurable.
2,11,2	Corrections de bugs et améliorations Résout un problème dans le client Nucleus MQTT 5 qui pouvait apparaître hors ligne lorsqu'un grand nombre (> 50) d'abonnements sont utilisés. Ajoute une nouvelle tentative pour l'échec TCP de Docker Dial.
2.11.1	Corrections de bugs et améliorations Résout un problème qui empêchait le noyau de démarrer en cas d'échec d'une tâche d'amorçage et d'endommagement du fichier de métadonnées de déploiement. Résout un problème selon lequel les composants Lambda à la demande ne sont pas signalés dans les mises à jour de l'état du déploiement. Ajoute la prise en charge des ID de politique d'autorisation dupliqués.
2.11.0	Nouvelles fonctionnalités Vous permet d'annuler un déploiement local. Vous permet de configurer une politique de gestion des défaillances pour un déploiement local. Ajoute la prise en charge d'un plug-in de spouleur de disque.
2,10,3	Corrections de bugs et améliorations Résout un problème en raison duquel Greengrass ne s'abonne pas aux notifications de déploiement lorsqu'il utilise le fournisseur PKCS #11.
2.10.2	Corrections de bugs et améliorations Permet une analyse des cycles de vie des composants sans distinction majuscules/minuscules. Résout un problème en raison duquel la variable d'environnement PATH n'était pas recréée correctement. Corrige le codage des URI proxy pour les composants, y compris le gestionnaire de flux pour les noms d'utilisateur contenant des caractères spéciaux.
2.10.1	Corrections de bugs et améliorations Résout un problème qui pouvait provoquer un plantage au démarrage de certains processeurs ARMv8, notamment le Jetson Nano. Greengrass ne ferme plus la norme d'un composant dans, cela ramène le comportement au comportement antérieur à la version 2.10.0
2.10.0	Nouvelles fonctionnalités Ajoute la prise `interpolateComponentConfiguration` en charge de l'expression régulière vide. Greengrass interpole désormais à partir de l'objet de configuration racine. Ajoute le support pour MQTT5. Ajoute un mécanisme permettant de charger rapidement les composants du plugin sans numérisation. Permet à Greengrass d'économiser de l'espace disque en supprimant les images Docker inutilisées. Corrections de bugs et améliorations Résout un problème selon lequel la restauration laisse certaines valeurs de configuration en place lors d'un déploiement. Résout un problème en raison duquel le noyau Greengrass valide une séquence de AWS domaines dans les points de terminaison personnalisés sans informations AWS d'identification et de données. Met à jour la résolution des dépendances multigroupes pour résoudre à nouveau toutes les dépendances de groupe par AWS Cloud négociation, au lieu de se verrouiller sur la version active. Cette mise à jour supprime également le code d'erreur de déploiement`INSTALLED_COMPONENT_NOT_FOUND`. Met à jour le noyau Greengrass pour ignorer le téléchargement des images Docker lorsqu'elles existent déjà localement. Met à jour le noyau Greengrass pour relancer une étape d'installation des composants avant l'expiration du délai. Corrections et améliorations mineures supplémentaires.
2,9.6	Corrections de bugs et améliorations Résout un problème en raison duquel un déploiement de Greengrass échoue avec l'erreur LAUNCH_DIRECTORY_CORRUPTED et un redémarrage ultérieur de l'appareil ne démarre pas Greengrass. Cette erreur peut se produire lorsque vous déplacez l'appareil Greengrass entre plusieurs groupes d'objets dans le cadre de déploiements nécessitant le redémarrage de Greengrass.
2,9.5	Nouvelles fonctionnalités Ajoute la prise en charge de la vérification de la signature du logiciel Greengrass Nucleus. Corrections de bugs et améliorations Résout un problème d'échec du déploiement lorsque la région des métadonnées de la recette locale ne correspond pas à la région de lancement du noyau Greengrass. Le noyau Greengrass renégocie désormais avec le cloud lorsque cela se produit. Résout un problème à cause duquel le spouleur de messages MQTT se remplit et ne supprime jamais les messages. Corrections et améliorations mineures supplémentaires.
2.9.4	Corrections de bugs et améliorations Vérifie la présence d'un message nul avant de supprimer les messages QOS 0. Tronque les valeurs détaillées du statut de la tâche si elles dépassent la limite de 1 024 caractères. Met à jour le script bootstrap pour Windows afin de lire correctement le chemin racine de Greengrass s'il contient des espaces. Met à jour l'abonnement AWS IoT Core afin de supprimer les messages des clients si la réponse à l'abonnement n'a pas été envoyée. Garantit que le noyau charge sa configuration à partir des fichiers de sauvegarde lorsque le fichier de configuration principal est endommagé ou manquant.
2,9.3	Corrections de bugs et améliorations Garantit que les identifiants des clients MQTT ne sont pas dupliqués. Ajoute une lecture et une écriture de fichiers plus robustes pour éviter la corruption et y remédier. Réessaie Docker Image Pull sur des erreurs spécifiques liées au réseau. Ajoute l'`noProxyAddresses`option de connexion MQTT.
2,9.2	Corrections de bugs et améliorations Résout un problème selon lequel la configuration `interpolateComponentConfiguration` ne s'applique pas à un déploiement en cours. Utilise OSHI pour répertorier tous les processus enfants.
2.9.1	Corrections de bugs et améliorations Ajoute un correctif permettant à Greengrass de redémarrer si un déploiement supprime un composant de plug-in.
2.9.0	Nouvelles fonctionnalités Permet de créer des sous-déploiements qui réessayent les déploiements avec un sous-ensemble d'appareils plus petit. Cette fonctionnalité permet de tester et de résoudre plus efficacement les déploiements infructueux. Corrections de bugs et améliorations Améliore la prise en charge des systèmes qui ne disposent pas de `useraddgroupadd`, et`usermod`. Corrections et améliorations mineures supplémentaires.
2,8.1	Corrections de bugs et améliorations Résout un problème où les codes d'erreur de déploiement n'étaient pas générés correctement à partir d'erreurs de l'API Greengrass. Résout un problème en raison duquel les mises à jour de l'état de la flotte envoient des informations inexactes lorsqu'un composant atteint un `ERRORED` état lors d'un déploiement. Résout un problème qui empêchait les déploiements de se terminer lorsque Greengrass disposait de plus de 50 abonnements existants.
2.8.0	Nouvelles fonctionnalités Met à jour le noyau Greengrass pour signaler une réponse à l'état de santé du déploiement qui inclut des codes d'erreur détaillés en cas de problème lors du déploiement de composants sur un périphérique principal. Pour de plus amples informations, veuillez consulter Codes d'erreur de déploiement détaillés. Met à jour le noyau Greengrass pour signaler une réponse à l'état de santé du composant qui inclut des codes d'erreur détaillés lorsqu'un composant passe à l'`ERRORED`état `BROKEN` ou. Pour de plus amples informations, veuillez consulter Codes d'état détaillés des composants. Élargit les champs des messages d'état afin d'améliorer les informations sur la disponibilité du cloud pour les appareils. Améliore la robustesse du service d'état de la flotte. Corrections de bugs et améliorations Permet à un composant défectueux de se réinstaller lorsque sa configuration change. Résout un problème en raison duquel le redémarrage du noyau pendant le déploiement Bootstrap entraîne l'échec du déploiement. Résout un problème dans Windows en raison duquel l'installation échoue lorsqu'un chemin racine contient des espaces. Résout un problème selon lequel l'arrêt d'un composant lors d'un déploiement utilise le script d'arrêt de la nouvelle version. Diverses améliorations en matière d'arrêt. Corrections et améliorations mineures supplémentaires.
2.7.0	Nouvelles fonctionnalités Met à jour le noyau Greengrass pour envoyer des mises à jour de statut au AWS IoT Greengrass cloud lorsque l'appareil principal applique un déploiement local. Ajoute la prise en charge des certificats clients signés par une autorité de certification (CA) personnalisée, auprès de laquelle cette autorité n'est pas enregistrée AWS IoT. Pour utiliser cette fonctionnalité, vous pouvez définir la nouvelle option `greengrassDataPlaneEndpoint` de configuration sur`iotdata`. Pour de plus amples informations, veuillez consulter Utiliser un certificat d'appareil signé par une autorité de certification privée. Corrections de bugs et améliorations Résout un problème en raison duquel le noyau Greengrass annule un déploiement dans certains scénarios lorsque le noyau est arrêté ou redémarré. Le déploiement du noyau reprend à présent après son redémarrage. Met à jour le programme d'installation de Greengrass afin de respecter l'`--start`argument lorsque vous spécifiez de configurer le logiciel en tant que service système. Met à jour le comportement de SubscribeToComponentUpdates la définition de l'ID de déploiement dans les événements où le noyau a mis à jour un composant. Corrections et améliorations mineures supplémentaires.
2.6.0	Nouvelles fonctionnalités Ajoute la prise en charge des caractères génériques MQTT lorsque vous vous abonnez à des sujets locaux publish/subscribe . Pour plus d’informations, consultez Publier/souscrire des messages locaux et SubscribeToTopic. Ajoute la prise en charge des variables de recette dans les configurations de composants, autres que la variable de `component_dependency_name:configuration:json_pointer` recette. Vous pouvez utiliser ces variables de recettes lorsque vous définissez un composant `DefaultConfiguration` dans une recette ou lorsque vous configurez un composant dans un déploiement. Pour activer cette fonctionnalité, définissez l'option de ComponentConfiguration configuration d'interpolation sur. `true` Pour plus d’informations, consultez Variables de recette et Utiliser des variables de recette dans les mises à jour de fusion. Ajoute une prise en charge complète du `` caractère générique dans les politiques d'autorisation de communication interprocessus (IPC). Vous pouvez désormais spécifier le `` caractère d'une chaîne de ressources pour qu'il corresponde à n'importe quelle combinaison de caractères. Pour de plus amples informations, veuillez consulter Des caractères génériques dans les politiques d'autorisation. Ajoute la prise en charge des composants personnalisés pour appeler les opérations IPC utilisées par la CLI Greengrass. Vous pouvez utiliser ces opérations IPC pour gérer les déploiements locaux, afficher les détails des composants et générer un mot de passe que vous pouvez utiliser pour vous connecter à la console de débogage locale. Pour plus d'informations, consultez IPC : Gérer les déploiements et les composants locaux. Corrections de bugs et améliorations Résout un problème en raison duquel les composants dépendants ne réagissaient pas lorsque leurs dépendances physiques redémarraient ou changeaient d'état dans certains scénarios. Améliore les messages d'erreur que l'appareil principal signale au service AWS IoT Greengrass cloud en cas d'échec d'un déploiement. Résout un problème en raison duquel le noyau Greengrass appliquait le déploiement d'un objet à deux reprises dans certains scénarios lors du redémarrage du noyau. Corrections et améliorations mineures supplémentaires. Pour plus d'informations, consultez les communiqués sur GitHub.
2.5.6	Nouvelles fonctionnalités Ajoute la prise en charge des modules de sécurité matériels qui utilisent des clés ECC. Vous pouvez utiliser un module de sécurité matériel (HSM) pour stocker en toute sécurité la clé privée et le certificat de l'appareil. Pour de plus amples informations, veuillez consulter Intégration de sécurité matérielle. Corrections de bugs et améliorations Résout un problème selon lequel le déploiement ne se termine jamais lorsque vous déployez un composant dont le script d'installation n'est pas valide dans certains scénarios. Améliore les performances au démarrage. Corrections et améliorations mineures supplémentaires.
2.5.5	Nouvelles fonctionnalités Ajoute la variable d'`GG_ROOT_CA_PATH`environnement pour les composants, afin que vous puissiez accéder au certificat d'autorité de certification (CA) racine dans les composants personnalisés. Corrections de bugs et améliorations Ajoute la prise en charge des appareils Windows qui utilisent une langue d'affichage autre que l'anglais. Met à jour la façon dont le noyau Greengrass analyse les arguments booléens de l'installateur, afin que vous puissiez spécifier un argument booléen sans valeur booléenne pour spécifier une valeur. `true` Par exemple, vous pouvez désormais spécifier `--provision` plutôt que d'`--provision true`installer avec le provisionnement automatique des ressources. Résout un problème en raison duquel l'appareil principal ne signalait pas son état au service AWS IoT Greengrass cloud après le provisionnement dans certains scénarios. Corrections et améliorations mineures supplémentaires.
2,5.4	Corrections de bugs et améliorations Correction et amélioration de bogues généraux
2.5.3	Nouvelles fonctionnalités Ajoute la prise en charge de l'intégration de la sécurité matérielle. Vous pouvez utiliser un module de sécurité matériel (HSM) pour stocker en toute sécurité la clé privée et le certificat de l'appareil. Pour de plus amples informations, veuillez consulter Intégration de sécurité matérielle. Corrections de bugs et améliorations Résout un problème lié aux exceptions d'exécution pendant que le noyau établit des connexions MQTT avec AWS IoT Core.
2.5.2	Corrections de bugs et améliorations Résout un problème en raison duquel, après les mises à jour du noyau Greengrass, le service Windows ne redémarre pas une fois que vous l'avez arrêté ou redémarré l'appareil.
2.5.1	Avertissement Cette version n'est plus disponible. Les améliorations apportées à cette version sont disponibles dans les versions ultérieures de ce composant. Corrections de bugs et améliorations Ajoute la prise en charge des versions 32 bits de l'environnement d'exécution Java (JRE) sous Windows. Modifie le comportement de suppression des groupes d'objets pour les appareils principaux dont la AWS IoT politique n'accorde pas l'`greengrass:ListThingGroupsForCoreDevice`autorisation. Avec cette version, le déploiement se poursuit, enregistre un avertissement et ne supprime aucun composant lorsque vous supprimez le périphérique principal d'un groupe d'objets. Pour de plus amples informations, veuillez consulter Déployer AWS IoT Greengrass des composants sur des appareils. Résout un problème lié aux variables d'environnement système que le noyau Greengrass met à la disposition des processus des composants de Greengrass. Vous pouvez désormais redémarrer un composant pour qu'il utilise les dernières variables d'environnement système.
2.5.0	Nouvelles fonctionnalités Ajoute la prise en charge des appareils principaux qui exécutent Windows. Modifiez le comportement de suppression des groupes d'objets. Avec cette version, vous pouvez supprimer un périphérique principal d'un groupe d'objets pour désinstaller les composants de ce groupe d'objets lors du prochain déploiement. À la suite de cette modification, la AWS IoT politique d'un appareil principal doit disposer de cette `greengrass:ListThingGroupsForCoreDevice` autorisation. Si vous avez utilisé le programme d'installation du logiciel AWS IoT Greengrass Core pour provisionner des ressources, la AWS IoT politique par défaut l'autorise`greengrass:*`, ce qui inclut cette autorisation. Pour de plus amples informations, veuillez consulter Authentification et autorisation de l'appareil pour AWS IoT Greengrass. Ajoute la prise en charge des configurations de proxy HTTPS. Pour de plus amples informations, veuillez consulter Connexion au port 443 ou via un proxy réseau. Ajoute le nouveau paramètre `windowsUser` de configuration. Vous pouvez utiliser ce paramètre pour spécifier l'utilisateur par défaut à utiliser pour exécuter des composants sur un périphérique Windows Core. Pour de plus amples informations, veuillez consulter Configurer l'utilisateur qui exécute les composants. Ajoute les nouvelles options `httpClient` de configuration que vous pouvez utiliser pour personnaliser les délais d'expiration des requêtes HTTP afin d'améliorer les performances sur les réseaux lents. Pour plus d'informations, consultez le paramètre de configuration HttpClient. Corrections de bugs et améliorations Corrige l'option de cycle de vie bootstrap pour redémarrer le périphérique principal à partir d'un composant. Ajoute la prise en charge des traits d'union dans les variables de recette. Corrige l'autorisation IPC pour les composants de la fonction Lambda à la demande. Améliore les messages de journal et fait passer les journaux non critiques d'un `DEBUG` niveau `INFO` à un autre, afin que les journaux soient plus utiles. Supprime l'`iot:DescribeCertificate`autorisation du rôle d'échange de jetons par défaut que le noyau Greengrass crée lorsque vous installez le logiciel AWS IoT Greengrass Core avec provisionnement automatique. Cette autorisation n'est pas utilisée par le noyau Greengrass. Résout un problème selon lequel le script de provisionnement automatique ne nécessite pas l'`iam:GetPolicy`autorisation s'il `iam:CreatePolicy` est disponible pour la même politique. Corrections et améliorations mineures supplémentaires.
2.4.0	Nouvelles fonctionnalités Ajoute la prise en charge des limites de ressources du système. Vous pouvez configurer la quantité maximale d'utilisation du processeur et de la RAM que les processus de chaque composant peuvent utiliser sur le périphérique principal. Pour de plus amples informations, veuillez consulter Configuration des limites de ressources système pour les composants. Ajoute des opérations IPC pour suspendre et reprendre les composants. Pour plus d’informations, consultez PauseComponent et ResumeComponent. Ajoute la prise en charge du provisionnement des plugins. Vous pouvez spécifier un fichier JAR à exécuter lors de l'installation afin de provisionner les AWS ressources requises pour un périphérique principal Greengrass. Le noyau Greengrass comprend une interface que vous pouvez implémenter pour développer des plugins d'approvisionnement personnalisés. Pour de plus amples informations, veuillez consulter Installation AWS IoT Greengrass Logiciel de base avec provisionnement personnalisé des ressources. Ajoute l'`thing-name-policy`argument facultatif au programme d'installation du logiciel AWS IoT Greengrass Core. Vous pouvez utiliser cette option pour spécifier une AWS IoT politique existante ou personnalisée lorsque vous installez le logiciel AWS IoT Greengrass Core avec provisionnement automatique des ressources. Corrections de bugs et améliorations Met à jour la configuration de journalisation au démarrage. Cela résout un problème où la configuration de journalisation n'était pas appliquée au démarrage. Met à jour le lien symbolique du chargeur Nucleus pour qu'il pointe vers le magasin de composants dans le dossier racine de Greengrass lors de l'installation. Cette mise à jour vous permet de supprimer le fichier JAR et les autres artefacts du noyau que vous téléchargez lors de l'installation du logiciel AWS IoT Greengrass Core. Corrections et améliorations mineures supplémentaires. Pour plus d'informations, consultez les communiqués sur GitHub.
2.3.0	Nouvelles fonctionnalités Ajoute la prise en charge des documents de configuration de déploiement jusqu'à 10 Mo, contre 7 Ko (pour les déploiements qui ciblent des objets) ou 31 Ko (pour les déploiements qui ciblent des groupes d'objets). Pour utiliser cette fonctionnalité, la AWS IoT politique d'un appareil principal doit autoriser cette `greengrass:GetDeploymentConfiguration` autorisation. Si vous avez utilisé le programme d'installation du logiciel AWS IoT Greengrass Core pour provisionner des ressources, la AWS IoT politique de votre appareil principal le permet`greengrass:*`, y compris cette autorisation. Pour de plus amples informations, veuillez consulter Authentification et autorisation de l'appareil pour AWS IoT Greengrass. Ajoute la variable de `iot:thingName` recette. Vous pouvez utiliser cette variable de recette pour obtenir le nom du périphérique AWS IoT principal dans une recette. Pour de plus amples informations, veuillez consulter Variables de recette. Corrections de bugs et améliorations Corrections et améliorations mineures supplémentaires. Pour plus d'informations, consultez les communiqués sur GitHub.
2.2.0	Nouvelles fonctionnalités Ajoute des opérations IPC pour la gestion locale des ombres. Corrections de bugs et améliorations Réduit la taille du fichier JAR. Réduit l'utilisation de la mémoire. Résout les problèmes où la configuration du journal n'était pas mise à jour dans certains cas. Corrections et améliorations mineures supplémentaires. Pour plus d'informations, consultez les communiqués sur GitHub.
2.1.0	Nouvelles fonctionnalités Supporte le téléchargement d'images Docker à partir de référentiels privés dans Amazon ECR. Ajoute les paramètres suivants pour personnaliser la configuration MQTT sur les appareils principaux : `maxInFlightPublishes`— Le nombre maximum de messages MQTT QoS 1 non reconnus qui peuvent être en vol en même temps. `maxPublishRetry`— Le nombre maximum de fois qu'il est possible de réessayer de publier un message qui n'a pas été publié. Ajoute le paramètre de `fleetstatusservice` configuration pour configurer l'intervalle auquel le périphérique principal publie l'état du périphérique au AWS Cloud. Corrections et améliorations mineures supplémentaires. Pour plus d'informations, consultez les communiqués sur GitHub. Corrections de bugs et améliorations Résout un problème qui provoquait la duplication des déploiements fictifs lors du redémarrage du noyau. Résout un problème qui provoquait le crash du noyau lorsqu'il rencontrait une exception de charge de service. Améliore la résolution des dépendances entre composants en cas d'échec d'un déploiement qui inclut une dépendance circulaire. Résout un problème qui empêchait le redéploiement d'un composant de plug-in s'il avait été précédemment supprimé du périphérique principal. Corrigez un problème qui entraînait la définition de la variable d'`HOME`environnement `/greengrass/v2/work` dans le répertoire des composants Lambda ou des composants exécutés en tant que root. La `HOME` variable est désormais correctement définie sur le répertoire personnel de l'utilisateur qui exécute le composant. Corrections et améliorations mineures supplémentaires. Pour plus d'informations, consultez les communiqués sur GitHub.
2.0.5	Corrections de bugs et améliorations Achemine correctement le trafic via un proxy réseau configuré lors du téléchargement des composants AWS fournis. Utilisez le point de terminaison du plan de données Greengrass approprié dans les régions AWS chinoises.
2.0.4	Nouvelles fonctionnalités Active le trafic HTTPS sur le port 443. Vous pouvez utiliser le nouveau paramètre de `greengrassDataPlanePort` configuration de la version 2.0.4 du composant nucleus pour configurer la communication HTTPS afin qu'elle passe par le port 443 au lieu du port par défaut 8443. Pour de plus amples informations, veuillez consulter Configuration du protocole HTTPS sur le port 443. Ajoute la variable de recette de chemin de travail. Vous pouvez utiliser cette variable de recette pour obtenir le chemin d'accès aux dossiers de travail des composants, que vous pouvez utiliser pour partager des fichiers entre les composants et leurs dépendances. Pour plus d'informations, consultez la variable de recette de chemin de travail. Corrections de bugs et améliorations Empêche la création de la politique de rôle d'échange de jetons Gestion des identités et des accès AWS (IAM) si une politique de rôle existe déjà. À la suite de cette modification, le programme d'installation nécessite désormais l'option `iam:GetPolicy` et `sts:GetCallerIdentity` lorsqu'il est exécuté avec`--provision true`. Pour de plus amples informations, veuillez consulter Politique IAM minimale permettant au programme d'installation de provisionner les ressources. Gère correctement l'annulation d'un déploiement qui n'a pas encore été enregistré avec succès. Met à jour la configuration pour supprimer les anciennes entrées avec des horodatages plus récents lors de l'annulation d'un déploiement. Corrections et améliorations mineures supplémentaires. Pour plus d'informations, consultez les communiqués sur GitHub.
2.0.3	Première version.

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

AWS-composants fournis

Greengrass Nucleus Lite