AWS IoT Greengrass Version 1 entrou na fase de vida útil prolongada em 30 de junho de 2023. Para obter mais informações, consulte política de manutenção do AWS IoT Greengrass V1. Após essa data, AWS IoT Greengrass V1 não lançaremos atualizações que forneçam recursos, aprimoramentos, correções de erros ou patches de segurança. Os dispositivos que funcionam AWS IoT Greengrass V1 não serão interrompidos e continuarão operando e se conectando à nuvem. É altamente recomendável que você migre para AWS IoT Greengrass Version 2, o que adiciona novos recursos significativos e suporte para plataformas adicionais.
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 o contêiner do Docker para IDT para o AWS IoT Greengrass
O AWS IoT Greengrass fornece uma imagem do Docker e um arquivo do Docker que facilitam a execução do software do AWS IoT Greengrass Core em um contêiner do Docker. Depois de configurar o contêiner do AWS IoT Greengrass, é possível 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 do Docker para executar testes de IDT depende se você usa a imagem do Docker ou o arquivo do Docker fornecidos pelo AWS IoT Greengrass.
Use a imagem do Docker. A imagem do Docker tem as dependências e o software do AWS IoT Greengrass Core instalados.
Use o arquivo do Docker. O arquivo do Docker contém o código-fonte que pode ser usado para criar imagens de contêiner do AWS IoT Greengrass personalizadas. A imagem pode ser modificada para funcionar com diferentes arquiteturas de plataforma ou para reduzir o tamanho da imagem.
nota
O AWS IoT Greengrass não fornece Dockerfiles ou imagens do Docker para a versão 1.11.1 do software AWS IoT Greengrass Core. Para executar testes de IDT nas suas próprias imagens de contêiner personalizadas, a imagem deve incluir as dependências definidas no arquivo do Docker fornecido pelo AWS IoT Greengrass.
Os atributos a seguir não estão disponíveis ao executar o AWS IoT Greengrass em um contêiner do Docker:
Conectores 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 Conectores do Greengrass fornecidos pela AWS. 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. Suas funções do Lambda definidas pelo usuário executadas no contêiner do Docker devem acessar dispositivos e volumes diretamente no núcleo.
Configurar a imagem do Docker fornecida pelo AWS IoT Greengrass
Siga estas etapas a fim de configurar a imagem do Docker do AWS IoT Greengrass 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.
-
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 permissão
ecr:GetAuthorizationTokenpor meio de uma política do IAM AWS Identity and Access Management antes que possam fazer a autenticação para 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 e Acessando um repositório do Amazon ECR no Guia do usuário do Amazon Elastic Container Registry.
-
Faça download da imagem do Docker e configure o contêiner. Você pode fazer download da imagem pré-criada no Hub do Docker
ou no Amazon Elastic Container Registry (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 a imagem de contêiner do AWS IoT Greengrass do Amazon ECR. Depois, retorne a este tópico para continuar a configuração.
-
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
na documentação do Docker. -
Para executar o contêiner do AWS IoT Greengrass, use o comando para seu sistema operacional:
Importante
Ao testar com o IDT, não inclua o argumento
--entrypoint /greengrass-entrypoint.sh \usado para executar a imagem para uso geral do AWS IoT Greengrass. -
Próxima etapa: configure as credenciais da AWS e o arquivo device.json.
Configurar o arquivo do Docker fornecido pelo AWS IoT Greengrass
Siga estas etapas a fim de configurar a imagem do Docker criada com o arquivo do Docker do AWS IoT Greengrass para executar testes de IDT.
Em AWS IoT Greengrass Software Docker, faça download do pacote do arquivo do Docker para o computador host e extraia-o.
Aberto
README.md. As próximas três etapas se referem a seções desse arquivo.Verifique se você atende aos requisitos na seção Pré-requisitos.
Somente usuários do Linux: conclua as etapas Habilitar as proteções symlink e hardlink e Habilitar o encaminhamento da rede IPv4.
Para criar a imagem do Docker, conclua todas as etapas na Etapa 1. Crie a imagem do Docker AWS IoT Greengrass. Depois, retorne a este tópico para continuar a configuração.
-
Para executar o contêiner do AWS IoT Greengrass, use o comando para seu sistema operacional:
Importante
Ao testar com o IDT, não inclua o argumento
--entrypoint /greengrass-entrypoint.sh \usado para executar a imagem para uso geral do AWS IoT Greengrass. -
Próxima etapa: configure as credenciais da AWS e o arquivo device.json.
Solucionar problemas da configuração do contêiner do Docker para o IDT do AWS IoT Greengrass
Use as informações a seguir para ajudar a solucionar problemas comuns com a execução de um contêiner do Docker para o IDT de testes do 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 <user> no comando a seguir pelo usuário que executa o IDT.
sudo chown<user>:<user>/home/<user>/.docker -R sudo chmod g+rwx /home/<user>/.docker -R
