Installazione della CLI di Greengrass - 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à.

Installazione della CLI di Greengrass

È possibile installare la 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.

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

Questa sezione descrive i passaggi per distribuire il componente Greengrass CLI. Per informazioni sull'installazione della Greengrass CLI durante la configurazione iniziale, vedere. Tutorial: Guida introduttiva a AWS IoT Greengrass V2

Prerequisiti

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

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

  • Per utilizzare AWS CLI per distribuire la 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 la CLI Greengrass per interagire con il software Core. AWS IoT Greengrass Effettuate una delle seguenti operazioni per utilizzare la Greengrass CLI:

    • 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, consulta Configurazione dei componenti della CLI di Greengrass.

Implementa il componente Greengrass CLI

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

  1. Accedi 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 Greengrass CLI. Questo file dovrebbe avere il seguente aspetto:

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

    • Nel campo target, sostituisci targetArn con il nome della risorsa Amazon (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, specificate i valori come segue:

      version

      La versione del componente Greengrass CLI.

      configurationUpdate.AuthorizedPosixGroups

      (Facoltativo) Una stringa che contiene un elenco di gruppi di sistema separati da virgole. Autorizzi questi gruppi di sistema a utilizzare la 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 la CLI Greengrass.

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

      configurationUpdate.AuthorizedWindowsGroups

      (Facoltativo) Una stringa che contiene un elenco separato da virgole di gruppi di sistema. Autorizzi questi gruppi di sistema a utilizzare la 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 la CLI Greengrass.

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

  2. Esegui il comando seguente per distribuire il componente Greengrass CLI 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 da questo percorso si esegue la Greengrass CLI. greengrass-cli Per eseguire la CLI di Greengrass senza il percorso assoluto, aggiungi la /greengrass/v2/bin cartella alla variabile PATH. Per verificare l'installazione della CLI 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 la CLI di Greengrass. Per ulteriori informazioni, consulta Risoluzione dei problemi AWS IoT Greengrass V2.