Installez le Greengrass CLI - 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.

Installez le Greengrass CLI

Vous pouvez installer le Greengrass de CLI 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 CLI composant Greengrass (aws.greengrass.Cli) sur votre appareil.

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

Prérequis

Pour déployer le CLI composant Greengrass, 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 Didacticiel : Commencer avec AWS IoT Greengrass V2.

  • Pour utiliser le AWS CLI pour déployer le GreengrassCLI, 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 le Greengrass CLI pour interagir avec le logiciel AWS IoT Greengrass Core. Pour utiliser le 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 CLIcomposants Greengrass.

Déployer le composant Greengrass CLI

Procédez comme suit pour déployer le CLI composant Greengrass 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. Sur la page aws.greengrass.Cli, choisissez Deploy (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 le aws.greengrass.Clicomposant 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 GreengrassCLI. Ce fichier doit ressembler à ce qui suit :

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

    • Dans le target champ, remplacez targetArn par le nom de ressource Amazon (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 GreengrassCLI.

      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 le Greengrass CLI pour interagir avec le logiciel AWS IoT Greengrass Core. Vous pouvez spécifier des noms de groupes ou des groupesIDs. Par exemple, group1,1002,group3 autorise trois groupes de systèmes (group11002, etgroup3) à utiliser le GreengrassCLI.

      Si vous ne spécifiez aucun groupe à autoriser, vous pouvez utiliser Greengrass en CLI tant qu'utilisateur root (sudo) ou en tant qu'utilisateur du 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 le Greengrass CLI pour interagir avec le logiciel AWS IoT Greengrass Core. Vous pouvez spécifier des noms de groupes ou des groupesIDs. Par exemple, group1,1002,group3 autorise trois groupes de systèmes (group11002, etgroup3) à utiliser le GreengrassCLI.

      Si vous ne spécifiez aucun groupe à autoriser, vous pouvez utiliser le Greengrass en CLI tant qu'administrateur ou en tant qu'utilisateur du système qui exécute le logiciel AWS IoT Greengrass Core.

  2. Exécutez la commande suivante pour déployer le CLI composant Greengrass sur l'appareil :

    $ 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 lancez le Greengrass CLI à partir de ce chemin. Pour exécuter le Greengrass CLI sans son chemin absolu, ajoutez votre /greengrass/v2/bin dossier à votre PATH variable. Pour vérifier l'CLIinstallation de Greengrass, 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 le GreengrassCLI. Pour de plus amples informations, veuillez consulter Résolution des problèmes AWS IoT Greengrass V2.