View a markdown version of this page

Interfaccia a riga di comando di Greengrass - AWS IoT Greengrass
VersioniTipoSistema operativoRequisitiDipendenzeConfigurazioneFile di registro localeChangelog

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à.

Interfaccia a riga di comando di Greengrass

Il componente Greengrass CLI (aws.greengrass.Cli) fornisce un'interfaccia a riga di comando locale che è possibile utilizzare sui dispositivi principali per sviluppare ed eseguire il debug dei componenti localmente. L'interfaccia a riga di comando di Greengrass consente, ad esempio, di creare implementazioni locali e riavviare i componenti sul dispositivo principale.

È possibile installare questo componente quando si installa il AWS IoT Greengrass software Core. Per ulteriori informazioni, consulta Tutorial: Guida introduttiva a AWS IoT Greengrass V2.

Importante

Si consiglia di utilizzare questo componente solo in ambienti di sviluppo, non in ambienti di produzione. Questo componente fornisce l'accesso a informazioni e operazioni che in genere non sono necessarie in un ambiente di produzione. Segui il principio del privilegio minimo implementando questo componente solo nei dispositivi principali in cui ne hai bisogno.

Dopo aver installato questo componente, esegui il comando seguente per visualizzare la relativa documentazione di aiuto. Quando questo componente viene installato, aggiunge un collegamento simbolico alla greengrass-cli /greengrass/v2/bin cartella. È possibile eseguire la CLI di Greengrass da questo percorso o aggiungerla alla variabile di PATH ambiente per eseguirla greengrass-cli senza il percorso assoluto.

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

Il comando seguente riavvia un componente denominatocom.example.HelloWorld, ad esempio.

Linux or Unix
sudo /greengrass/v2/bin/greengrass-cli component restart --names "com.example.HelloWorld"
Windows
C:\greengrass\v2\bin\greengrass-cli component restart --names "com.example.HelloWorld"

Per ulteriori informazioni, consulta Interfaccia a riga di comando Greengrass.

Versioni

Questo componente ha le seguenti versioni:

  • 2.18.x

  • 2.17.x

  • 2.16.x

  • 2.15.x

  • 2.14.x

  • 2.13.x

  • 2.12.x

  • 2.11.x

  • 2.10.x

  • 2.9.x

  • 2.8.x

  • 2.7.x

  • 2.6.x

  • 2.5.x

  • 2.4.x

  • 2.3.x

  • 2.2.x

  • 2.1.x

  • 2.0.x

Tipo

Questo componente è un componente plug-in ()aws.greengrass.plugin. Il nucleo di Greengrass esegue questo componente nella stessa Java Virtual Machine (JVM) del nucleo. Il nucleo si riavvia quando si modifica la versione di questo componente sul dispositivo principale.

Questo componente utilizza lo stesso file di registro del nucleo di Greengrass. Per ulteriori informazioni, consulta Monitora AWS IoT Greengrass i registri.

Per ulteriori informazioni, consulta Tipi di componenti.

Sistema operativo

Questo componente può essere installato sui dispositivi principali che eseguono i seguenti sistemi operativi:

  • Linux

  • Windows

Requisiti

Questo componente ha i seguenti requisiti:

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

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

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

    • Usa un utente di sistema che si trova in un gruppo specificato nei parametri di AuthorizedWindowsGroups configurazione AuthorizedPosixGroups o quando distribuisci il componente. Per ulteriori informazioni, consultate la configurazione del componente CLI di Greengrass.

  • Il componente Greengrass CLI è supportato per l'esecuzione in un VPC.

Dipendenze

Quando si distribuisce un componente, vengono distribuite AWS IoT Greengrass anche versioni compatibili delle relative dipendenze. Ciò significa che è necessario soddisfare i requisiti del componente e tutte le sue dipendenze per distribuirlo correttamente. Questa sezione elenca le dipendenze per le versioni rilasciate di questo componente e i vincoli semantici della versione che definiscono le versioni dei componenti per ciascuna dipendenza. È inoltre possibile visualizzare le dipendenze per ciascuna versione del componente nella console. AWS IoT Greengrass Nella pagina dei dettagli del componente, cerca l'elenco delle dipendenze.

