Avviso di fine del supporto: il 7 ottobre 2026, AWS il supporto per. AWS IoT Greengrass Version 1 Dopo il 7 ottobre 2026, non potrai più accedere alle risorse. AWS IoT Greengrass V1 Per ulteriori informazioni, visita [Migrate](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html) from. AWS IoT Greengrass Version 1
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à.
# Opzionale: configurazione del contenitore Docker per IDT per AWS IoT Greengrass
AWS IoT Greengrass fornisce un'immagine Docker e un Dockerfile che semplificano l'esecuzione del software AWS IoT Greengrass Core in un contenitore Docker. Dopo aver configurato il AWS IoT Greengrass contenitore, puoi eseguire test IDT. Attualmente, solo le architetture Docker x86\_64 sono supportate per l'esecuzione di IDT per AWS IoT Greengrass.
Questa funzionalità richiede IDT v2.3.0 o versione successiva.
Il processo di configurazione del contenitore Docker per eseguire i test IDT dipende dall'utilizzo dell'immagine Docker o del Dockerfile fornito da. AWS IoT Greengrass
+ [Usare l'immagine Docker](#docker-config-setup-docker-image). Nell'immagine Docker sono installati il software Core e le dipendenze AWS IoT Greengrass .
+ [Usa il Dockerfile](#docker-config-setup-dockerfile). Il Dockerfile contiene il codice sorgente che puoi usare per creare immagini di container personalizzate. AWS IoT Greengrass L'immagine può essere modificata per essere eseguita su diverse architetture di piattaforma o per ridurne le dimensioni.
**Nota**
AWS IoT Greengrass non fornisce file Dockerfile o immagini Docker per AWS IoT Greengrass la versione principale del software 1.11.1. Per eseguire test IDT su immagini di contenitori personalizzate, l'immagine deve includere le dipendenze definite nel Dockerfile fornito da. AWS IoT Greengrass
Le seguenti funzionalità non sono disponibili quando vengono eseguite AWS IoT Greengrass in un contenitore Docker:
+ [Connettori](connectors.md) eseguiti in modalità **container Greengrass**. Per eseguire un connettore in un container Docker, il connettore deve essere eseguito in modalità **Nessun container**. Per trovare i connettori che supportano la modalità **Nessun container** consulta [AWS-connettori Greengrass forniti](connectors-list.md). Alcuni di questi connettori dispongono di un parametro della modalità di isolamento che devi impostare su **No container (Nessun contenitore)**.
+ [Risorse volume e dispositivo locale](access-local-resources.md). Le funzioni Lambda definite dall'utente che vengono eseguite nel contenitore Docker devono accedere direttamente ai dispositivi e ai volumi sul core.
## Configura l'immagine Docker fornita da AWS IoT Greengrass
Segui questi passaggi per configurare l'immagine AWS IoT Greengrass Docker per eseguire i test IDT.
**Prerequisiti**
Prima di iniziare questo tutorial, devi fare quanto segue.
+ È necessario installare il software e le versioni seguenti sul computer host in base alla versione AWS Command Line Interface (AWS CLI) scelta.
------
#### [ AWS CLI version 2 ]
+ [Docker](https://docs.docker.com/install/) versione 18.09 o successiva. Anche le versioni precedenti potrebbero funzionare, ma consigliamo 18.09 o successive.
+ AWS CLI versione 2.0.0 o successiva.
+ Per installare la AWS CLI versione 2, vedere [Installazione della AWS CLI versione](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2.html) 2.
+ Per configurare AWS CLI, vedere [Configurazione di AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html).
**Nota**
Per eseguire l'aggiornamento a una AWS CLI versione 2 successiva su un computer Windows, è necessario ripetere la procedura di [installazione MSI](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2-windows.html).
------
#### [ AWS CLI version 1 ]
+ [Docker](https://docs.docker.com/install/) versione 18.09 o successiva. Anche le versioni precedenti potrebbero funzionare, ma consigliamo 18.09 o successive.
+ [Python](https://www.python.org/downloads/) versione 3.6 o successiva.
+ [pip](https://pip.pypa.io/en/stable/installing) versione 18.1 o successiva.
+ AWS CLI versione 1.17.10 o successiva
+ Per installare la AWS CLI versione 1, vedi [Installazione della AWS CLI versione](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv1.html) 1.
+ Per configurare AWS CLI, vedere [Configurazione di AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html).
+ Per eseguire l'aggiornamento alla versione più recente della AWS CLI versione 1, esegui il comando seguente.
```
pip install awscli --upgrade --user
```
**Nota**
Se utilizzi l'[installazione MSI](https://docs.aws.amazon.com/cli/latest/userguide/install-windows.html#msi-on-windows) della AWS CLI versione 1 su Windows, tieni presente quanto segue:
Se l'installazione della AWS CLI versione 1 non riesce a installare botocore, prova a utilizzare l'installazione di [Python](https://docs.aws.amazon.com/cli/latest/userguide/awscli-install-windows.html#awscli-install-windows-pip) e pip.
Per eseguire l'aggiornamento a una AWS CLI versione 1 successiva, è necessario ripetere il processo di installazione MSI.
------
+ Per accedere alle risorse di Amazon Elastic Container Registry (Amazon ECR), devi concedere la seguente autorizzazione.
+ Amazon ECR richiede agli utenti di concedere l'`ecr:GetAuthorizationToken`autorizzazione tramite una policy AWS Identity and Access Management (IAM) prima di poter autenticarsi in un registro e inviare o estrarre immagini da un repository Amazon ECR. Per ulteriori informazioni, consulta [Amazon ECR Repository Policy Examples e Accessing](https://docs.aws.amazon.com/AmazonECR/latest/userguide/repository-policy-examples.html) [One Amazon ECR Repository nella Amazon](https://docs.aws.amazon.com/AmazonECR/latest/userguide/security_iam_id-based-policy-examples.html#security_iam_id-based-policy-examples-access-one-bucket) *Elastic Container* Registry User Guide.
1. Scaricare l'immagine Docker e configurare il contenitore. Puoi scaricare l'immagine predefinita da [Docker Hub](https://hub.docker.com/r/amazon/aws-iot-greengrass) o Amazon [Elastic Container Registry](https://docs.aws.amazon.com/AmazonECR/latest/userguide/what-is-ecr.html) (Amazon ECR) ed eseguirla su piattaforme Windows, macOS e Linux (x86\_64).
Per scaricare l'immagine Docker da Amazon ECR, completa tutti i passaggi indicati di seguito. [Fase 1: Ottieni il AWS IoT Greengrass immagine del contenitore da Amazon ECR](run-gg-in-docker-container.md#docker-pull-image) Quindi, tornare a questo argomento per continuare la configurazione.
1. Solo utenti Linux: assicurarsi che l'utente che esegue IDT disponga dell'autorizzazione per eseguire comandi Docker. Per ulteriori informazioni, vedere [Gestisci finestra mobile come utente non root](https://docs.docker.com/install/linux/linux-postinstall/#manage-docker-as-a-non-root-user) nella documentazione Docker.
1. Per eseguire il AWS IoT Greengrass contenitore, usa il comando relativo al tuo sistema operativo:
------
#### [ Linux ]
```
docker run --rm --init -it -d --name aws-iot-greengrass \
-p 8883:8883 \
-v {{}}:{{}} \
{{}}:{{}}
```
+ Sostituitelo {{}} con il percorso del file di configurazione del kernel sull'host e {{}} con il percorso in cui il volume è montato nel contenitore.
Il file di configurazione del kernel sull'host di solito si trova in `/proc/config.gz` o `/boot/config-{{}}`. Puoi correre `uname -r` per trovare il {{}} valore.
**Esempio:** per montare il file di configurazione da `/boot/config-{{}}`
```
-v /boot/config-4.15.0-74-generic:/boot/config-4.15.0-74-generic \
```
**Esempio:** per montare il file di configurazione da `proc/config.gz`
```
-v /proc/config.gz:/proc/config.gz \
```
+ Sostituisci{{}}: {{}} nel comando con il nome del repository e il tag dell'immagine di destinazione.
**Esempio:** indicare la versione più recente del software AWS IoT Greengrass Core
```
216483018798.dkr.ecr.us-west-2.amazonaws.com/aws-iot-greengrass:latest
```
Per ottenere l'elenco delle immagini AWS IoT Greengrass Docker, esegui il seguente comando.
```
aws ecr list-images --region us-west-2 --registry-id 216483018798 --repository-name aws-iot-greengrass
```
------
#### [ macOS ]
```
docker run --rm --init -it -d --name aws-iot-greengrass \
-p 8883:8883 \
{{}}:{{}}
```
+ Sostituisci{{}}: {{}} nel comando con il nome del repository e il tag dell'immagine di destinazione.
**Esempio:** indicare la versione più recente del software AWS IoT Greengrass Core
```
216483018798.dkr.ecr.us-west-2.amazonaws.com/aws-iot-greengrass:latest
```
Per ottenere l'elenco delle immagini AWS IoT Greengrass Docker, esegui il seguente comando:
```
aws ecr list-images --region us-west-2 --registry-id 216483018798 --repository-name aws-iot-greengrass
```
------
#### [ Windows ]
```
docker run --rm --init -it -d --name aws-iot-greengrass \
-p 8883:8883 \
{{}}:{{}}
```
+ Sostituisci{{}}: {{}} nel comando con il nome del repository e il tag dell'immagine di destinazione.
**Esempio:** indicare la versione più recente del software AWS IoT Greengrass Core
```
216483018798.dkr.ecr.us-west-2.amazonaws.com/aws-iot-greengrass:latest
```
Per ottenere l'elenco delle immagini AWS IoT Greengrass Docker, esegui il seguente comando:
```
aws ecr list-images --region us-west-2 --registry-id 216483018798 --repository-name aws-iot-greengrass
```
------
**Importante**
Durante il test con IDT, non includete l'`--entrypoint /greengrass-entrypoint.sh \`argomento utilizzato per eseguire l'immagine per uso generale AWS IoT Greengrass .
1. Passaggio successivo: [configura le AWS credenziali e `device.json`](set-config.md) il file.
## Configura il dockerfile fornito da AWS IoT Greengrass
Segui questi passaggi per configurare l'immagine Docker creata dal AWS IoT Greengrass Dockerfile per eseguire i test IDT.
1. Da [AWS IoT Greengrass Software Docker](what-is-gg.md#gg-docker-download), scaricare il pacchetto Dockerfile sul computer host ed estrarlo.
1. Aprire `README.md`. I tre passaggi successivi si riferiscono alle sezioni di questo file.
1. Assicurarsi di soddisfare i requisiti nella sezione **Prerequisiti** .
1. Solo utenti Linux: completare la procedura **Abilita protezione Symlink e Hardlink** e **Abilita inoltro di rete IPv4** .
1. **Per creare l'immagine Docker, completa tutti i passaggi del passaggio 1. Crea l'immagine AWS IoT Greengrass Docker**. Quindi, tornare a questo argomento per continuare la configurazione.
1. Per eseguire il AWS IoT Greengrass contenitore, usa il comando per il tuo sistema operativo:
------
#### [ Linux ]
```
docker run --rm --init -it -d --name aws-iot-greengrass \
-p 8883:8883 \
-v {{}}:{{}} \
{{}}:{{}}
```
+ Sostituitelo {{}} con il percorso del file di configurazione del kernel sull'host e {{}} con il percorso in cui il volume è montato nel contenitore.
Il file di configurazione del kernel sull'host di solito si trova in `/proc/config.gz` o `/boot/config-{{}}`. Puoi correre `uname -r` per trovare il {{}} valore.
**Esempio:** per montare il file di configurazione da `/boot/config-{{}}`
```
-v /boot/config-4.15.0-74-generic:/boot/config-4.15.0-74-generic \
```
**Esempio:** per montare il file di configurazione da `proc/config.gz`
```
-v /proc/config.gz:/proc/config.gz \
```
+ Sostituisci{{}}: {{}} nel comando con il nome del repository e il tag dell'immagine di destinazione.
**Esempio:** indicare la versione più recente del software AWS IoT Greengrass Core
```
216483018798.dkr.ecr.us-west-2.amazonaws.com/aws-iot-greengrass:latest
```
Per ottenere l'elenco delle immagini AWS IoT Greengrass Docker, esegui il seguente comando.
```
aws ecr list-images --region us-west-2 --registry-id 216483018798 --repository-name aws-iot-greengrass
```
------
#### [ macOS ]
```
docker run --rm --init -it -d --name aws-iot-greengrass \
-p 8883:8883 \
{{}}:{{}}
```
+ Sostituisci{{}}: {{}} nel comando con il nome del repository e il tag dell'immagine di destinazione.
**Esempio:** indicare la versione più recente del software AWS IoT Greengrass Core
```
216483018798.dkr.ecr.us-west-2.amazonaws.com/aws-iot-greengrass:latest
```
Per ottenere l'elenco delle immagini AWS IoT Greengrass Docker, esegui il seguente comando:
```
aws ecr list-images --region us-west-2 --registry-id 216483018798 --repository-name aws-iot-greengrass
```
------
#### [ Windows ]
```
docker run --rm --init -it -d --name aws-iot-greengrass \
-p 8883:8883 \
{{}}:{{}}
```
+ Sostituisci{{}}: {{}} nel comando con il nome del repository e il tag dell'immagine di destinazione.
**Esempio:** indicare la versione più recente del software AWS IoT Greengrass Core
```
216483018798.dkr.ecr.us-west-2.amazonaws.com/aws-iot-greengrass:latest
```
Per ottenere l'elenco delle immagini AWS IoT Greengrass Docker, esegui il seguente comando:
```
aws ecr list-images --region us-west-2 --registry-id 216483018798 --repository-name aws-iot-greengrass
```
------
**Importante**
Durante il test con IDT, non includete l'`--entrypoint /greengrass-entrypoint.sh \`argomento utilizzato per eseguire l'immagine per uso generale AWS IoT Greengrass .
1. Passaggio successivo: [configura le AWS credenziali e `device.json`](set-config.md) il file.
## Risoluzione dei problemi di configurazione del contenitore Docker per IDT per AWS IoT Greengrass
Utilizza le seguenti informazioni per risolvere i problemi relativi all'esecuzione di un contenitore Docker per IDT a scopo di test. AWS IoT Greengrass
### ATTENZIONE: errore durante il caricamento del file di configurazione://. home/user docker/config.json - stat /home/ user /. < > docker/config.json: autorizzazione negata
Se viene visualizzato questo errore durante l'esecuzione di comandi `docker` su Linux, eseguire il seguente comando. Sostituiscilo {{}} nel comando seguente con l'utente che esegue IDT.
```
sudo chown {{}}:{{}} /home/{{}}/.docker -R
sudo chmod g+rwx /home/{{}}/.docker -R
```