Argomenti dell'installatore - AWS IoT 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à.

Argomenti dell'installatore

Il software AWS IoT Greengrass Core include un programma di installazione che configura il software e fornisce le AWS risorse necessarie per il funzionamento del dispositivo principale Greengrass. Il programma di installazione include i seguenti argomenti che è possibile specificare per configurare l'installazione:

-h, --help

(Facoltativo) Mostra le informazioni di aiuto dell'installatore.

--version

(Facoltativo) Mostra la versione del software AWS IoT Greengrass Core.

-Droot

(Facoltativo) Il percorso della cartella da utilizzare come root per il software AWS IoT Greengrass Core.

Nota

Questo argomento imposta una proprietà JVM, quindi è necessario specificarla prima di eseguire -jar il programma di installazione. Ad esempio, specifica java -Droot="/greengrass/v2" -jar /path/to/Greengrass.jar.

Impostazione predefinita:

  • Linux: ~/.greengrass

  • Windows: %USERPROFILE%/.greengrass

-ar, --aws-region

Regione AWSQuello che il software AWS IoT Greengrass Core utilizza per recuperare o creare le risorse richieste. AWS

-p, --provision

(Facoltativo) È possibile registrare questo dispositivo come AWS IoT oggetto e fornire le AWS risorse richieste dal dispositivo principale. Se si specificatrue, il software AWS IoT Greengrass Core fornisce qualsiasi AWS IoT oggetto, (facoltativo) un AWS IoT gruppo di oggetti, un ruolo IAM e un alias di AWS IoT ruolo.

Impostazione predefinita: false

-tn, --thing-name

(Facoltativo) Il nome dell'AWS IoTelemento che registrate come dispositivo principale. Se l'oggetto con questo nome non esiste nel tuo computerAccount AWS, il software AWS IoT Greengrass Core lo crea.

Nota

Il nome dell'oggetto non può contenere i due punti (:).

È necessario specificare --provision true se applicare questo argomento.

Impostazione predefinita: GreengrassV2IotThing_ più un UUID casuale.

-tgn, --thing-group-name

(Facoltativo) Il nome del AWS IoT gruppo di oggetti a cui aggiungi l'elemento del AWS IoT dispositivo principale. Se una distribuzione ha come target questo gruppo di oggetti, il dispositivo principale riceve tale distribuzione quando si connette aAWS IoT Greengrass. Se il gruppo di oggetti con questo nome non esiste nel tuo computerAccount AWS, il software AWS IoT Greengrass Core lo crea.

Nota

Il nome del gruppo di cose non può contenere i due punti (:).

È necessario specificare --provision true se applicare questo argomento.

-tpn, --thing-policy-name

Questa funzionalità è disponibile per la versione 2.4.0 e successive del componente Greengrass nucleus.

(Facoltativo) Il nome della AWS IoT policy da allegare al thing certificate di questo dispositivo principale. AWS IoT Se la AWS IoT politica con questo nome non esiste nel tuo computerAccount AWS, il software AWS IoT Greengrass Core la crea.

Il software AWS IoT Greengrass Core crea una AWS IoT politica permissiva per impostazione predefinita. È possibile definire l'ambito di questa politica o creare una politica personalizzata in cui limitare le autorizzazioni per il proprio caso d'uso. Per ulteriori informazioni, consulta AWS IoTPolitica minima per i dispositivi AWS IoT Greengrass V2 principali.

È necessario specificare --provision true se applicare questo argomento.

Impostazione predefinita: GreengrassV2IoTThingPolicy

-trn, --tes-role-name

(Facoltativo) Il nome del ruolo IAM da utilizzare per acquisire AWS credenziali che consentono al dispositivo principale di interagire con AWS i servizi. Se il ruolo con questo nome non esiste nel tuoAccount AWS, il software AWS IoT Greengrass Core lo crea con la GreengrassV2TokenExchangeRoleAccess policy. Questo ruolo non ha accesso ai tuoi bucket S3 dove ospiti gli artefatti dei componenti. Pertanto, è necessario aggiungere le autorizzazioni ai bucket e agli oggetti S3 degli artefatti quando si crea un componente. Per ulteriori informazioni, consulta Autorizza i dispositivi principali a interagire con i servizi AWS.

