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

Greengrass CLI

Il CLI componente 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. Greengrass CLI consente, ad esempio, di creare distribuzioni 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: Nozioni di base su 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 distribuendo questo componente solo sui dispositivi principali dove ne hai bisogno.

Dopo aver installato questo componente, esegui il comando seguente per visualizzarne la documentazione di aiuto. Quando questo componente viene installato, aggiunge un collegamento simbolico alla greengrass-cli /greengrass/v2/bin cartella. È possibile eseguire Greengrass CLI da questo percorso o aggiungerlo alla variabile di PATH ambiente per eseguirlo 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.13.x

  • 2.12x

  • 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,0x

Tipo

Questo componente è un componente del plugin ()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 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 su dispositivi principali che eseguono i seguenti sistemi operativi:

  • Linux

  • Windows

Requisiti

Questo componente presenta i seguenti requisiti:

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

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

Dipendenze

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

2.13.0

La tabella seguente elenca le dipendenze per le versioni da 2.12.0 a 2.14.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 del nucleo Greengrass corrisponde alla versione patch del componente Greengrass. CLI

Per ulteriori informazioni sulle dipendenze dei componenti, consulta il 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.13.x
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.

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.

Esempio: fusione e aggiornamento della configurazione

La configurazione di esempio seguente specifica di autorizzare tre gruppi di POSIX sistema (group11002, egroup3) e due gruppi di utenti Windows (Device OperatorsandQA Engineers) a utilizzare Greengrass. CLI

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

Esempio: fusione e aggiornamento della configurazione

La seguente configurazione di esempio specifica di autorizzare tre gruppi di sistema (group11002, egroup3) a utilizzare Greengrass. CLI

{
  "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 ogni versione del componente.

Versione

Modifiche

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 Greengrass nucleus versione 2.12.3.

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 la segnalazione dettagliata dello 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à
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 CLI 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 principale.

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 Greengrass nucleus versione 2.0.4.

2.0.3

Versione iniziale.