Installieren Sie das Greengrass CLI - AWS IoT Greengrass
VoraussetzungenStellen Sie die CLI Greengrass-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 das Greengrass CLI

Sie können Greengrass auf eine CLI 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 CLI Greengrass-Komponente (aws.greengrass.Cli) auf Ihrem Gerät bereit.

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

Voraussetzungen

Um die CLI Greengrass-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.

  • Um den AWS CLI zur Bereitstellung von Greengrass verwenden zu könnenCLI, müssen Sie den 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, Greengrass zu verwendenCLI, um mit der AWS IoT Greengrass Core-Software zu interagieren. Gehen Sie wie folgt vor, um das 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 CLI Greengrass-Komponenten.

Stellen Sie die CLI Greengrass-Komponente bereit

Gehen Sie wie folgt vor, um die CLI Greengrass-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. Wählen Sie auf der aws.greengrass.Cli Seite Bereitstellen 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 die aws.greengrass.CliKomponente ausgewählt ist, und klicken Sie auf Weiter.

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

  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 CLI Greengrass-Komponente zu definieren. Diese Datei sollte wie folgt aussehen:

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

    • targetArnErsetzen Sie das target Feld durch den Amazon-Ressourcennamen (ARN) der Sache oder der Dinggruppe, 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 CLI Greengrass-Komponente.

      configurationUpdate.AuthorizedPosixGroups

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

      Wenn Sie keine zu autorisierenden Gruppen angeben, können Sie 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, Greengrass für die Interaktion mit der AWS IoT Greengrass Core-Software CLI zu verwenden. Sie können Gruppennamen oder Gruppen angeben. IDs group1,1002,group3Autorisiert beispielsweise drei Systemgruppen (group1, undgroup3)1002, CLI Greengrass zu verwenden.

      Wenn Sie keine zu autorisierenden Gruppen angeben, können Sie 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 CLI Greengrass-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 starten Greengrass CLI von diesem Pfad aus. Um Greengrass CLI ohne seinen 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 CLI Greengrass-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 Greengrass CLI bei der Bereitstellung möglicherweise nicht installiert werden. Weitere Informationen finden Sie unter Problembehebung AWS IoT Greengrass V2.