Arguments d'installation - AWS IoT Greengrass

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.

Arguments d'installation

Le logiciel AWS IoT Greengrass principal inclut un programme d'installation qui configure le logiciel et fournit les AWS ressources nécessaires au fonctionnement du périphérique principal Greengrass. Le programme d'installation inclut les arguments suivants que vous pouvez spécifier pour configurer l'installation :

-h, --help

(Facultatif) Affichez les informations d'aide du programme d'installation.

--version

(Facultatif) Afficher la version du logiciel AWS IoT Greengrass principal.

-Droot

(Facultatif) Le chemin d'accès au dossier à utiliser comme racine pour le logiciel AWS IoT Greengrass Core.

Note

Cet argument définit une propriété JVM, vous devez donc la spécifier avant -jar d'exécuter le programme d'installation. Par exemple, spécifiez java -Droot="/greengrass/v2" -jar /path/to/Greengrass.jar.

Par défaut :

  • Linux : ~/.greengrass

  • Windows: %USERPROFILE%/.greengrass

-ar, --aws-region

Le Région AWS logiciel AWS IoT Greengrass Core utilise pour récupérer ou créer les AWS ressources requises.

-p, --provision

(Facultatif) Vous pouvez enregistrer cet appareil en tant qu'AWS IoTobjet et fournir les AWS ressources dont le périphérique principal a besoin. Si vous le spécifieztrue, le logiciel AWS IoT Greengrass Core fournit n'AWS IoTimporte quel objet, (facultatif) un AWS IoT groupe d'objets, un rôle IAM et un alias de AWS IoT rôle.

Par défaut : false

-tn, --thing-name

(Facultatif) Le nom de l'AWS IoTobjet que vous enregistrez en tant que périphérique principal. Si l'objet portant le nom n'existe pas dans le vôtreCompte AWS, c'est le logiciel AWS IoT Greengrass Core qui le crée.

Note

Le nom de l'objet ne peut pas contenir de caractères deux-points (:).

Vous devez spécifier --provision true pour appliquer cet argument.

Par défaut : GreengrassV2IotThing_ plus un UUID aléatoire.

-tgn, --thing-group-name

(Facultatif) Le nom du AWS IoT groupe d'objets dans lequel vous ajoutez l'AWS IoTobjet de cet appareil principal. Si un déploiement cible ce groupe d'objets, ce périphérique principal reçoit ce déploiement lorsqu'il se connecte àAWS IoT Greengrass. Si le groupe d'objets portant ce nom n'existe pas dans votre Compte AWS répertoire, le logiciel AWS IoT Greengrass Core le crée.

Note

Le nom du groupe d'objets ne peut pas contenir de deux-points (:).

Vous devez spécifier --provision true pour appliquer cet argument.

-tpn, --thing-policy-name

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

(Facultatif) Nom de la AWS IoT politique à associer au certificat d'AWS IoTobjet de ce périphérique principal. Si la AWS IoT politique portant ce nom n'existe pas dans votre répertoireCompte AWS, le logiciel AWS IoT Greengrass Core la crée.

Le logiciel AWS IoT Greengrass Core crée une AWS IoT politique permissive par défaut. Vous pouvez limiter cette politique ou créer une politique personnalisée dans laquelle vous limitez les autorisations pour votre cas d'utilisation. Pour plus d’informations, consultez AWS IoTPolitique minimale pour les appareils AWS IoT Greengrass V2 principaux.

Vous devez spécifier --provision true pour appliquer cet argument.

Par défaut : GreengrassV2IoTThingPolicy

-trn, --tes-role-name

(Facultatif) Nom du rôle IAM à utiliser pour acquérir des AWS informations d'identification permettant à l'appareil principal d'interagir avec les AWS services. Si le rôle portant ce nom n'existe pas dans votre répertoireCompte AWS, le logiciel AWS IoT Greengrass Core le crée avec la GreengrassV2TokenExchangeRoleAccess politique. Ce rôle n'a pas accès à vos compartiments S3 dans lesquels vous hébergez des artefacts de composants. Vous devez donc ajouter des autorisations aux compartiments et objets S3 de vos artefacts lorsque vous créez un composant. Pour plus d’informations, consultez Autoriser les appareils principaux à interagir avec les AWS services.

