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à.
# Installazione della CLI di Greengrass
È possibile installare la Greengrass CLI in uno dei seguenti modi:
+ Usa l'`--deploy-dev-tools`argomento quando configuri per la prima volta il software AWS IoT Greengrass Core sul tuo dispositivo. È inoltre necessario specificare `--provision true` di applicare questo argomento.
+ Implementa il `aws.greengrass.Cli` componente Greengrass CLI () sul tuo dispositivo.
Questa sezione descrive i passaggi per distribuire il componente Greengrass CLI. Per informazioni sull'installazione della Greengrass CLI durante la configurazione iniziale, vedere. [Tutorial: Guida introduttiva a AWS IoT Greengrass V2](getting-started.md)
## Prerequisiti
Per distribuire 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 a AWS IoT Greengrass V2](getting-started.md).
+ Per utilizzare AWS CLI per distribuire la CLI Greengrass, è necessario aver installato e configurato il. AWS CLI Per ulteriori informazioni, consulta [Configurazione della AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html) nella *Guida per l'utente di AWS Command Line Interface *.
+ È necessario essere autorizzati a utilizzare la CLI Greengrass per interagire con il software Core. AWS IoT Greengrass Effettuate una delle seguenti operazioni per utilizzare la Greengrass CLI:
+ 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, consulta Configurazione dei componenti della [CLI di Greengrass](greengrass-cli-component.md#greengrass-cli-component-configuration).
## Implementa il componente Greengrass CLI
Completa i seguenti passaggi per distribuire il componente Greengrass CLI sul tuo dispositivo principale:
### Per distribuire il componente Greengrass CLI (console)
1. Accedi alla [console AWS IoT Greengrass](https://console.aws.amazon.com/greengrass).
1. **Nel menu di navigazione, scegli Componenti.**
1. Nella pagina **Componenti**, nella scheda **Componenti pubblici**, scegli `aws.greengrass.Cli`.
1. Nella pagina **aws.greengrass.Cli**, scegli **(Distribuisci)**.
1. Da **Aggiungi alla distribuzione**, scegli **Crea nuova distribuzione**.
1. **Nella pagina **Specificare la destinazione**, in **Destinazioni di distribuzione**, nell'elenco **Nome destinazione**, scegli il gruppo Greengrass in cui desideri eseguire la distribuzione e scegli Avanti.**
1. **Nella pagina **Seleziona componenti**, verifica che il **aws.greengrass.Cli**componente sia selezionato e scegli Avanti.**
1. Nella pagina **Configura componenti**, mantieni le impostazioni di configurazione predefinite e scegli **Avanti**.
1. Nella pagina **Configura impostazioni avanzate**, mantieni le impostazioni di configurazione predefinite e scegli **Avanti**.
1. Nella pagina di **revisione**, fai clic su **Distribuisci**
### Per distribuire il componente Greengrass CLI ()AWS CLI
1. Sul tuo dispositivo, crea un `deployment.json` file per definire la configurazione di distribuzione per il componente Greengrass CLI. Questo file dovrebbe avere il seguente aspetto:
```
{
"targetArn":"targetArn",
"components": {
"aws.greengrass.Cli": {
"componentVersion": "2.16.1",
"configurationUpdate": {
"merge": "{\"AuthorizedPosixGroups\":\",,...,\",\"AuthorizedWindowsGroups\":\",,...,\"}"
}
}
}
}
```
+ 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`
+ Nell'oggetto `aws.greengrass.Cli` componente, specificate i valori come segue:
`version`
La versione del componente Greengrass CLI.
`configurationUpdate.AuthorizedPosixGroups`
(Facoltativo) Una stringa che contiene un elenco di gruppi di sistema separati da virgole. Autorizzi questi gruppi di sistema a utilizzare la 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 (`group1``1002`, e`group3`) a utilizzare la CLI Greengrass.
Se non specifichi alcun gruppo da autorizzare, puoi utilizzare la CLI Greengrass come `sudo` utente root () o come utente di sistema che AWS IoT Greengrass esegue il software Core.
`configurationUpdate.AuthorizedWindowsGroups`
(Facoltativo) Una stringa che contiene un elenco separato da virgole di gruppi di sistema. Autorizzi questi gruppi di sistema a utilizzare la 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 (`group1``1002`, e`group3`) a utilizzare la CLI Greengrass.
Se non specifichi alcun gruppo da autorizzare, puoi utilizzare la CLI Greengrass come amministratore o come utente di sistema che AWS IoT Greengrass esegue il software Core.
1. Esegui il comando seguente per distribuire il componente Greengrass CLI sul dispositivo:
```
$ aws greengrassv2 create-deployment --cli-input-json file://path/to/deployment.json
```
Durante l'installazione, il componente aggiunge un collegamento simbolico `/greengrass/v2/bin` nella cartella del dispositivo e da questo percorso si esegue la Greengrass CLI. `greengrass-cli` Per eseguire la CLI di Greengrass senza il percorso assoluto, aggiungi la `/greengrass/v2/bin` cartella alla variabile PATH. Per verificare l'installazione della CLI di Greengrass, esegui il seguente comando:
------
#### [ 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=] [COMMAND]
Greengrass command line interface
--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 la CLI di Greengrass. Per ulteriori informazioni, consulta [Risoluzione dei problemi AWS IoT Greengrass V2](troubleshooting.md).