2.16.0

La tabella seguente elenca le dipendenze per la versione 2.16.0 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass > =2,12,0 <2,17,0 Flessibili
2.15.1

La tabella seguente elenca le dipendenze per la versione 2.15.1 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass > =2.12.0 <2.16.0 Flessibili
2.15.0

La tabella seguente elenca le dipendenze per la versione 2.15.0 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass > =2.12.0 <2.16.0 Flessibili
2.14.0 – 2.14.3

La tabella seguente elenca le dipendenze per le versioni 2.14.0 e 2.14.3 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass > =2,12,0 <2,15,0 Flessibili
2.13.0

La tabella seguente elenca le dipendenze per la versione 2.13.0 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass > =2.12.0 <2.14.0 Flessibili
2.12.0 – 2.12.6

La tabella seguente elenca le dipendenze per le versioni da 2.12.0 a 2.12.6 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass >=2.12.0 <2.13.0 Flessibili
2.11.0 – 2.11.3

La tabella seguente elenca le dipendenze per le versioni da 2.11.0 a 2.11.3 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass > =2.11.0 <2.12.0 Flessibili
2.10.0 – 2.10.3

La tabella seguente elenca le dipendenze per le versioni da 2.10.0 a 2.10.3 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass > =2.5.0 <2.11.0 Flessibili
2.9.0 – 2.9.6

La tabella seguente elenca le dipendenze per le versioni da 2.9.0 a 2.9.6 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass > =2.5.0 <2.10.0 Flessibili
2.8.0 – 2.8.1

La tabella seguente elenca le dipendenze per le versioni 2.8.0 e 2.8.1 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass > =2.5.0 <2.9.0 Flessibili
2.7.0

La tabella seguente elenca le dipendenze per la versione 2.7.0 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass > =2.5.0 <2.8.0 Flessibili
2.6.0

La tabella seguente elenca le dipendenze per la versione 2.6.0 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass > =2.5.0 <2.7.0 Flessibili
2.5.0 – 2.5.6

La tabella seguente elenca le dipendenze per le versioni da 2.5.0 a 2.5.6 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass > =2.5.0 <2.6.0 Flessibili
2.4.0

La tabella seguente elenca le dipendenze per la versione 2.4.0 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass > =2.1.0 <2.5.0 Flessibili
2.3.0

La tabella seguente elenca le dipendenze per la versione 2.3.0 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass > =2.1.0 <2.4.0 Flessibili
2.2.0

La tabella seguente elenca le dipendenze per la versione 2.2.0 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass > =2.1.0 <2.3.0 Flessibili
2.1.0

La tabella seguente elenca le dipendenze per la versione 2.1.0 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass > =2.1.0 <2.2.0 Flessibili
2.0.x

La tabella seguente elenca le dipendenze per la versione 2.0.x di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass > =2.0.0 <2.1.0 Flessibili
Nota

La versione minima compatibile di Greengrass nucleus corrisponde alla versione patch del componente Greengrass CLI.

Per ulteriori informazioni sulle dipendenze dei componenti, consultate il riferimento alla ricetta dei componenti. ComponentDependencies

Configurazione

Questo componente fornisce i seguenti parametri di configurazione che è possibile personalizzare durante la distribuzione del componente.

2.5.x - 2.14.x
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 il software Core. AWS IoT Greengrass È possibile specificare i nomi o gli ID dei gruppi. Ad esempio, group1,1002,group3 autorizza tre gruppi di sistema (group11002, egroup3) a 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 il software Core. AWS IoT Greengrass

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 il software Core. AWS IoT Greengrass È possibile specificare i nomi o gli ID dei gruppi. Ad esempio, group1,1002,group3 autorizza tre gruppi di sistema (group11002, egroup3) a utilizzare l'interfaccia a riga di comando di Greengrass.

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

Esempio Esempio: aggiornamento dell'unione delle configurazioni

