Installa Greengrass CLI - AWS IoT Greengrass
PrerequisitiImplementa il componente Greengrass CLI

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Installa Greengrass CLI

È possibile installare Greengrass CLI in uno dei seguenti modi:

  • Usa l'--deploy-dev-toolsargomento quando configuri per la prima volta il software AWS IoT Greengrass Core sul tuo dispositivo. È inoltre necessario specificare --provision true di applicare questo argomento.

  • Distribuisci il componente CLI Greengrass aws.greengrass.Cli () sul tuo dispositivo.

Questa sezione descrive i passaggi per distribuire il componente CLI Greengrass. Per informazioni sull'installazione di Greengrass CLI durante la configurazione iniziale, vedere. Tutorial: Nozioni di base su AWS IoT Greengrass V2

Prerequisiti

Per distribuire il componente CLI Greengrass, è necessario soddisfare i seguenti requisiti:

  • AWS IoT Greengrass Software di base installato e configurato sul dispositivo principale. Per ulteriori informazioni, consulta Tutorial: Nozioni di base su AWS IoT Greengrass V2.

  • Per utilizzare AWS CLI per distribuire CLI Greengrass, è necessario aver installato e configurato il. AWS CLI Per ulteriori informazioni, consulta Configurazione della AWS CLI nella Guida per l'utente di AWS Command Line Interface .

  • È necessario essere autorizzati a utilizzare Greengrass CLI per interagire con il software AWS IoT Greengrass Core. Effettua una delle seguenti operazioni per utilizzare GreengrassCLI:

    • Utilizzate l'utente di sistema che esegue il software AWS IoT Greengrass Core.

    • Usa un utente con autorizzazioni root o amministrative. Sui dispositivi principali di Linux, puoi utilizzarlo per ottenere i permessi sudo di root.

    • Usa un utente di sistema che fa parte di un gruppo specificato nei parametri di AuthorizedWindowsGroups configurazione AuthorizedPosixGroups o quando distribuisci il componente. Per ulteriori informazioni, vedere Configurazione dei CLIcomponenti Greengrass.

Implementa il componente Greengrass CLI

Completa i seguenti passaggi per distribuire il componente CLI Greengrass sul tuo dispositivo principale:

  1. Accedere alla console AWS IoT Greengrass.

  2. Nel menu di navigazione, scegli Componenti.

  3. Nella pagina Componenti, nella scheda Componenti pubblici, scegli aws.greengrass.Cli.

  4. Nella pagina aws.greengrass.Cli, scegli (Distribuisci).

  5. Da Aggiungi alla distribuzione, scegli Crea nuova distribuzione.

  6. Nella pagina Specificare la destinazione, in Destinazioni di distribuzione, nell'elenco Nome destinazione, scegli il gruppo Greengrass in cui desideri eseguire la distribuzione e scegli Avanti.

  7. Nella pagina Seleziona componenti, verifica che il aws.greengrass.Clicomponente sia selezionato e scegli Avanti.

  8. Nella pagina Configura componenti, mantieni le impostazioni di configurazione predefinite e scegli Avanti.

  9. Nella pagina Configura impostazioni avanzate, mantieni le impostazioni di configurazione predefinite e scegli Avanti.

  10. Nella pagina di revisione, fai clic su Distribuisci

  1. Sul tuo dispositivo, crea un deployment.json file per definire la configurazione di distribuzione per il componente GreengrassCLI. Questo file dovrebbe avere il seguente aspetto:

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

    • Nel target campo, sostituisci targetArn con Amazon Resource Name (ARN) dell'oggetto o del gruppo di oggetti a cui destinare la distribuzione, nel seguente formato:

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

      • Gruppo di oggetti: arn:aws:iot:region:account-id:thinggroup/thingGroupName

    • Nell'oggetto aws.greengrass.Cli componente, specifica i valori come segue:

      version

      La versione del componente GreengrassCLI.

      configurationUpdate.AuthorizedPosixGroups

      (Facoltativo) Una stringa che contiene un elenco di gruppi di sistema separati da virgole. L'utente autorizza questi gruppi di sistemi a utilizzare CLI Greengrass per interagire con AWS IoT Greengrass il software Core. È possibile specificare nomi o gruppi di gruppi. IDs Ad esempio, group1,1002,group3 autorizza tre gruppi di sistema (group11002, egroup3) a utilizzare GreengrassCLI.

      Se non specificate alcun gruppo da autorizzare, potete usare CLI Greengrass come utente root sudo () o come utente di sistema che esegue AWS IoT Greengrass il software Core.

      configurationUpdate.AuthorizedWindowsGroups

      (Facoltativo) Una stringa che contiene un elenco separato da virgole di gruppi di sistema. L'utente autorizza questi gruppi di sistemi a utilizzare CLI Greengrass per interagire con AWS IoT Greengrass il software Core. È possibile specificare nomi o gruppi di gruppi. IDs Ad esempio, group1,1002,group3 autorizza tre gruppi di sistema (group11002, egroup3) a utilizzare GreengrassCLI.

      Se non specifichi alcun gruppo da autorizzare, puoi utilizzare CLI Greengrass come amministratore o come utente di sistema che esegue AWS IoT Greengrass il software Core.

  2. Esegui il comando seguente per distribuire il componente CLI Greengrass sul dispositivo:

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

Durante l'installazione, il componente aggiunge un collegamento simbolico /greengrass/v2/bin nella cartella del dispositivo e tu esegui CLI Greengrass da questo percorso. greengrass-cli Per eseguire Greengrass CLI senza il percorso assoluto, aggiungi la /greengrass/v2/bin cartella PATH alla variabile. Per verificare l'CLIinstallazione di Greengrass, esegui il seguente comando:

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

Verrà visualizzato l'output seguente:

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.

Se greengrass-cli non viene trovato, la distribuzione potrebbe non essere riuscita a installare GreengrassCLI. Per ulteriori informazioni, consulta Risoluzione dei problemi AWS IoT Greengrass V2.