Como configurar dispositivos principais do AWS IoT Greengrass - AWS IoT Greengrass
Plataformas compatíveis e requisitosConsiderações sobre recursos para dispositivos WindowsConfigurar uma Conta da AWS

Como configurar dispositivos principais do AWS IoT Greengrass

Conclua as tarefas desta seção para instalar, configurar e executar o software de núcleo do AWS IoT Greengrass.

nota

Esta seção descreve a instalação e a configuração avançadas do software de núcleo do AWS IoT Greengrass. Se você é usuário novo no AWS IoT Greengrass V2, recomendamos concluir primeiro o Tutorial de conceitos básicos para configurar um dispositivo principal e explorar os recursos do AWS IoT Greengrass.

Plataformas compatíveis e requisitos

Antes de começar, certifique-se de que você atenda aos seguintes requisitos para instalar e executar o software de núcleo do AWS IoT Greengrass.

dica

Você pode pesquisar os dispositivos que são qualificados para o AWS IoT Greengrass V2 no AWS Partner Device Catalog.

Plataformas compatíveis

O AWS IoT Greengrass oferece suporte oficial aos dispositivos com as plataformas a seguir. Os dispositivos com plataformas que não estão incluídas nessa lista podem funcionar, mas os testes do AWS IoT Greengrass foram realizados somente nas plataformas especificadas.

Linux

Arquiteturas:

  • Armv7l

  • Armv8 (AArch64)

  • x86_64

Windows

Arquiteturas:

  • x86_64

Versões:

  • Windows 10

  • Windows 11

  • Windows Server 2019

  • Windows Server 2022

nota

No momento, alguns recursos do AWS IoT Greengrass não são compatíveis com dispositivos Windows. Para ter mais informações, consulte Compatibilidade de recursos do Greengrass por sistema operacional e Considerações sobre recursos para dispositivos Windows.

As plataformas Windows também podem executar o AWS IoT Greengrass V2 em um contêiner do Docker. Para ter mais informações, consulte Execute o software AWS IoT Greengrass Core em um contêiner do Docker.

Para criar um sistema operacional personalizado baseado em Linux, você pode usar a fórmula do BitBake para AWS IoT Greengrass V2 no projeto meta-aws. O projeto meta-aws fornece fórmulas que você pode usar para criar recursos de software de borda da AWS em sistemas Linux incorporados, que são desenvolvidos com as estruturas de construção OpenEmbedded e Yocto Project. O Yocto Project é um projeto de colaboração de código aberto que ajuda você a construir sistemas personalizados baseados em Linux para aplicações incorporadas, seja qual for a arquitetura do hardware. A fórmula do Bitbake para AWS IoT Greengrass V2 instala, configura e executa automaticamente o software de núcleo do AWS IoT Greengrass em seu dispositivo.

Requisitos do dispositivo

Os dispositivos devem atender aos requisitos a seguir para instalar e executar o software de núcleo do AWS IoT Greengrass versão 2.x.

nota

Você pode usar o AWS IoT Device Tester para AWS IoT Greengrass para verificar se o dispositivo pode executar o software de núcleo do AWS IoT Greengrass e se comunicar com a Nuvem AWS. Para ter mais informações, consulte Como usar o AWS IoT Device Tester para o AWS IoT Greengrass V2.

