Installation de la CLI Greengrass - AWS IoT Greengrass
PrérequisDéployer le composant Greengrass CLI

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.

Installation de la CLI Greengrass

Vous pouvez installer la CLI Greengrass de l'une des manières suivantes :

  • Utilisez --deploy-dev-tools cet argument lorsque vous configurez le logiciel AWS IoT Greengrass Core pour la première fois sur votre appareil. Vous devez également spécifier --provision true d'appliquer cet argument.

  • Déployez le composant Greengrass CLI (aws.greengrass.Cli) sur votre appareil.

Cette section décrit les étapes de déploiement du composant Greengrass CLI. Pour plus d'informations sur l'installation de la CLI Greengrass lors de la configuration initiale, consultez. Tutoriel : Débuter avec AWS IoT Greengrass V2

Prérequis

Pour déployer le composant Greengrass CLI, vous devez répondre aux exigences suivantes :

  • AWS IoT Greengrass Logiciel de base installé et configuré sur votre appareil principal. Pour de plus amples informations, veuillez consulter Tutoriel : Débuter avec AWS IoT Greengrass V2.

  • Pour utiliser le AWS CLI pour déployer la Greengrass CLI, vous devez avoir installé et configuré le. AWS CLI Pour plus d'informations, veuillez consulter configuration de l'outil AWS CLI dans le guide de l'utilisateur de l'outil AWS Command Line Interface .

  • 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 configuration AuthorizedPosixGroups ou lorsque vous déployez le composant. Pour plus d'informations, consultez la section Configuration des composants de la CLI Greengrass.

Déployer le composant Greengrass CLI

Procédez comme suit pour déployer le composant Greengrass CLI sur votre appareil principal :

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

  2. Dans le menu de navigation, sélectionnez Composants.

  3. Sur la page Components (Composants), sous l'onglet Public components (Composants publics), choisissez aws.greengrass.Cli.

  4. Dans la page aws.greengrass.Clipage, choisissez Déployer.

  5. Dans Ajouter au déploiement, choisissez Créer un nouveau déploiement.

  6. Sur la page Spécifier la cible, sous Cibles de déploiement, dans la liste Nom de la cible, choisissez le groupe Greengrass vers lequel vous souhaitez effectuer le déploiement, puis cliquez sur Next.

  7. Sur la page Sélectionner les composants, vérifiez que aws.greengrass.Clile composant est sélectionné, puis choisissez Next.

  8. Sur la page Configurer les composants, conservez les paramètres de configuration par défaut et choisissez Next.

  9. Sur la page Configurer les paramètres avancés, conservez les paramètres de configuration par défaut et choisissez Next.

  10. Sur la page de révision, cliquez sur Déployer

  1. Sur votre appareil, créez un deployment.json fichier pour définir la configuration de déploiement du composant Greengrass CLI. Ce fichier doit ressembler à ce qui suit :

    {
  "targetArn":"targetArn",
  "components": {
    "aws.greengrass.Cli": {
      "componentVersion": "2.14.0",
      "configurationUpdate": {
        "merge": "{\"AuthorizedPosixGroups\":\"<group1>,<group2>,...,<groupN>\",\"AuthorizedWindowsGroups\":\"<group1>,<group2>,...,<groupN>\"}"
      }
    }
  }
}

    • Dans le champ target, remplacez targetArn par l'Amazon Resource Name (ARN) de l'objet ou du groupe d'objets à cibler pour le déploiement, au format suivant :

      • Objet : arn:aws:iot:region:account-id:thing/thingName

      • Groupe d'objets : arn:aws:iot:region:account-id:thinggroup/thingGroupName

    • Dans l'objet aws.greengrass.Cli composant, spécifiez les valeurs comme suit :

      version

      Version du composant Greengrass CLI.

      configurationUpdate.AuthorizedPosixGroups

      (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 (group11002, 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.

      configurationUpdate.AuthorizedWindowsGroups

      (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 (group11002, 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.

  2. Exécutez la commande suivante pour déployer le composant Greengrass CLI sur le périphérique :

    $ aws greengrassv2 create-deployment --cli-input-json file://path/to/deployment.json

Pendant l'installation, le composant ajoute un lien symbolique greengrass-cli dans le /greengrass/v2/bin dossier de votre appareil, et vous exécutez la CLI Greengrass à partir de ce chemin. Pour exécuter la CLI Greengrass sans son chemin absolu, ajoutez votre /greengrass/v2/bin dossier à votre variable PATH. Pour vérifier l'installation de Greengrass CLI, exécutez la commande suivante :

Linux or Unix
/greengrass/v2/bin/greengrass-cli help
Windows
C:\greengrass\v2\bin\greengrass-cli help

Vous devriez voir la sortie suivante :

Usage: greengrass-cli [-hV] [--ggcRootPath=<ggcRootPath>] [COMMAND]
Greengrass command line interface

      --ggcRootPath=<ggcRootPath>
                  The AWS IoT Greengrass V2 root directory.
  -h, --help      Show this help message and exit.
  -V, --version   Print version information and exit.
Commands:
  help                Show help information for a command.
  component           Retrieve component information and stop or restart
                        components.
  deployment          Create local deployments and retrieve deployment status.
  logs                Analyze Greengrass logs.
  get-debug-password  Generate a password for use with the HTTP debug view
                        component.

S'il greengrass-cli n'est pas trouvé, le déploiement n'a peut-être pas réussi à installer la CLI Greengrass. Pour de plus amples informations, veuillez consulter Résolution des problèmes AWS IoT Greengrass V2.