View a markdown version of this page

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 bei der ersten Einrichtung AWS IoT Greengrass Kernsoftware auf Ihrem Gerät. Sie müssen auch angeben --provision true um dieses Argument anzuwenden.

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

In diesem Abschnitt werden die Schritte zur Bereitstellung der Greengrass-CLI-Komponente beschrieben. Informationen zur Installation der Greengrass CLI bei der Ersteinrichtung finden Sie unter Tutorial: 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 Hauptgerät installiert und konfiguriert ist. Weitere Informationen finden Sie unter Tutorial: Erste Schritte mit AWS IoT Greengrass V2.

  • Um das zu verwenden AWS CLI Um die Greengrass CLI bereitzustellen, müssen Sie die installiert und konfiguriert haben AWS CLI. 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 dem zu interagieren AWS IoT Greengrass Kernsoftware. Gehen Sie wie folgt vor, um die Greengrass-CLI zu verwenden:

    • Verwenden Sie den Systembenutzer, der das ausführt AWS IoT Greengrass Kernsoftware.

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

    • Verwenden Sie einen Systembenutzer, der zu einer Gruppe gehört, die Sie in der AuthorizedPosixGroups oder AuthorizedWindowsGroups Konfigurationsparameter, wenn Sie die Komponente bereitstellen. Weitere Informationen finden Sie unter Konfiguration der Greengrass-CLI-Komponente.

Stellen Sie die Greengrass CLI-Komponente bereit

Führen Sie die folgenden Schritte aus, um die Greengrass-CLI-Komponente auf Ihrem Kerngerät bereitzustellen:

  1. Melden Sie sich bei 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. Wählen Sie auf der aws.greengrass.Cli Seite Bereitstellen aus.

  5. Von Zur Bereitstellung hinzufügen, wählen Neues Deployment erstellen.

  6. Auf der Ziel angeben Seite, unter Ziele für den Einsatz, in der Name des Ziels Liste, wählen Sie die Greengrass-Gruppe aus, für die Sie die Bereitstellung vornehmen möchten, und wählen Sie Weiter.

  7. Auf der Wählen Sie Komponenten aus Seite, überprüfen Sie, ob aws.greengrass.Cli Komponente ist ausgewählt, und wählen Sie Weiter.

  8. Auf der Komponenten konfigurieren Seite, behalten Sie die Standardkonfigurationseinstellungen bei und wählen Sie Weiter.

  9. Auf der Konfigurieren Sie die erweiterte Einstellung Seite, behalten Sie die Standardkonfigurationseinstellungen bei und wählen Sie Weiter.

  10. Auf der Rezension Seite, klicken Sie Bereitstellen

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

    {
  "targetArn":"targetArn",
  "components": {
    "aws.greengrass.Cli": {
      "componentVersion": "2.18.4",
      "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

    • In der aws.greengrass.Cli Geben Sie die Werte für das Komponentenobjekt 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 zu verwenden, um mit dem zu interagieren AWS IoT Greengrass Kernsoftware. Sie können Gruppennamen oder Gruppen-IDs angeben. Zum Beispiel group1,1002,group3 autorisiert drei Systemgruppen (group1, 1002, und group3), um die Greengrass CLI zu verwenden.

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

      configurationUpdate.AuthorizedWindowsGroups

      (Optional) Eine Zeichenfolge, die eine durch Kommas getrennte Liste von Systemgruppen enthält. Sie autorisieren diese Systemgruppen, die Greengrass CLI zu verwenden, um mit dem zu interagieren AWS IoT Greengrass Kernsoftware. Sie können Gruppennamen oder Gruppen-IDs angeben. Zum Beispiel group1,1002,group3 autorisiert drei Systemgruppen (group1, 1002, und group3), um 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 Kernsoftware.

  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 in der /greengrass/v2/bin Ordner auf Ihrem Gerät, und Sie führen die Greengrass-CLI von diesem Pfad aus. Um die Greengrass-CLI ohne ihren absoluten Pfad auszuführen, fügen Sie Ihren /greengrass/v2/bin Ordner zu Ihrer PATH-Variablen. 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 der greengrass-cli nicht gefunden wird, konnte das Deployment möglicherweise die Greengrass-CLI nicht installieren. Weitere Informationen finden Sie unter Fehlerbehebung AWS IoT Greengrass V2.