Linux

  • O uso de uma Região da AWS que ofereça suporte ao AWS IoT Greengrass V2. Para obter a lista de regiões compatíveis, consulte Endpoints e cotas do AWS IoT Greengrass V2 no Referência geral da AWS.

  • Mínimo de 256 MB de espaço em disco disponível para o software de núcleo do AWS IoT Greengrass. Esse requisito não inclui os componentes implantados no dispositivo principal.

  • No mínimo, 96 MB de RAM alocados para o software de núcleo do AWS IoT Greengrass. Esse requisito não inclui os componentes executados no dispositivo principal. Para ter mais informações, consulte Controlar a alocação de memória com opções de JVM.

  • Ambiente de Execução Java (JRE) versão 8 ou superior. O Java deve estar disponível na variável de ambiente PATH no dispositivo. Para usar o Java para desenvolver componentes personalizados, é necessário instalar um Java Development Kit (JDK). Recomendamos que você use as versões de suporte de longo prazo do Amazon Corretto ou do OpenJDK. A versão 8 ou superior é obrigatória.

  • Biblioteca do GNU C (glibc) versão 2.25 ou superior.

  • Você deve executar o software de núcleo do AWS IoT Greengrass como usuário-raiz. Por exemplo, use o sudo.

  • O usuário-raiz que executa o software de núcleo do AWS IoT Greengrass, por exemplo root, deve ter permissão para executar o sudo com qualquer usuário e grupo. O arquivo /etc/sudoers deve dar permissão a esse usuário para executar o sudo como outros grupos. A permissão para o usuário em /etc/sudoers deve ser semelhante à do exemplo a seguir.

    root    ALL=(ALL:ALL) ALL

  • O dispositivo principal deve conseguir fazer solicitações de saída para um conjunto de endpoints e portas. Para ter mais informações, consulte Permitir o tráfego de dispositivos por meio de um proxy ou firewall.

  • É necessário montar o diretório /tmp com as permissões exec.

  • Todos os seguintes comandos de shell:

    • ps -ax -o pid,ppid

    • sudo

    • sh

    • kill

    • cp

    • chmod

    • rm

    • ln

    • echo

    • exit

    • id

    • uname

    • grep

  • Seu dispositivo também pode exigir os seguintes comandos de shell opcionais:

    • (Opcional) systemctl. Esse comando é usado para configurar o software de núcleo do AWS IoT Greengrass como um serviço do sistema.

    • (Opcional) useradd, groupadd e usermod. Esses comandos são usados para configurar o usuário ggc_user e o grupo ggc_group do sistema.

    • (Opcional) mkfifo. Esse comando é usado para executar funções do Lambda como componentes.

  • Para configurar os limites de recursos do sistema para processos de componentes, o dispositivo deve executar o kernel do Linux versão 2.6.24 ou mais recente.

  • Para executar as funções do Lambda, o dispositivo deve atender a requisitos adicionais. Para ter mais informações, consulte Requisitos da função do Lambda.

Windows

  • O uso de uma Região da AWS que ofereça suporte ao AWS IoT Greengrass V2. Para obter a lista de regiões compatíveis, consulte Endpoints e cotas do AWS IoT Greengrass V2 no Referência geral da AWS.

  • Mínimo de 256 MB de espaço em disco disponível para o software de núcleo do AWS IoT Greengrass. Esse requisito não inclui os componentes implantados no dispositivo principal.

  • No mínimo, 160 MB de RAM alocados para o software de núcleo do AWS IoT Greengrass. Esse requisito não inclui os componentes executados no dispositivo principal. Para ter mais informações, consulte Controlar a alocação de memória com opções de JVM.

  • Ambiente de Execução Java (JRE) versão 8 ou superior. O Java deve estar disponível na variável de sistema PATH no dispositivo. Para usar o Java para desenvolver componentes personalizados, é necessário instalar um Java Development Kit (JDK). Recomendamos que você use as versões de suporte de longo prazo do Amazon Corretto ou do OpenJDK. A versão 8 ou superior é obrigatória.

    nota

    Para usar a versão 2.5.0 do núcleo do Greengrass, você deve usar uma versão de 64 bits do Ambiente de Execução Java (JRE). O núcleo do Greengrass versão 2.5.1 é compatível com JREs de 32 e 64 bits.

  • O usuário que instala o software de núcleo do AWS IoT Greengrass deve ser administrador.

  • Você deve instalar o software de núcleo do AWS IoT Greengrass como um serviço do sistema. Especifique --setup-system-service true quando você instalar o software.

  • Cada usuário que executa processos de componentes deve existir na conta LocalSystem, e o nome e a senha do usuário devem estar na instância do Credential Manager da conta LocalSystem. Você pode configurar esse usuário seguindo as instruções para instalar o software de núcleo do AWS IoT Greengrass.

  • O dispositivo principal deve conseguir fazer solicitações de saída para um conjunto de endpoints e portas. Para ter mais informações, consulte Permitir o tráfego de dispositivos por meio de um proxy ou firewall.

Requisitos da função do Lambda

