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.
Le composant Greengrass CLI (aws.greengrass.Cli
) fournit une interface de ligne de commande locale que vous pouvez utiliser sur les appareils principaux pour développer et déboguer des composants localement. La CLI Greengrass vous permet de créer des déploiements locaux et de redémarrer des composants sur le périphérique principal, par exemple.
Vous pouvez installer ce composant lors de l'installation du logiciel AWS IoT Greengrass Core. Pour de plus amples informations, veuillez consulter Tutoriel : Débuter avec AWS IoT Greengrass V2.
Important
Nous vous recommandons d'utiliser ce composant uniquement dans les environnements de développement, et non dans les environnements de production. Ce composant permet d'accéder aux informations et aux opérations dont vous n'avez généralement pas besoin dans un environnement de production. Suivez le principe du moindre privilège en déployant ce composant uniquement sur les appareils principaux là où vous en avez besoin.
Après avoir installé ce composant, exécutez la commande suivante pour consulter sa documentation d'aide. Lorsque ce composant est installé, il ajoute un lien symbolique greengrass-cli
dans le
dossier. Vous pouvez exécuter la CLI Greengrass à partir de ce chemin ou l'ajouter à votre variable d'
/bin/greengrass/v2
PATH
environnement pour l'exécuter greengrass-cli
sans son chemin absolu.
/greengrass/v2
/bin/greengrass-cli help
La commande suivante redémarre un composant nommécom.example.HelloWorld
, par exemple.
sudo /greengrass/v2
/bin/greengrass-cli component restart --names "com.example.HelloWorld"
Pour de plus amples informations, veuillez consulter Interface de ligne de commande Greengrass.
Rubriques
Versions
Les versions de ce composant sont les suivantes :
-
2,14.x
-
2,13.x
-
2,12. x
-
2,11.x
-
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,1x
-
2,0.x
Type
Ce composant est un composant de plugin (aws.greengrass.plugin
). Le noyau Greengrass exécute ce composant dans la même machine virtuelle Java (JVM) que le noyau. Le noyau redémarre lorsque vous modifiez la version de ce composant sur le périphérique principal.
Ce composant utilise le même fichier journal que le noyau Greengrass. Pour de plus amples informations, veuillez consulter AWS IoT Greengrass Journaux de surveillance.
Pour de plus amples informations, veuillez consulter Types de composants.
Système d’exploitation
Ce composant peut être installé sur les appareils principaux qui exécutent les systèmes d'exploitation suivants :
Linux
Windows
Prérequis
Ce composant répond aux exigences suivantes :
-
Vous devez être autorisé à utiliser la CLI Greengrass pour interagir avec le logiciel AWS IoT Greengrass principal. Pour utiliser la CLI Greengrass, effectuez l'une des opérations suivantes :
-
Utilisez l'utilisateur du système qui exécute le logiciel AWS IoT Greengrass Core.
-
Utilisez un utilisateur doté d'autorisations root ou administratives. Sur les appareils principaux de Linux, vous pouvez l'utiliser
sudo
pour obtenir des autorisations root. -
Utilisez un utilisateur système appartenant à un groupe que vous spécifiez dans les paramètres de
AuthorizedWindowsGroups
configurationAuthorizedPosixGroups
ou lorsque vous déployez le composant. Pour plus d'informations, consultez la section Configuration des composants de la CLI Greengrass.
-
-
Le composant Greengrass CLI est compatible avec l'exécution dans un VPC.
Dépendances
Lorsque vous déployez un composant, il déploie AWS IoT Greengrass également des versions compatibles de ses dépendances. Cela signifie que vous devez satisfaire aux exigences relatives au composant et à toutes ses dépendances pour réussir le déploiement du composant. Cette section répertorie les dépendances des versions publiées de ce composant et les contraintes de version sémantiques qui définissent les versions des composants pour chaque dépendance. Vous pouvez également consulter les dépendances de chaque version du composant dans la AWS IoT Greengrass console
Le tableau suivant répertorie les dépendances pour les versions 2.14.0 et 2.14.1 de ce composant.
Dépendance | Versions compatibles | Type de dépendance |
---|---|---|
Noyau de Greengrass | >=2,12,0 <2,15,0 | Flexible |
Pour plus d'informations sur les dépendances des composants, consultez la référence de la recette des composants.
Configuration
Ce composant fournit les paramètres de configuration suivants que vous pouvez personnaliser lorsque vous déployez le composant.
-
(Facultatif) Chaîne contenant une liste de groupes de systèmes séparés par des virgules. Vous autorisez ces groupes de systèmes à utiliser la CLI Greengrass pour interagir avec le logiciel AWS IoT Greengrass principal. Vous pouvez spécifier des noms de groupes ou des groupes IDs. Par exemple,
group1,1002,group3
autorise trois groupes de systèmes (group1
1002
, etgroup3
) à utiliser la CLI Greengrass.Si vous ne spécifiez aucun groupe à autoriser, vous pouvez utiliser la CLI Greengrass en tant qu'utilisateur root (
sudo
) ou en tant qu'utilisateur système qui exécute le logiciel AWS IoT Greengrass Core. -
(Facultatif) Chaîne contenant une liste de groupes de systèmes séparés par des virgules. Vous autorisez ces groupes de systèmes à utiliser la CLI Greengrass pour interagir avec le logiciel AWS IoT Greengrass principal. Vous pouvez spécifier des noms de groupes ou des groupes IDs. Par exemple,
group1,1002,group3
autorise trois groupes de systèmes (group1
1002
, etgroup3
) à utiliser la CLI Greengrass.Si vous ne spécifiez aucun groupe à autoriser, vous pouvez utiliser la CLI Greengrass en tant qu'administrateur ou en tant qu'utilisateur du système qui exécute le logiciel AWS IoT Greengrass principal.
Exemple : mise à jour de la fusion de configurations
L'exemple de configuration suivant indique d'autoriser trois groupes de systèmes POSIX (group1
,1002
, etgroup3
) et deux groupes d'utilisateurs Windows (Device Operators
etQA Engineers
) à utiliser la CLI Greengrass.
{
"AuthorizedPosixGroups": "group1,1002,group3",
"AuthorizedWindowsGroups": "Device Operators,QA Engineers"
}
Fichier journal local
Ce composant utilise le même fichier journal que le composant Greengrass nucleus.
/logs/greengrass.log
/greengrass/v2
Pour consulter 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
ou/greengrass/v2
C:\greengrass\v2
par le chemin d'accès au dossier AWS IoT Greengrass racine.sudo tail -f
/logs/greengrass.log/greengrass/v2
Journal des modifications
Le tableau suivant décrit les modifications apportées à chaque version du composant.
Version |
Modifications |
---|---|
2.14.1 |
Version mise à jour pour la version 2.14.1 de Greengrass Nucleus. |
2.14.0 |
AvertissementCette version n'est plus disponible. Les améliorations apportées à cette version sont disponibles dans les versions ultérieures de ce composant.
|
2.13.0 |
Version mise à jour pour la version 2.13.0 de Greengrass Nucleus. |
2.12,6 |
Version mise à jour pour la version 2.12.6 de Greengrass Nucleus. |
2,1,5 |
Version mise à jour pour la version 2.12.5 de Greengrass Nucleus. |
2.12.4 |
Version mise à jour pour la version 2.12.4 de Greengrass Nucleus. |
2.12.3 |
AvertissementCette version n'est plus disponible. Les améliorations apportées à cette version sont disponibles dans les versions ultérieures de ce composant. Version mise à jour pour la version 2.12.3 de Greengrass Nucleus. |
2.12.2 |
Version mise à jour pour la version 2.12.2 de Greengrass Nucleus. |
2.12.1 |
Version mise à jour pour la version 2.12.1 de Greengrass Nucleus. |
2.12.0 |
Version mise à jour pour la version 2.12.0 de Greengrass Nucleus. |
2.11.3 |
Version mise à jour pour la version 2.11.3 de Greengrass Nucleus. |
2.11.2 |
Version mise à jour pour la version 2.11.2 de Greengrass Nucleus. |
2.11.1 |
Version mise à jour pour la version 2.11.1 de Greengrass Nucleus. |
2.11.0 |
|
2.10.3 |
Version mise à jour pour la version 2.10.3 de Greengrass Nucleus. |
2.10.2 |
Version mise à jour pour la version 2.10.2 de Greengrass Nucleus. |
2.10.1 |
Version mise à jour pour la version 2.10.1 de Greengrass Nucleus. |
2.10.0 |
Version mise à jour pour la version 2.10.0 de Greengrass Nucleus. |
2,9,6 |
Version mise à jour pour la version 2.9.6 de Greengrass Nucleus. |
2.9.5 |
Version mise à jour pour la version 2.9.5 de Greengrass Nucleus. |
2.9.4 |
Version mise à jour pour la version 2.9.4 de Greengrass Nucleus. |
2.9.3 |
Version mise à jour pour la version 2.9.3 de Greengrass Nucleus. |
2.9.2 |
Version mise à jour pour la version 2.9.2 de Greengrass Nucleus. |
2.9.1 |
Version mise à jour pour la version 2.9.1 de Greengrass Nucleus. |
2.9.0 |
Version mise à jour pour la version 2.9.0 de Greengrass Nucleus. |
2.8.1 |
Version mise à jour pour la version 2.8.1 de Greengrass Nucleus. |
2.8.0 |
Version mise à jour pour la version 2.8.0 de Greengrass Nucleus. |
2.7.0 |
Version mise à jour pour la version 2.7.0 de Greengrass Nucleus. |
2.6.0 |
|
2.5.6 |
Version mise à jour pour la version 2.5.6 de Greengrass Nucleus. |
2.5.5 |
Version mise à jour pour la version 2.5.5 de Greengrass Nucleus. |
2.5.4 |
Version mise à jour pour la version 2.5.4 de Greengrass Nucleus. |
2.5.3 |
Version mise à jour pour la version 2.5.3 de Greengrass Nucleus. |
2.5.2 |
Version mise à jour pour la version 2.5.2 de Greengrass Nucleus. |
2.5.1 |
Version mise à jour pour la version 2.5.1 de Greengrass Nucleus. |
2.5.0 |
|
2.4.0 |
|
2.3.0 |
Version mise à jour pour la version 2.3.0 de Greengrass Nucleus. |
2.2.0 |
Version mise à jour pour la version 2.2.0 de Greengrass Nucleus. |
2.1.0 |
Version mise à jour pour la version 2.1.0 de Greengrass Nucleus. |
2.0.5 |
Version mise à jour pour la version 2.0.5 de Greengrass Nucleus. |
2.0.4 |
Version mise à jour pour la version 2.0.4 de Greengrass Nucleus. |
2.0.3 |
Première version. |