Vous devez spécifier --provision true pour appliquer cet argument.

Par défaut : GreengrassV2TokenExchangeRole

-tra, --tes-role-alias-name

(Facultatif) Le nom de l'alias de AWS IoT rôle qui pointe vers le rôle IAM qui fournit les AWS informations d'identification pour ce périphérique principal. Si l'alias de rôle portant ce nom n'existe pas dans votre répertoireCompte AWS, le logiciel AWS IoT Greengrass Core le crée et le pointe vers le rôle IAM que vous spécifiez.

Vous devez spécifier --provision true pour appliquer cet argument.

Par défaut : GreengrassV2TokenExchangeRoleAlias

-ss, --setup-system-service

(Facultatif) Vous pouvez configurer le logiciel AWS IoT Greengrass Core en tant que service système qui s'exécute au démarrage de cet appareil. Le nom du service système estgreengrass. Pour plus d’informations, consultez Configurer le noyau Greengrass en tant que service système.

Sur les systèmes d'exploitation Linux, cet argument nécessite que le système d'initialisation systemd soit disponible sur le périphérique.

Important

Sur les appareils Windows Core, vous devez configurer le logiciel AWS IoT Greengrass Core en tant que service système.

Par défaut : false

-u, --component-default-user

Le nom ou l'ID de l'utilisateur utilisé par le logiciel AWS IoT Greengrass Core pour exécuter les composants. Par exemple, vous pouvez définir ggc_user. Cette valeur est obligatoire lorsque vous exécutez le programme d'installation sur les systèmes d'exploitation Windows.

Sur les systèmes d'exploitation Linux, vous pouvez également éventuellement spécifier le groupe. Spécifiez l'utilisateur et le groupe séparés par deux points. Par exemple, ggc_user:ggc_group.

Les considérations supplémentaires suivantes s'appliquent aux systèmes d'exploitation Linux :

  • Si vous exécutez le composant en tant que root, l'utilisateur du composant par défaut est celui défini dans le fichier de configuration. Si le fichier de configuration ne définit aucun utilisateur, la valeur par défaut est. ggc_user:ggc_group S'ils ggc_group existent ggc_user ou non, le logiciel les crée.

  • Si vous l'exécutez en tant qu'utilisateur non root, le logiciel AWS IoT Greengrass Core utilise cet utilisateur pour exécuter les composants.

  • Si vous ne spécifiez aucun groupe, le logiciel AWS IoT Greengrass Core utilise le groupe principal de l'utilisateur du système.

Pour plus d’informations, consultez Configurer l'utilisateur qui exécute les composants.

-d, --deploy-dev-tools

(Facultatif) Vous pouvez télécharger et déployer le composant Greengrass CLI sur ce périphérique principal. Vous pouvez utiliser cet outil pour développer et déboguer des composants sur ce périphérique principal.

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 à des informations et à des opérations dont vous n'avez généralement pas besoin dans un environnement de production. Respectez le principe du moindre privilège en déployant ce composant uniquement sur les appareils principaux là où vous en avez besoin.

Vous devez spécifier --provision true pour appliquer cet argument.

Par défaut : false

-init, --init-config

(Facultatif) Le chemin d'accès au fichier de configuration à utiliser pour installer le logiciel AWS IoT Greengrass Core. Vous pouvez utiliser cette option pour configurer de nouveaux périphériques principaux avec une configuration de noyau spécifique, par exemple.

Important

Le fichier de configuration que vous spécifiez fusionne avec le fichier de configuration existant sur le périphérique principal. Cela inclut les composants et les configurations des composants du périphérique principal. Nous recommandons que le fichier de configuration répertorie uniquement les configurations que vous essayez de modifier.

-tp, --trusted-plugin

(Facultatif) Le chemin d'accès à un fichier JAR à charger en tant que plugin sécurisé. Utilisez cette option pour fournir des fichiers JAR du plug-in de provisionnement, par exemple pour l'installation avec le provisionnement du parc ou le provisionnement personnalisé, ou pour l'installation avec la clé privée et le certificat dans un module de sécurité matériel.

-s, --start

(Facultatif) Vous pouvez démarrer le logiciel AWS IoT Greengrass Core après son installation et, éventuellement, provisionner les ressources.

Par défaut : true