È necessario specificare se applicare questo argomento. --provision true

Impostazione predefinita: GreengrassV2TokenExchangeRole

-tra, --tes-role-alias-name

(Facoltativo) Il nome dell'alias del AWS IoT ruolo che punta al ruolo IAM che fornisce AWS le credenziali per questo dispositivo principale. Se l'alias del ruolo con questo nome non esiste nel tuo computerAccount AWS, il software AWS IoT Greengrass Core lo crea e lo indirizza al ruolo IAM da te specificato.

È necessario specificare --provision true se applicare questo argomento.

Impostazione predefinita: GreengrassV2TokenExchangeRoleAlias

-ss, --setup-system-service

(Facoltativo) È possibile configurare il software AWS IoT Greengrass Core come servizio di sistema che viene eseguito all'avvio del dispositivo. Il nome del servizio di sistema ègreengrass. Per ulteriori informazioni, consulta Configurare il nucleo Greengrass come servizio di sistema.

Nei sistemi operativi Linux, questo argomento richiede che il sistema init systemd sia disponibile sul dispositivo.

Importante

Nei dispositivi Windows core, è necessario configurare il software AWS IoT Greengrass Core come servizio di sistema.

Impostazione predefinita: false

-u, --component-default-user

Il nome o l'ID dell'utente utilizzato dal software AWS IoT Greengrass Core per eseguire i componenti. Ad esempio, puoi specificare ggc_user. Questo valore è richiesto quando si esegue il programma di installazione su sistemi operativi Windows.

Nei sistemi operativi Linux, è anche possibile specificare facoltativamente il gruppo. Specificare l'utente e il gruppo separati da due punti. Ad esempio, ggc_user:ggc_group.

Le seguenti considerazioni aggiuntive si applicano ai sistemi operativi Linux:

  • Se si esegue come root, l'utente predefinito del componente è l'utente definito nel file di configurazione. Se il file di configurazione non definisce un utente, il valore predefinito è. ggc_user:ggc_group Se esistono ggc_user o ggc_group non esistono, il software li crea.

  • Se si esegue come utente non root, il software AWS IoT Greengrass Core utilizza quell'utente per eseguire i componenti.

  • Se non specificate un gruppo, il software AWS IoT Greengrass Core utilizza il gruppo principale dell'utente del sistema.

Per ulteriori informazioni, consulta Configurare l'utente che esegue i componenti.

-d, --deploy-dev-tools

(Facoltativo) È possibile scaricare e distribuire il componente Greengrass CLI su questo dispositivo principale. È possibile utilizzare questo strumento per sviluppare ed eseguire il debug di componenti su questo dispositivo principale.

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.

È necessario specificare se --provision true applicare questo argomento.

Impostazione predefinita: false

-init, --init-config

(Facoltativo) Il percorso del file di configurazione da utilizzare per installare il software AWS IoT Greengrass Core. È possibile utilizzare questa opzione per configurare nuovi dispositivi principali con una configurazione di nucleo specifica, ad esempio.

Importante

Il file di configurazione specificato si fonde con il file di configurazione esistente sul dispositivo principale. Ciò include i componenti e le configurazioni dei componenti sul dispositivo principale. È consigliabile che il file di configurazione elenchi solo le configurazioni che si sta tentando di modificare.

-tp, --trusted-plugin

(Facoltativo) Il percorso di un file JAR da caricare come plugin affidabile. Utilizzate questa opzione per fornire i file JAR del plug-in di provisioning, ad esempio per l'installazione con fleet provisioning o il provisioning personalizzato, oppure per l'installazione con la chiave privata e il certificato in un modulo di sicurezza hardware.

-s, --start

(Facoltativo) È possibile avviare il software AWS IoT Greengrass Core dopo l'installazione e, facoltativamente, effettuare il provisioning delle risorse.

Impostazione predefinita: true