View a markdown version of this page

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

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 la CLI di Greengrass

È possibile installare l'interfaccia a riga di comando di Greengrass in uno dei seguenti modi:

  • Usa il --deploy-dev-tools argomento quando lo configuri per la prima volta AWS IoT Greengrass Software di base sul dispositivo. È inoltre necessario specificare --provision true per applicare questo argomento.

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

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

Prerequisiti

Per implementare 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 AWS IoT Greengrass V2.

  • Per usare il AWS CLI per implementare la CLI di Greengrass, è necessario aver installato e configurato 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 di Greengrass per interagire con AWS IoT Greengrass Software di base. Effettuate una delle seguenti operazioni per utilizzare la CLI di Greengrass:

    • Utilizzate l'utente del sistema che esegue AWS IoT Greengrass Software di base.

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

    • Usa un utente di sistema che si trova in un gruppo specificato nel AuthorizedPosixGroups o AuthorizedWindowsGroups parametri di configurazione quando si distribuisce il componente. Per ulteriori informazioni, vedere Configurazione dei componenti CLI Greengrass.

Implementa il componente CLI di Greengrass

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

  1. Accedere alla AWS IoT Greengrass console.

  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 una nuova distribuzione.

  6. Sul Specificare l'obiettivo pagina, sotto Obiettivi di distribuzione, nel Nome del bersaglio elenca, scegli il gruppo Greengrass in cui desideri eseguire la distribuzione e scegli Avanti.

  7. Sul Seleziona i componenti pagina, verifica che il aws.greengrass.Cli il componente è selezionato e scegli Avanti.

  8. Sul Configurare i componenti pagina, mantieni le impostazioni di configurazione predefinite e scegli Avanti.

  9. Sul Configurare le impostazioni avanzate pagina, mantieni le impostazioni di configurazione predefinite e scegli Avanti.

  10. Sul Recensione pagina, clicca Distribuisci

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

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

    • Nel aws.greengrass.Cli oggetto componente, specificare i valori come segue:

      version

      La versione del componente CLI Greengrass.

      configurationUpdate.AuthorizedPosixGroups

      (Facoltativo) Una stringa che contiene un elenco di gruppi di sistema separati da virgole. Autorizzate questi gruppi di sistema a utilizzare la CLI di Greengrass per interagire con AWS IoT Greengrass Software di base. È possibile specificare i nomi o gli ID dei gruppi. Ad esempio, group1,1002,group3 autorizza tre gruppi di sistema (group1, 1002, e group3) per utilizzare l'interfaccia a riga di comando di Greengrass.

      Se non specificate alcun gruppo da autorizzare, potete utilizzare la CLI di Greengrass come utente root (sudo) o come utente di sistema che esegue AWS IoT Greengrass Software principale.

      configurationUpdate.AuthorizedWindowsGroups

      (Facoltativo) Una stringa che contiene un elenco di gruppi di sistema separati da virgole. Autorizzate questi gruppi di sistema a utilizzare la CLI di Greengrass per interagire con AWS IoT Greengrass Software di base. È possibile specificare i nomi o gli ID dei gruppi. Ad esempio, group1,1002,group3 autorizza tre gruppi di sistema (group1, 1002, e group3) per utilizzare l'interfaccia a riga di comando di Greengrass.

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

  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 a greengrass-cli nel /greengrass/v2/bin cartella sul dispositivo ed esegui la CLI di Greengrass da questo percorso. Per eseguire la CLI di Greengrass senza il suo percorso assoluto, aggiungete il /greengrass/v2/bin cartella nella variabile PATH. Per verificare l'installazione della CLI di Greengrass, eseguite il comando seguente:

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 l'interfaccia a riga di comando di Greengrass. Per ulteriori informazioni, consulta Risoluzione dei problemi AWS IoT Greengrass V2.