Execute AWS IoT Greengrass o software Core em um contêiner Docker - AWS IoT Greengrass
Plataformas compatíveis e requisitosDownloads de softwareEscolha como provisionar AWS recursos

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 AWS IoT Greengrass o software Core em um contêiner Docker

AWS IoT Greengrass pode ser configurado para ser executado em um contêiner Docker. O Docker é uma plataforma que fornece as ferramentas para você criar, executar, testar e implantar aplicativos baseados em contêineres Linux. Ao executar uma imagem do AWS IoT Greengrass Docker, você pode escolher se deseja fornecer suas AWS credenciais ao contêiner do Docker e permitir que o instalador do software AWS IoT Greengrass Core provisione automaticamente os AWS recursos que um dispositivo principal do Greengrass requer para operar. Se você não quiser fornecer AWS credenciais, poderá provisionar AWS recursos 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 Docker:

  • Um 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 Lambda dentro do contêiner Docker, você deve configurar o contêiner para atender aos requisitos adicionais. Para ter mais informações, consulte Requisitos da função do Lambda.

Execute componentes no modo de processo

AWS IoT Greengrass não suporta a execução de funções Lambda ou componentes AWS fornecidos pelo Lambda em um ambiente de tempo de execução isolado dentro do AWS IoT Greengrass contêiner Docker. Você deve executar esses componentes no modo de processo sem nenhum isolamento.

Ao configurar um componente da função Lambda, defina o modo de isolamento como Sem contêiner. Para ter mais informações, consulte Executar AWS Lambda funções.

Ao implantar qualquer um dos componentes AWS fornecidos a seguir, atualize a configuração de cada componente para definir o containerMode parâmetro como. NoContainer Para obter mais informações sobre atualizações de configuração, consulteAtualizar configurações de componentes.

AWS IoT Greengrass Downloads do software Docker

AWS IoT Greengrass fornece um Dockerfile para criar uma imagem de contêiner que tenha o software AWS IoT Greengrass principal e as dependências instaladas em uma imagem base do Amazon Linux 2 (x86_64). Você pode modificar a imagem base no Dockerfile para ser executada AWS IoT Greengrass em uma arquitetura de plataforma diferente.

Baixe o pacote Dockerfile em. 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 AWS IoT Greengrass contêiner a partir do Dockerfile, consulte. Crie a imagem do AWS IoT Greengrass contêiner a partir de um Dockerfile

Escolha como provisionar AWS recursos

Ao instalar o software AWS IoT Greengrass Core em um contêiner Docker, você pode escolher se deseja provisionar automaticamente os AWS recursos 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 AWS IoT AWS IoT coisa, o grupo de coisas, a função do IAM e o alias da AWS IoT função quando você executa a imagem do AWS IoT Greengrass contêiner 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 AWS credenciais como variáveis de ambiente para a imagem do Docker.

    Para usar o provisionamento automático, você deve definir a variável de ambiente do Docker PROVISION=true e montar um arquivo de credencial para fornecer suas AWS credenciais ao contêiner.

  • Provisionamento manual de recursos — se você não quiser fornecer AWS credenciais ao contêiner, poderá provisionar manualmente os AWS recursos antes de executar a imagem do contêiner. 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 Docker.

    Para usar o provisionamento manual, você deve definir a variável de ambiente Docker. PROVISION=false O provisionamento manual é a opção padrão.

Para ter mais informações, consulte Crie a imagem do AWS IoT Greengrass contêiner a partir de um Dockerfile.