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 CLI Greengrass (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 AWS IoT Greengrass Software di base. Per ulteriori informazioni, consulta Tutorial: Guida introduttiva 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 è necessario.

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 a greengrass-cli nel /greengrass/v2/bin cartella. Puoi eseguire la CLI di Greengrass da questo percorso o aggiungerla al tuo PATH variabile di ambiente da eseguire greengrass-cli senza il suo 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 denominato com.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 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 AWS IoT Greengrass Software di base. Effettuate una delle seguenti operazioni per utilizzare la CLI di Greengrass:

    • Utilizzate l'utente del sistema che esegue il 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.

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

Dipendenze

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

2.18.0 - 2.18.4

La tabella seguente elenca le dipendenze per le versioni da 2.18.0 a 2.18.4 di questo componente.

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

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

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass > =2,12,0 <2,18,0 Flessibili
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, consulta riferimento alla ricetta dei componenti.

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

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.

Esempio Esempio: aggiornamento dell'unione delle configurazioni

La seguente configurazione di esempio specifica di autorizzare tre gruppi di sistema POSIX (group1, 1002, e group3) e due gruppi di utenti Windows (Device Operators e QA Engineers) per 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 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.

Esempio Esempio: aggiornamento dell'unione delle configurazioni

La seguente configurazione di esempio specifica di autorizzare tre gruppi di sistema (group1, 1002, e group3) per 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 Nucleo di Greengrass componente.

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 verso il AWS IoT Greengrass cartella 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.4

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

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

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 la versione 2.13.0 di Greengrass nucleus.

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 che è possibile utilizzare per accedere a console di debug locale. Per ulteriori informazioni, vedere IPC: gestione delle implementazioni 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 AuthorizedWindowsGroups parametro di 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 la versione 2.3.0 di Greengrass nucleus.

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 la versione 2.0.5 di Greengrass nucleus.

2.0.4

 Versione aggiornata per la versione 2.0.4 di Greengrass nucleus.

2.0.3

Versione iniziale.