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á.
Execute o software AWS IoT Greengrass Core em um contêiner do Docker
O AWS IoT Greengrass pode ser configurado para ser executado em um contêiner do Docker. O Docker é uma plataforma que fornece as ferramentas para criar, executar, testar e implantar aplicações baseadas em contêineres do Linux. Ao executar uma imagem do Docker do AWS IoT Greengrass, você pode escolher se deseja fornecer suas credenciais da AWS ao contêiner do Docker e permitir que o instalador do software AWS IoT Greengrass Core provisione automaticamente os recursos da AWS que um dispositivo principal do Greengrass requer para operar. Se você não quiser fornecer credenciais da AWS, poderá provisionar recursos da AWS manualmente e executar o software AWS IoT Greengrass Core no contêiner do Docker.
Tópicos
Plataformas compatíveis e requisitos
Os computadores host devem atender aos seguintes requisitos mínimos para instalar e executar o software AWS IoT Greengrass Core em um contêiner do Docker:
-
Sistema operacional baseado em Linux com conexão à Internet.
-
Docker Engine
, versão 18.09 ou posterior. -
(Opcional) Docker Compose
versão 1.22 ou posterior. O Docker Compose é necessário somente se você quiser usar a CLI do Docker Compose para executar suas imagens do Docker.
Para executar componentes da função do Lambda dentro do contêiner Docker, você deve configurar o contêiner para atender aos requisitos adicionais. Para obter mais informações, consulte Requisitos da função do Lambda.
Execute componentes no modo de processo
O AWS IoT Greengrass não oferece suporte à execução de funções do Lambda ou componentes fornecidos pela AWS em um ambiente de runtime isolado dentro do contêiner do Docker do AWS IoT Greengrass. Você deve executar esses componentes no modo de processo sem nenhum isolamento.
Ao configurar um componente da função do Lambda, defina o modo de isolamento como Sem contêiner. Para obter mais informações, consulte Executar funções AWS Lambda..
Ao implantar qualquer um dos componentes fornecidos pela AWS a seguir, atualize a configuração de cada componente para definir o parâmetro containerMode como NoContainer. Para obter mais informações sobre atualizações de configuração, consulte Atualizar configurações do componente.
Downloads do software Docker do AWS IoT Greengrass
O AWS IoT Greengrass fornece um Dockerfile para criar uma imagem de contêiner que tenha o software AWS IoT Greengrass Core e as dependências instaladas em uma imagem base do Amazon Linux 2 (x86_64). Você pode modificar a imagem base no Dockerfile para executar o AWS IoT Greengrass em uma arquitetura de plataforma diferente.
Baixe o pacote Dockerfile do GitHub
O Dockerfile usa uma versão mais antiga do Greengrass. Você deve atualizar o arquivo para usar a versão do Greengrass que você deseja. Para obter informações sobre como criar a imagem do contêiner do AWS IoT Greengrass a partir do Dockerfile, consulte Criar a imagem de contêiner do AWS IoT Greengrass a partir de um Dockerfile.
Escolher como provisionar recursos da AWS
Ao instalar o software AWS IoT Greengrass Core em um contêiner do Docker, você pode escolher se deseja provisionar automaticamente os recursos da AWS que um dispositivo principal do Greengrass requer para operar ou usar os recursos que você provisiona manualmente.
-
Provisionamento automático de recursos: o instalador provisiona a coisa do AWS IoT, o grupo de coisas do AWS IoT, o perfil do IAM e o alias do perfil do AWS IoT quando você executa a imagem do contêiner do AWS IoT Greengrass pela primeira vez. O instalador também pode implantar as ferramentas de desenvolvimento local no dispositivo principal, para que você possa usar o dispositivo para desenvolver e testar componentes de software personalizados. Para provisionar automaticamente esses recursos, você deve fornecer credenciais da AWS como variáveis de ambiente para a imagem do Docker.
Para usar o provisionamento automático, você deve definir a variável de ambiente
PROVISION=truedo Docker e montar um arquivo de credencial para fornecer suas credenciais da AWS ao contêiner. -
Provisionamento manual de recursos: se você não quiser fornecer credenciais da AWS ao contêiner, poderá provisionar manualmente os recursos da AWS antes de executar a imagem do contêiner do AWS IoT Greengrass. Você deve criar um arquivo de configuração para fornecer informações sobre esses recursos ao instalador do software AWS IoT Greengrass Core dentro do contêiner do Docker.
Para usar o provisionamento manual, você deve definir a variável de ambiente
PROVISION=falsedo Docker. O aprovisionamento manual é a opção padrão.
Para obter mais informações, consulte Criar a imagem de contêiner do AWS IoT Greengrass a partir de um Dockerfile.
