Aviso de fim do suporte: em 7 de outubro de 2026, AWS o suporte para o. AWS IoT Greengrass Version 1 Depois de 7 de outubro de 2026, você não poderá mais acessar os AWS IoT Greengrass V1 recursos. Para obter mais informações, visite [Migrar de AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html).
As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Opcional: configurar seu contêiner Docker para IDT para AWS IoT Greengrass
AWS IoT Greengrass fornece uma imagem do Docker e um Dockerfile que facilitam a execução do software AWS IoT Greengrass Core em um contêiner do Docker. Depois de configurar o AWS IoT Greengrass contêiner, você pode executar testes de IDT. No momento, somente arquiteturas x86\_64 do Docker são compatíveis com a execução do IDT para o AWS IoT Greengrass.
Esse atributo exige o IDT v2.3.0 ou posterior.
O processo de configuração do contêiner Docker para executar testes de IDT depende se você usa a imagem do Docker ou o Dockerfile fornecido pelo. AWS IoT Greengrass
+ [Use a imagem do Docker](#docker-config-setup-docker-image). A imagem do Docker tem o software AWS IoT Greengrass principal e as dependências instalados.
+ [Use o arquivo do Docker](#docker-config-setup-dockerfile). O Dockerfile contém o código-fonte que você pode usar para criar imagens de AWS IoT Greengrass contêiner personalizadas. A imagem pode ser modificada para funcionar com diferentes arquiteturas de plataforma ou para reduzir o tamanho da imagem.
**nota**
AWS IoT Greengrass não fornece Dockerfiles ou imagens Docker para a versão 1.11.1 AWS IoT Greengrass do software principal. Para executar testes de IDT em suas próprias imagens de contêiner personalizadas, sua imagem deve incluir as dependências definidas no Dockerfile fornecido pela. AWS IoT Greengrass
Os seguintes recursos não estão disponíveis quando você executa AWS IoT Greengrass em um contêiner Docker:
+ [Conectores](connectors.md) executados no modo de **contêiner do Greengrass**. Para executar um conector em um contêiner do Docker, o conector deve ser executado no modo **Sem contêiner**. Para localizar conectores compatíveis com o modo **Sem contêiner** consulte [AWS Conectores do Greengrass fornecidos pela](connectors-list.md). Alguns desses conectores têm um parâmetro de modo de isolamento que você deve definir como **Sem contêiner**.
+ [Recursos de volume e dispositivo locais](access-local-resources.md). Suas funções do Lambda definidas pelo usuário executadas no contêiner do Docker devem acessar dispositivos e volumes diretamente no núcleo.
## Configure a imagem do Docker fornecida pelo AWS IoT Greengrass
Siga estas etapas para configurar a imagem do AWS IoT Greengrass Docker para executar testes de IDT.
**Pré-requisitos**
Antes de começar este tutorial, você deve fazer o seguinte.
+ Você deve instalar os seguintes softwares e versões em seu computador host com base na versão AWS Command Line Interface (AWS CLI) que você escolher.
------
#### [ AWS CLI version 2 ]
+ [Docker](https://docs.docker.com/install/), versão 18.09 ou posterior. Versões anteriores também podem funcionar, mas recomendamos a versão 18.09 ou posterior.
+ AWS CLI versão 2.0.0 ou posterior.
+ Para instalar a AWS CLI versão 2, consulte [Instalando a AWS CLI versão 2](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2.html).
+ Para configurar o AWS CLI, consulte [Configurando o. AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html)
**nota**
Para atualizar para uma AWS CLI versão posterior 2 em um computador Windows, você deve repetir o processo de [instalação do MSI](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2-windows.html).
------
#### [ AWS CLI version 1 ]
+ [Docker](https://docs.docker.com/install/), versão 18.09 ou posterior. Versões anteriores também podem funcionar, mas recomendamos a versão 18.09 ou posterior.
+ [Python](https://www.python.org/downloads/), versão 3.6 ou posterior.
+ [pip](https://pip.pypa.io/en/stable/installing) versão 18.1 ou posterior.
+ AWS CLI versão 1.17.10 ou posterior
+ Para instalar a AWS CLI versão 1, consulte [Instalando a AWS CLI versão 1](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv1.html).
+ Para configurar o AWS CLI, consulte [Configurando o. AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html)
+ Para atualizar para a versão mais recente da AWS CLI versão 1, execute o comando a seguir.
```
pip install awscli --upgrade --user
```
**nota**
Se você usa a [instalação MSI](https://docs.aws.amazon.com/cli/latest/userguide/install-windows.html#msi-on-windows) da AWS CLI versão 1 no Windows, esteja ciente do seguinte:
Se a instalação da AWS CLI versão 1 falhar ao instalar o botocore, tente usar a instalação do [Python](https://docs.aws.amazon.com/cli/latest/userguide/awscli-install-windows.html#awscli-install-windows-pip) e do pip.
Para atualizar para uma AWS CLI versão posterior 1, você deve repetir o processo de instalação do MSI.
------
+ Para acessar os recursos do Amazon Elastic Container Registry (Amazon ECR), você deve conceder a seguinte permissão.
+ O Amazon ECR exige que os usuários concedam a `ecr:GetAuthorizationToken` permissão por meio de uma política AWS Identity and Access Management (IAM) antes de poderem se autenticar em um registro e enviar ou extrair imagens de um repositório do Amazon ECR. Para obter mais informações, consulte [Exemplos de políticas do repositório do Amazon ECR](https://docs.aws.amazon.com/AmazonECR/latest/userguide/repository-policy-examples.html) e [Acessando um repositório do Amazon ECR](https://docs.aws.amazon.com/AmazonECR/latest/userguide/security_iam_id-based-policy-examples.html#security_iam_id-based-policy-examples-access-one-bucket) no *Guia do usuário do Amazon Elastic Container Registry*.
1. Faça download da imagem do Docker e configure o contêiner. Você pode fazer download da imagem pré-criada no [Hub do Docker](https://hub.docker.com/r/amazon/aws-iot-greengrass) ou no [Amazon Elastic Container Registry](https://docs.aws.amazon.com/AmazonECR/latest/userguide/what-is-ecr.html) (Amazon ECR) e executá-la em plataformas do Windows, macOS e Linux (x86\_64).
Para fazer download da imagem do Docker do Amazon ECR, conclua todas as etapas em [Etapa 1: Obtenha o AWS IoT Greengrass imagem de contêiner do Amazon ECR](run-gg-in-docker-container.md#docker-pull-image). Depois, retorne a este tópico para continuar a configuração.
1. Somente usuários do Linux: verifique se o usuário que executa o IDT tem permissão para executar comandos do Docker. Para obter mais informações, consulte [Manage Docker as a non-root user](https://docs.docker.com/install/linux/linux-postinstall/#manage-docker-as-a-non-root-user) na documentação do Docker.
1. Para executar o AWS IoT Greengrass contêiner, use o comando para seu sistema operacional:
------
#### [ Linux ]
```
docker run --rm --init -it -d --name aws-iot-greengrass \
-p 8883:8883 \
-v {{}}:{{}} \
{{}}:{{}}
```
+ {{}}Substitua pelo caminho para o arquivo de configuração do kernel no host e {{}} pelo caminho em que o volume está montado no contêiner.
O arquivo de configuração do kernel no host geralmente está localizado em `/proc/config.gz` ou em `/boot/config-{{}}`. Você pode correr `uname -r` para encontrar o {{}} valor.
**Exemplo:** para montar o arquivo de configuração de `/boot/config-{{}}`
```
-v /boot/config-4.15.0-74-generic:/boot/config-4.15.0-74-generic \
```
**Exemplo:** para montar o arquivo de configuração de `proc/config.gz`
```
-v /proc/config.gz:/proc/config.gz \
```
+ Substitua{{}}: {{}} no comando pelo nome do repositório e pela tag da imagem de destino.
**Exemplo:** Para apontar para a versão mais recente do software AWS IoT Greengrass Core
```
216483018798.dkr.ecr.us-west-2.amazonaws.com/aws-iot-greengrass:latest
```
Para obter a lista de imagens do AWS IoT Greengrass Docker, execute o comando a seguir.
```
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 \
{{}}:{{}}
```
+ Substitua{{}}: {{}} no comando pelo nome do repositório e pela tag da imagem de destino.
**Exemplo:** Para apontar para a versão mais recente do software AWS IoT Greengrass Core
```
216483018798.dkr.ecr.us-west-2.amazonaws.com/aws-iot-greengrass:latest
```
Para obter a lista de imagens do AWS IoT Greengrass Docker, execute o seguinte 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 \
{{}}:{{}}
```
+ Substitua{{}}: {{}} no comando pelo nome do repositório e pela tag da imagem de destino.
**Exemplo:** Para apontar para a versão mais recente do software AWS IoT Greengrass Core
```
216483018798.dkr.ecr.us-west-2.amazonaws.com/aws-iot-greengrass:latest
```
Para obter a lista de imagens do AWS IoT Greengrass Docker, execute o seguinte comando:
```
aws ecr list-images --region us-west-2 --registry-id 216483018798 --repository-name aws-iot-greengrass
```
------
**Importante**
Ao testar com o IDT, não inclua o `--entrypoint /greengrass-entrypoint.sh \` argumento usado para executar a imagem para AWS IoT Greengrass uso geral.
1. Próxima etapa: [configure suas AWS credenciais e seu `device.json` arquivo](set-config.md).
## Configure o dockerfile fornecido pelo AWS IoT Greengrass
Siga estas etapas para configurar a imagem do Docker criada a partir do AWS IoT Greengrass Dockerfile para executar testes de IDT.
1. Em [AWS IoT Greengrass Software Docker](what-is-gg.md#gg-docker-download), faça download do pacote do arquivo do Docker para o computador host e extraia-o.
1. Abra o `README.md`. As próximas três etapas se referem a seções desse arquivo.
1. Verifique se você atende aos requisitos na seção **Pré-requisitos**.
1. Somente usuários do Linux: conclua as etapas **Habilitar as proteções symlink e hardlink** e **Habilitar o encaminhamento da rede IPv4**.
1. Para criar a imagem do Docker, conclua todas as etapas na **Etapa 1. Crie a imagem do AWS IoT Greengrass Docker**. Depois, retorne a este tópico para continuar a configuração.
1. Para executar o AWS IoT Greengrass contêiner, use o comando para seu sistema operacional:
------
#### [ Linux ]
```
docker run --rm --init -it -d --name aws-iot-greengrass \
-p 8883:8883 \
-v {{}}:{{}} \
{{}}:{{}}
```
+ {{}}Substitua pelo caminho para o arquivo de configuração do kernel no host e {{}} pelo caminho em que o volume está montado no contêiner.
O arquivo de configuração do kernel no host geralmente está localizado em `/proc/config.gz` ou em `/boot/config-{{}}`. Você pode correr `uname -r` para encontrar o {{}} valor.
**Exemplo:** para montar o arquivo de configuração de `/boot/config-{{}}`
```
-v /boot/config-4.15.0-74-generic:/boot/config-4.15.0-74-generic \
```
**Exemplo:** para montar o arquivo de configuração de `proc/config.gz`
```
-v /proc/config.gz:/proc/config.gz \
```
+ Substitua{{}}: {{}} no comando pelo nome do repositório e pela tag da imagem de destino.
**Exemplo:** Para apontar para a versão mais recente do software AWS IoT Greengrass Core
```
216483018798.dkr.ecr.us-west-2.amazonaws.com/aws-iot-greengrass:latest
```
Para obter a lista de imagens do AWS IoT Greengrass Docker, execute o comando a seguir.
```
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 \
{{}}:{{}}
```
+ Substitua{{}}: {{}} no comando pelo nome do repositório e pela tag da imagem de destino.
**Exemplo:** Para apontar para a versão mais recente do software AWS IoT Greengrass Core
```
216483018798.dkr.ecr.us-west-2.amazonaws.com/aws-iot-greengrass:latest
```
Para obter a lista de imagens do AWS IoT Greengrass Docker, execute o seguinte 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 \
{{}}:{{}}
```
+ Substitua{{}}: {{}} no comando pelo nome do repositório e pela tag da imagem de destino.
**Exemplo:** Para apontar para a versão mais recente do software AWS IoT Greengrass Core
```
216483018798.dkr.ecr.us-west-2.amazonaws.com/aws-iot-greengrass:latest
```
Para obter a lista de imagens do AWS IoT Greengrass Docker, execute o seguinte comando:
```
aws ecr list-images --region us-west-2 --registry-id 216483018798 --repository-name aws-iot-greengrass
```
------
**Importante**
Ao testar com o IDT, não inclua o `--entrypoint /greengrass-entrypoint.sh \` argumento usado para executar a imagem para AWS IoT Greengrass uso geral.
1. Próxima etapa: [configure suas AWS credenciais e seu `device.json` arquivo](set-config.md).
## Solução de problemas na configuração do contêiner Docker para IDT para AWS IoT Greengrass
Use as informações a seguir para ajudar a solucionar problemas com a execução de um contêiner Docker para IDT para testes. AWS IoT Greengrass
### AVISO: Erro ao carregar o arquivo de configuração:/home/user/. docker/config.json - stat /home/ user /. < > docker/config.json: permissão negada
Se você receber esse erro ao executar comandos `docker` no Linux, execute o comando a seguir. {{}}Substitua o comando a seguir pelo usuário que executa o IDT.
```
sudo chown {{}}:{{}} /home/{{}}/.docker -R
sudo chmod g+rwx /home/{{}}/.docker -R
```