O dispositivo deve atender aos seguintes requisitos para executar funções do Lambda:

  • Um sistema operacional baseado em Linux.

  • O dispositivo deve ter o comando de shell mkfifo.

  • O dispositivo deve executar as bibliotecas de linguagem de programação obrigatórias para uma função do Lambda. Você deve instalar as bibliotecas obrigatórias no dispositivo e adicioná-las à variável de ambiente PATH. O Greengrass oferece suporte a todas as versões compatíveis com o Lambda dos runtimes Python, Node.js e Java. O Greengrass não impõe nenhuma outra restrição às versões de runtime obsoletas do Lambda. Para obter mais informações sobre compatibilidade da AWS IoT Greengrass com runtime do Lambda, consulte Executar funções AWS Lambda..

  • Para executar funções do Lambda em contêiner, o dispositivo deve atender aos seguintes requisitos:

    • Kernel Linux versão 4.4 ou posterior.

    • O kernel deve ser compatível com cgroups v1, e você deve habilitar e montar os seguintes cgroups:

      • O cgroup de memória para AWS IoT Greengrass para definir o limite de memória para funções do Lambda em contêiner.

      • O cgroup de dispositivos para funções do Lambda em contêiner para acessar dispositivos ou volumes do sistema.

      O software de núcleo do AWS IoT Greengrass não é compatível com cgroups v2.

      Para atender a esse requisito, inicialize o dispositivo com os parâmetros do kernel do Linux a seguir.

      cgroup_enable=memory cgroup_memory=1 systemd.unified_cgroup_hierarchy=0
      dica

      Em um Raspberry Pi, edite o arquivo /boot/cmdline.txt para definir os parâmetros do kernel do dispositivo.

    • Você deve habilitar as seguintes configurações do kernel do Linux no dispositivo:

      • Namespace:

        • CONFIG_IPC_NS

        • CONFIG_UTS_NS

        • CONFIG_USER_NS

        • CONFIG_PID_NS

      • Cgroups:

        • CONFIG_CGROUP_DEVICE

        • CONFIG_CGROUPS

        • CONFIG_MEMCG

      • Outros:

        • CONFIG_POSIX_MQUEUE

        • CONFIG_OVERLAY_FS

        • CONFIG_HAVE_ARCH_SECCOMP_FILTER

        • CONFIG_SECCOMP_FILTER

        • CONFIG_KEYS

        • CONFIG_SECCOMP

        • CONFIG_SHMEM

      dica

      Consulte a documentação referente à sua distribuição Linux para saber como verificar e definir parâmetros do kernel do Linux. Você também pode usar o AWS IoT Device Tester para AWS IoT Greengrass para verificar se o seu dispositivo atende a esses requisitos. Para ter mais informações, consulte Como usar o AWS IoT Device Tester para o AWS IoT Greengrass V2.

Considerações sobre recursos para dispositivos Windows

No momento, alguns recursos do AWS IoT Greengrass não são compatíveis com dispositivos Windows. Avalie as diferenças dos recursos para confirmar se um dispositivo Windows atende aos seus requisitos. Para ter mais informações, consulte Compatibilidade de recursos do Greengrass por sistema operacional.

Configurar uma Conta da AWS

Se você ainda não tem Conta da AWS, siga as etapas a seguir para criar um.

Para se cadastrar em uma Conta da AWS

  1. Abra https://portal.aws.amazon.com/billing/signup.

  2. Siga as instruções online.

    Parte do procedimento de inscrição envolve receber uma chamada telefônica e inserir um código de verificação no teclado do telefone.

    Quando você se cadastra em uma Conta da AWS, um Usuário raiz da conta da AWS é criado. O usuário raiz tem acesso a todos os Serviços da AWS e atributos na conta. Como prática recomendada de segurança, atribua o acesso administrativo a um usuário e use somente o usuário-raiz para executar tarefas que exigem acesso de usuário-raiz.

Para criar um usuário administrador, selecione uma das opções a seguir.

Selecionar uma forma de gerenciar o administrador Para Por Você também pode
Centro de Identidade do IAM

(Recomendado)

 Use credenciais de curto prazo para acessar a AWS.

Isso está de acordo com as práticas recomendadas de segurança. Para obter informações sobre as práticas recomendadas, consulte Práticas recomendadas de segurança no IAM no Guia do usuário do IAM.

 Seguindo as instruções em Conceitos básicos no Guia do usuário do AWS IAM Identity Center. Para configurar o acesso programático, consulte Configurar a AWS CLI para usar o AWS IAM Identity Center no Guia do usuário do AWS Command Line Interface.
No IAM

(Não recomendado)

 Use credenciais de curto prazo para acessar a AWS. Seguindo as instruções em Criar o seu primeiro usuário administrador e um grupo de usuários do IAM no Guia do usuário do IAM. Para configurar o acesso programático, consulte Gerenciamento de chaves de acesso de usuários do IAM no Guia do usuário do IAM.