Configurando dispositivos AWS IoT Greengrass principais - AWS IoT Greengrass

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á.

Configurando dispositivos AWS IoT Greengrass principais

Conclua as tarefas nesta seção para instalar, configurar e executar o software AWS IoT Greengrass principal.

nota

Esta seção descreve a instalação e a configuração avançadas do software AWS IoT Greengrass Core. Se você é usuário iniciante do AWS IoT Greengrass V2, recomendamos que primeiro conclua o tutorial de introdução 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 atender aos seguintes requisitos para instalar e executar o software AWS IoT Greengrass Core.

dica

Você pode pesquisar dispositivos qualificados AWS IoT Greengrass V2 no Catálogo de dispositivos do AWS parceiro.

Plataformas compatíveis

AWS IoT Greengrass suporta oficialmente dispositivos que executam as seguintes plataformas. Dispositivos com plataformas não incluídas nessa lista podem funcionar, mas AWS IoT Greengrass testes somente nessas 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 AWS IoT Greengrass recursos não são compatíveis com dispositivos Windows. Para obter mais informações, consulte Compatibilidade de recursos do Greengrass por sistema operacional e Considerações sobre recursos para dispositivos Windows.

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

Para criar um sistema operacional personalizado baseado em Linux, você pode usar a BitBake receita AWS IoT Greengrass V2 do projeto. meta-aws O meta-aws projeto fornece receitas que você pode usar para criar recursos de software de AWS ponta em sistemas Linux embarcados que são construídos com OpenEmbeddedas estruturas de construção do Projeto Yocto. O Projeto Yocto é um projeto de colaboração de código aberto que ajuda você a criar sistemas personalizados baseados em Linux para aplicativos embarcados, independentemente da arquitetura de hardware. A BitBake receita para AWS IoT Greengrass V2 instalar, configurar e executar automaticamente o software AWS IoT Greengrass Core em seu dispositivo.

Requisitos do dispositivo

Os dispositivos devem atender aos seguintes requisitos para instalar e executar o software AWS IoT Greengrass Core v2.x.

nota

Você pode usar AWS IoT Device Tester for AWS IoT Greengrass para verificar se seu dispositivo pode executar o software AWS IoT Greengrass Core e se comunicar com Nuvem AWS o. Para ter mais informações, consulte Usando AWS IoT Device Tester para AWS IoT Greengrass V2.

Linux
  • O uso de um Região da AWSque suporte 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.

  • Espaço mínimo de 256 MB em disco disponível para o software AWS IoT Greengrass Core. Esse requisito não inclui componentes implantados no dispositivo principal.

  • Mínimo de 96 MB de RAM alocados para o software AWS IoT Greengrass Core. Esse requisito não inclui componentes que são executados no dispositivo principal. Para ter mais informações, consulte Controle a alocação de memória com opções JVM.

  • Java Runtime Environment (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. É necessária a versão 8 ou superior.

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

  • Você deve executar o software AWS IoT Greengrass Core como usuário root. Usesudo, por exemplo.

  • O usuário root que executa o software AWS IoT Greengrass Core, por exemploroot, deve ter permissão para executar sudo com qualquer usuário e qualquer grupo. O /etc/sudoers arquivo deve dar permissão a esse usuário para ser executado sudo como outros grupos. A permissão para o usuário entrar /etc/sudoers deve ser semelhante ao exemplo a seguir.

    root ALL=(ALL:ALL) ALL
  • O dispositivo principal deve ser capaz de realizar solicitações de saída para um conjunto de terminais e portas. Para ter mais informações, consulte Permitir o tráfego de dispositivos por meio de um proxy ou firewall.

  • O /tmp diretório deve ser montado com exec permissões.

  • 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 AWS IoT Greengrass principal como um serviço do sistema.

    • (Opcional) useraddgroupadd, usermod e. Esses comandos são usados para configurar o ggc_user usuário 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, seu dispositivo deve executar a versão 2.6.24 ou posterior do kernel Linux.

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

Windows
  • O uso de um Região da AWSque suporte 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.

  • Espaço mínimo de 256 MB em disco disponível para o software AWS IoT Greengrass Core. Esse requisito não inclui componentes implantados no dispositivo principal.

  • Mínimo de 160 MB de RAM alocados para o software AWS IoT Greengrass Core. Esse requisito não inclui componentes que são executados no dispositivo principal. Para ter mais informações, consulte Controle a alocação de memória com opções JVM.

  • Java Runtime Environment (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. É necessária a versão 8 ou superior.

    nota

    Para usar a versão 2.5.0 do núcleo Greengrass, você deve usar uma versão de 64 bits do Java Runtime Environment (JRE). A versão 2.5.1 do Greengrass nucleus oferece suporte a JREs de 32 e 64 bits.

  • O usuário que instala o software AWS IoT Greengrass Core deve ser um administrador.

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

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

  • O dispositivo principal deve ser capaz de realizar solicitações de saída para um conjunto de terminais 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

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

  • Um sistema operacional baseado em Linux.

  • Seu dispositivo deve ter o comando mkfifo shell.

  • Seu dispositivo deve executar as bibliotecas de linguagem de programação exigidas por uma função Lambda. Você deve instalar as bibliotecas necessárias no dispositivo e adicioná-las à variável de PATH ambiente. O Greengrass é compatível com todas as versões compatíveis com o Lambda dos tempos de execução Python, Node.js e Java. O Greengrass não aplica nenhuma restrição adicional às versões obsoletas de tempo de execução do Lambda. Para obter mais informações sobre o AWS IoT Greengrass suporte para tempos de execução do Lambda, consulte. Executar AWS Lambda funções

  • Para executar funções Lambda em contêineres, seu dispositivo deve atender aos seguintes requisitos:

    • Kernel Linux versão 4.4 ou posterior.

    • O kernel deve suportar cgroups v1, e você deve habilitar e montar os seguintes cgroups:

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

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

      O software AWS IoT Greengrass Core não é compatível com cgroups v2.

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

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

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

    • Você deve habilitar as seguintes configurações do kernel 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 da sua distribuição Linux para saber como verificar e definir os parâmetros do kernel Linux. Você também pode usar AWS IoT Device Tester for AWS IoT Greengrass para verificar se seu dispositivo atende a esses requisitos. Para ter mais informações, consulte Usando AWS IoT Device Tester para AWS IoT Greengrass V2.

Considerações sobre recursos para dispositivos Windows

No momento, alguns AWS IoT Greengrass recursos não são compatíveis com dispositivos Windows. Analise as diferenças de 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 um Conta da AWS

Se você não tiver um Conta da AWS, conclua as etapas a seguir para criar um.

Para se inscrever em um Conta da AWS
  1. Abra https://portal.aws.amazon.com/billing/signup.

  2. Siga as instruções on-line.

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

    Quando você se inscreve em um Conta da AWS, um Usuário raiz da conta da AWSé criado. O usuário-raiz tem acesso a todos os AWS services e recursos na conta. Como uma prática recomendada de segurança, atribua o acesso administrativo para um usuário e use somente o usuário-raiz para executar tarefas que requerem o 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 . Configure o acesso programático configurando o AWS CLI para uso AWS IAM Identity Center no Guia do AWS Command Line Interface usuário.
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.