La seguente configurazione di esempio specifica di autorizzare tre gruppi di sistema POSIX (group1,1002, egroup3) e due gruppi di utenti Windows (Device OperatorseQA Engineers) a utilizzare l'interfaccia a riga di comando di Greengrass.

{
  "AuthorizedPosixGroups": "group1,1002,group3",
  "AuthorizedWindowsGroups": "Device Operators,QA Engineers"
}
2.4.x - 2.0.x
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 il software Core. AWS IoT Greengrass È possibile specificare i nomi o gli ID dei gruppi. Ad esempio, group1,1002,group3 autorizza tre gruppi di sistema (group11002, egroup3) a 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 il software Core. AWS IoT Greengrass

Esempio Esempio: aggiornamento dell'unione delle configurazioni

La seguente configurazione di esempio specifica di autorizzare tre gruppi di sistema (group1,1002, egroup3) a utilizzare l'interfaccia a riga di comando di Greengrass.

{
  "AuthorizedPosixGroups": "group1,1002,group3"
}

File di registro locale

Questo componente utilizza lo stesso file di registro del componente Greengrass nucleus.

Linux
/greengrass/v2/logs/greengrass.log
Windows
C:\greengrass\v2\logs\greengrass.log
Per visualizzare i log di questo componente

  • Esegui il seguente comando sul dispositivo principale per visualizzare il file di registro di questo componente in tempo reale. Sostituisci /greengrass/v2 o C:\greengrass\v2 con il percorso della cartella AWS IoT Greengrass principale.

    Linux
    sudo tail -f /greengrass/v2/logs/greengrass.log
    Windows (PowerShell)
    Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait

Changelog

La tabella seguente descrive le modifiche in ciascuna versione del componente.

Versione

Modifiche

2.18.3

Aggiorna la versione del componente per la versione 2.18.3 di Greengrass nucleus.

2.18.2

Aggiorna la versione del componente per la versione 2.18.2 di Greengrass nucleus.

2.18.1

Aggiorna la versione del componente per la versione 2.18.1 di Greengrass nucleus.

2.18.0

Aggiorna la versione del componente per la versione 2.18.0 di Greengrass nucleus.

2.17.0

Aggiorna la versione del componente per la versione 2.17.0 di Greengrass nucleus.

2.16.1

Versione aggiornata per la versione 2.16.1 di Greengrass nucleus.

2.16.0

Versione aggiornata per la versione 2.16.0 di Greengrass nucleus.

2,151

Versione aggiornata per la versione 2.15.1 di Greengrass nucleus.

2.15.0
Correzioni di bug e miglioramenti

  • Aggiunge una correzione in modo che quando la configurazione di autenticazione cambia, il componente non verrà reinstallato ma verrà comunque riavviato.

  • Correzioni di bug generali e miglioramenti.

2.14.3

Versione aggiornata per la versione 2.14.3 di Greengrass nucleus.

2.14.2

Versione aggiornata per la versione 2.14.2 di Greengrass nucleus.

2.14.1

Versione aggiornata per la versione 2.14.1 di Greengrass nucleus.

2.14.0
avvertimento

Questa versione non è più disponibile. I miglioramenti di questa versione sono disponibili nelle versioni successive di questo componente.

Correzioni di bug e miglioramenti

  • Convalida il parametro target di distribuzione nel comando cli.

2.13.0

Versione aggiornata per Greengrass nucleus versione 2.13.0.

2.12.6

Versione aggiornata per la versione 2.12.6 di Greengrass nucleus.

2.12.5

Versione aggiornata per la versione 2.12.5 di Greengrass nucleus.

2.12.4

Versione aggiornata per la versione 2.12.4 di Greengrass nucleus.

2.12.3
avvertimento

Questa versione non è più disponibile. I miglioramenti di questa versione sono disponibili nelle versioni successive di questo componente.

Versione aggiornata per la versione 2.12.3 di Greengrass nucleus.

2.12.2

Versione aggiornata per la versione 2.12.2 di Greengrass nucleus.

2.12.1

Versione aggiornata per la versione 2.12.1 di Greengrass nucleus.

2.12.0

Versione aggiornata per la versione 2.12.0 di Greengrass nucleus.

