Installieren Sie die Greengrass-CLI - AWS IoT Greengrass
VoraussetzungenStellen Sie die Greengrass-CLI-Komponente bereit

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Installieren Sie die Greengrass-CLI

Sie können die Greengrass-CLI auf eine der folgenden Arten installieren:

  • Verwenden Sie das --deploy-dev-tools Argument, wenn Sie die AWS IoT Greengrass Core-Software zum ersten Mal auf Ihrem Gerät einrichten. Sie müssen auch angeben--provision true, ob dieses Argument angewendet werden soll.

  • Stellen Sie die Greengrass CLI-Komponente (aws.greengrass.Cli) auf Ihrem Gerät bereit.

In diesem Abschnitt werden die Schritte zur Bereitstellung der Greengrass-CLI-Komponente beschrieben. Hinweise zur Installation der Greengrass-CLI bei der Ersteinrichtung finden Sie unterTutorial: Erste Schritte mit AWS IoT Greengrass V2.

Voraussetzungen

Um die Greengrass CLI-Komponente bereitzustellen, müssen Sie die folgenden Anforderungen erfüllen:

  • AWS IoT Greengrass Kernsoftware, die auf Ihrem Kerngerät installiert und konfiguriert ist. Weitere Informationen finden Sie unter Tutorial: Erste Schritte mit AWS IoT Greengrass V2.

  • AWS CLI Um die Greengrass-CLI bereitzustellen, müssen Sie die AWS CLI installiert und konfiguriert haben. Weitere Informationen finden Sie unter Konfigurieren der AWS CLI im AWS Command Line Interface -Leitfaden.

  • Sie müssen autorisiert sein, die Greengrass-CLI zu verwenden, um mit der AWS IoT Greengrass Core-Software zu interagieren. Führen Sie einen der folgenden Schritte aus, um die Greengrass-CLI zu verwenden:

    • Verwenden Sie den Systembenutzer, der die AWS IoT Greengrass Core-Software ausführt.

    • Verwenden Sie einen Benutzer mit Root- oder Administratorrechten. Auf Linux-Core-Geräten können Sie diese Option verwenden, um sudo Root-Rechte zu erhalten.

    • Verwenden Sie einen Systembenutzer, der zu einer Gruppe gehört, die Sie bei der Bereitstellung der Komponente in den AuthorizedWindowsGroups Konfigurationsparametern AuthorizedPosixGroups oder angeben. Weitere Informationen finden Sie unter Konfiguration der Greengrass-CLI-Komponente.

Stellen Sie die Greengrass-CLI-Komponente bereit

Gehen Sie wie folgt vor, um die Greengrass CLI-Komponente auf Ihrem Kerngerät bereitzustellen:

  1. Melden Sie sich an der AWS IoT Greengrass -Konsole an.

  2. Wählen Sie im Navigationsmenü Komponenten.

  3. Wählen Sie auf der Seite Komponenten auf der Registerkarte Öffentliche Komponenten die Option aws.greengrass.Cli aus.

  4. Auf dem aws.greengrass.CliWählen Sie auf der Seite Deploy aus.

  5. Wählen Sie unter Zur Bereitstellung hinzufügen die Option Neue Bereitstellung erstellen aus.

  6. Wählen Sie auf der Seite Ziel angeben unter Bereitstellungsziele in der Liste Zielname die Greengrass-Gruppe aus, für die Sie die Bereitstellung durchführen möchten, und klicken Sie auf Weiter.

  7. Vergewissern Sie sich auf der Seite „Komponenten auswählen“, dass aws.greengrass.CliDie Komponente ist ausgewählt, und wählen Sie Weiter.

  8. Behalten Sie auf der Seite Komponenten konfigurieren die Standardkonfigurationseinstellungen bei und wählen Sie Weiter.

  9. Behalten Sie auf der Seite Erweiterte Einstellungen konfigurieren die Standardkonfigurationseinstellungen bei und wählen Sie Weiter.

  10. Klicken Sie auf der Seite „Überprüfen“ auf Bereitstellen

  1. Erstellen Sie auf Ihrem Gerät eine deployment.json Datei, um die Bereitstellungskonfiguration für die Greengrass CLI-Komponente zu definieren. Diese Datei sollte wie folgt aussehen:

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

    • Ersetzen Sie im target Feld targetArn durch den Amazon-Ressourcennamen (ARN) des Objekts oder der Objektgruppe, auf die die Bereitstellung ausgerichtet werden soll, und zwar im folgenden Format:

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

      • Objektgruppe: arn:aws:iot:region:account-id:thinggroup/thingGroupName

    • Geben Sie im aws.greengrass.Cli Komponentenobjekt die Werte wie folgt an:

      version

      Die Version der Greengrass-CLI-Komponente.

      configurationUpdate.AuthorizedPosixGroups

      (Optional) Eine Zeichenfolge, die eine durch Kommas getrennte Liste von Systemgruppen enthält. Sie autorisieren diese Systemgruppen, die Greengrass-CLI für die Interaktion mit der AWS IoT Greengrass Core-Software zu verwenden. Sie können Gruppennamen oder Gruppen angeben. IDs group1,1002,group3Autorisiert beispielsweise drei Systemgruppen (group1, undgroup3)1002, die Greengrass-CLI zu verwenden.

      Wenn Sie keine zu autorisierenden Gruppen angeben, können Sie die Greengrass-CLI als Root-Benutzer (sudo) oder als Systembenutzer verwenden, der die AWS IoT Greengrass Core-Software ausführt.

      configurationUpdate.AuthorizedWindowsGroups

      (Optional) Eine Zeichenfolge, die eine durch Kommas getrennte Liste von Systemgruppen enthält. Sie autorisieren diese Systemgruppen, die Greengrass-CLI für die Interaktion mit der AWS IoT Greengrass Core-Software zu verwenden. Sie können Gruppennamen oder Gruppen angeben. IDs group1,1002,group3Autorisiert beispielsweise drei Systemgruppen (group1, undgroup3)1002, die Greengrass-CLI zu verwenden.

      Wenn Sie keine zu autorisierenden Gruppen angeben, können Sie die Greengrass-CLI als Administrator oder als Systembenutzer verwenden, der die AWS IoT Greengrass Core-Software ausführt.

  2. Führen Sie den folgenden Befehl aus, um die Greengrass-CLI-Komponente auf dem Gerät bereitzustellen:

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

Während der Installation fügt die Komponente einen symbolischen Link zu greengrass-cli dem /greengrass/v2/bin Ordner auf Ihrem Gerät hinzu, und Sie führen die Greengrass-CLI von diesem Pfad aus aus. Um die Greengrass-CLI ohne ihren absoluten Pfad auszuführen, fügen Sie Ihren /greengrass/v2/bin Ordner zu Ihrer PATH-Variablen hinzu. Führen Sie den folgenden Befehl aus, um die Greengrass CLI-Installation zu überprüfen:

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

Die Ausgabe sollte folgendermaßen aussehen:

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.

Wenn das greengrass-cli nicht gefunden wird, konnte die Greengrass-CLI bei der Bereitstellung möglicherweise nicht installiert werden. Weitere Informationen finden Sie unter Problembehebung AWS IoT Greengrass V2.