2.11.3

Versione aggiornata per la versione 2.11.3 di Greengrass nucleus.

2.11.2

Versione aggiornata per la versione 2.11.2 di Greengrass nucleus.

2.11.1

Versione aggiornata per la versione 2.11.1 di Greengrass nucleus.

2.11.0
Nuove funzionalità

  • Consente di annullare una distribuzione locale.

  • Consente di configurare una politica di gestione degli errori per una distribuzione locale.

  • Migliora i report dettagliati sullo stato dell'implementazione.

2.10.3

Versione aggiornata per la versione 2.10.3 di Greengrass nucleus.

2.10.2

Versione aggiornata per la versione 2.10.2 di Greengrass nucleus.

2.10.1

Versione aggiornata per la versione 2.10.1 di Greengrass nucleus.

2.10.0

Versione aggiornata per la versione 2.10.0 di Greengrass nucleus.

2.9.6

Versione aggiornata per la versione 2.9.6 di Greengrass nucleus.

2.9.5

Versione aggiornata per la versione 2.9.5 di Greengrass nucleus.

2.9.4

Versione aggiornata per la versione 2.9.4 di Greengrass nucleus.

2.9.3

Versione aggiornata per la versione 2.9.3 di Greengrass nucleus.

2.9.2

Versione aggiornata per la versione 2.9.2 di Greengrass nucleus.

2.9.1

Versione aggiornata per la versione 2.9.1 di Greengrass nucleus.

2.9.0

 Versione aggiornata per la versione 2.9.0 di Greengrass nucleus.

2.8.1

Versione aggiornata per la versione 2.8.1 di Greengrass nucleus.

2.8.0

 Versione aggiornata per la versione 2.8.0 di Greengrass nucleus.

2.7.0

Versione aggiornata per la versione 2.7.0 di Greengrass nucleus.

2.6.0
Nuove funzionalità

  • Aggiunge il supporto per componenti personalizzati per chiamare le operazioni di comunicazione interprocesso (IPC) utilizzate dalla CLI di Greengrass. È possibile utilizzare queste operazioni IPC per gestire le distribuzioni locali, visualizzare i dettagli dei componenti e generare una password da utilizzare per accedere alla console di debug locale. Console di debug locale Per ulteriori informazioni, consulta IPC: gestione delle distribuzioni e dei componenti locali.

Correzioni di bug e miglioramenti

  • Correzioni e miglioramenti minori aggiuntivi.

2.5.6

Versione aggiornata per la versione 2.5.6 di Greengrass nucleus.

2.5.5

Versione aggiornata per la versione 2.5.5 di Greengrass nucleus.

2.5.4

Versione aggiornata per la versione 2.5.4 di Greengrass nucleus.

2.5.3

Versione aggiornata per la versione 2.5.3 di Greengrass nucleus.

2.5.2

Versione aggiornata per la versione 2.5.2 di Greengrass nucleus.

2.5.1

Versione aggiornata per la versione 2.5.1 di Greengrass nucleus.

2.5.0
Nuove funzionalità

  • Aggiunge il supporto per i dispositivi principali che eseguono Windows.

  • Aggiunge il nuovo parametro di AuthorizedWindowsGroups configurazione che è possibile specificare per autorizzare i gruppi di sistema a utilizzare l'interfaccia a riga di comando di Greengrass sui dispositivi Windows.

  • Aggiunge il windowsUser parametro per le distribuzioni locali. È possibile utilizzare questo parametro per specificare l'utente da utilizzare per eseguire i componenti su un dispositivo Windows core.

2.4.0
Nuove funzionalità

2.3.0

Versione aggiornata per Greengrass nucleus versione 2.3.0.

2.2.0

Versione aggiornata per la versione 2.2.0 di Greengrass nucleus.

2.1.0

Versione aggiornata per la versione 2.1.0 di Greengrass nucleus.

2.0.5

 Versione aggiornata per Greengrass nucleus versione 2.0.5.

2.0.4

 Versione aggiornata per la versione 2.0.4 di Greengrass nucleus.

2.0.3

Versione iniziale.