Etapa 2: configurar seu ambiente - 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á.

Etapa 2: configurar seu ambiente

Siga as etapas nesta seção para configurar um dispositivo Linux ou Windows para ser usado como seu dispositivo AWS IoT Greengrass principal.

Essas etapas pressupõem que você use um Raspberry Pi com o sistema operacional Raspberry Pi. Se você usa um dispositivo ou sistema operacional diferente, consulte a documentação relevante do seu dispositivo.

Para configurar um Raspberry Pi para AWS IoT Greengrass V2

  1. Ative o SSH no seu Raspberry Pi para se conectar remotamente a ele. Para obter mais informações, consulte SSH (Secure shell) na documentação do Raspberry Pi.

  2. Encontre o endereço IP do seu Raspberry Pi para se conectar a ele com SSH. Para fazer isso, você pode executar o seguinte comando no seu Raspberry Pi.

    hostname -I

  3. Conecte-se ao seu Raspberry Pi com SSH.

    No seu computador de desenvolvimento, execute o comando a seguir. Substitua o nome de usuário pelo nome do usuário a ser conectado e pi-ip-addresssubstitua pelo endereço IP que você encontrou na etapa anterior.

    ssh username@pi-ip-address
    Importante

    Se o seu computador de desenvolvimento usa uma versão anterior do Windows, talvez você não tenha o ssh comando ou talvez tenha, ssh mas não consiga se conectar ao seu Raspberry Pi. Para se conectar ao seu Raspberry Pi, você pode instalar e configurar o PuTTY, que é um cliente SSH de código aberto e gratuito. Consulte a documentação do PuTTY para se conectar ao seu Raspberry Pi.

  4. Instale o Java Runtime, que o software AWS IoT Greengrass Core exige para ser executado. No seu Raspberry Pi, use os seguintes comandos para instalar o Java 11.

    sudo apt install default-jdk

    Quando a instalação for concluída, execute o comando a seguir para verificar se o Java é executado no seu Raspberry Pi.

    java -version

    O comando imprime a versão do Java que é executada no dispositivo. A saída pode ser semelhante ao exemplo a seguir.

    openjdk version "11.0.9.1" 2020-11-04
OpenJDK Runtime Environment (build 11.0.9.1+1-post-Debian-1deb10u2)
OpenJDK 64-Bit Server VM (build 11.0.9.1+1-post-Debian-1deb10u2, mixed mode)
Dica: defina os parâmetros do kernel em um Raspberry Pi

Se o seu dispositivo for um Raspberry Pi, você poderá concluir as etapas a seguir para visualizar e atualizar os parâmetros do kernel Linux:

  1. Abra o arquivo /boot/cmdline.txt. Esse arquivo especifica os parâmetros do kernel Linux a serem aplicados quando o Raspberry Pi for inicializado.

    Por exemplo, em um sistema baseado em Linux, você pode executar o seguinte comando para usar o GNU nano para abrir o arquivo.

    sudo nano /boot/cmdline.txt

  2. Verifique se o /boot/cmdline.txt arquivo contém os seguintes parâmetros do kernel. O systemd.unified_cgroup_hierarchy=0 parâmetro especifica o uso de cgroups v1 em vez de cgroups v2.

    cgroup_enable=memory cgroup_memory=1 systemd.unified_cgroup_hierarchy=0

    Se o /boot/cmdline.txt arquivo não contiver esses parâmetros ou contiver esses parâmetros com valores diferentes, atualize o arquivo para conter esses parâmetros e valores.

  3. Se você atualizou o /boot/cmdline.txt arquivo, reinicie o Raspberry Pi para aplicar as alterações.

    sudo reboot
Para configurar um dispositivo Linux para AWS IoT Greengrass V2

  1. Instale o Java Runtime, que o software AWS IoT Greengrass Core exige para ser executado. 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. Os comandos a seguir mostram como instalar o OpenJDK no seu dispositivo.

    • Para distribuições com base em Debian ou em Ubuntu:

      sudo apt install default-jdk

    • Para distribuições com base em Red Hat:

      sudo yum install java-11-openjdk-devel

    • Para Amazon Linux 2:

      sudo amazon-linux-extras install java-openjdk11

    • Para Amazon Linux 2023:

      sudo dnf install java-11-amazon-corretto -y

    Quando a instalação for concluída, execute o comando a seguir para verificar se o Java é executado no seu dispositivo Linux.

    java -version

    O comando imprime a versão do Java que é executada no dispositivo. Por exemplo, em uma distribuição baseada em Debian, o resultado pode ser semelhante ao exemplo a seguir.

    openjdk version "11.0.9.1" 2020-11-04
OpenJDK Runtime Environment (build 11.0.9.1+1-post-Debian-1deb10u2)
OpenJDK 64-Bit Server VM (build 11.0.9.1+1-post-Debian-1deb10u2, mixed mode)

  2. (Opcional) Crie o usuário e o grupo padrão do sistema que executa componentes no dispositivo. Você também pode optar por permitir que o instalador do software AWS IoT Greengrass Core crie esse usuário e grupo durante a instalação com o argumento do --component-default-user instalador. Para ter mais informações, consulte Argumentos de instalação.

    sudo useradd --system --create-home ggc_user
sudo groupadd --system ggc_group

  3. Verifique se o usuário que executa o software AWS IoT Greengrass Core (normalmenteroot) tem permissão para executar sudo com qualquer usuário e qualquer grupo.

    1. Execute o comando a seguir para abrir o /etc/sudoers arquivo.

      sudo visudo

    2. Verifique se a permissão para o usuário se parece com o exemplo a seguir.

      root    ALL=(ALL:ALL) ALL

  4. (Opcional) Para executar funções Lambda em contêineres, você deve habilitar cgroups v1 e habilitar e montar os cgroups de memória e dispositivos. Se você não planeja executar funções Lambda em contêineres, pode pular esta etapa.

    Para habilitar essas opções de cgroups, inicialize o dispositivo com os seguintes parâmetros do kernel Linux.

    cgroup_enable=memory cgroup_memory=1 systemd.unified_cgroup_hierarchy=0

    Para obter informações sobre como visualizar e definir os parâmetros do kernel para seu dispositivo, consulte a documentação do sistema operacional e do carregador de inicialização. Siga as instruções para definir permanentemente os parâmetros do kernel.

  5. Instale todas as outras dependências necessárias em seu dispositivo, conforme indicado na lista de requisitos emRequisitos do dispositivo.

Para configurar um dispositivo Windows para AWS IoT Greengrass V2

  1. Instale o Java Runtime, que o software AWS IoT Greengrass Core exige para ser executado. 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.

  2. Verifique se o Java está disponível na variável de sistema PATH e, caso contrário, adicione-a. A LocalSystem conta executa o software AWS IoT Greengrass Core, então você deve adicionar Java à variável de sistema PATH em vez da variável de usuário PATH para seu usuário. Faça o seguinte:

    1. Pressione a tecla Windows para abrir o menu Iniciar.

    2. Digite environment variables para pesquisar as opções do sistema no menu Iniciar.

    3. Nos resultados da pesquisa do menu Iniciar, escolha Editar as variáveis de ambiente do sistema para abrir a janela Propriedades do sistema.

    4. Escolha variáveis de ambiente... para abrir a janela Variáveis de ambiente.

    5. Em Variáveis do sistema, selecione Caminho e, em seguida, escolha Editar. Na janela Editar variável de ambiente, você pode visualizar cada caminho em uma linha separada.

    6. Verifique se o caminho para a bin pasta da instalação do Java está presente. O caminho pode ser semelhante ao exemplo a seguir.

      C:\\Program Files\\Amazon Corretto\\jdk11.0.13_8\\bin

    7. Se a bin pasta da instalação do Java estiver ausente do Path, escolha Novo para adicioná-la e, em seguida, escolha OK.

  3. Abra o prompt de comando do Windows (cmd.exe) como administrador.

  4. Crie o usuário padrão na LocalSystem conta no dispositivo Windows. Substitua a senha por uma senha segura.

    net user /add ggc_user password
    dica

    Dependendo da configuração do Windows, a senha do usuário pode ser definida para expirar em uma data futura. Para garantir que seus aplicativos Greengrass continuem operando, monitore quando a senha expira e atualize-a antes que ela expire. Você também pode definir a senha do usuário para nunca expirar.

    • Para verificar quando um usuário e sua senha expiram, execute o comando a seguir.

      net user ggc_user | findstr /C:expires

    • Para definir que a senha de um usuário nunca expire, execute o comando a seguir.

      wmic UserAccount where "Name='ggc_user'" set PasswordExpires=False

    • Se você estiver usando o Windows 10 ou posterior, onde o wmiccomando está obsoleto, execute o comando a seguir. PowerShell 

      Get-CimInstance -Query "SELECT * from Win32_UserAccount WHERE name = 'ggc_user'" | Set-CimInstance -Property @{PasswordExpires="False"}

  5. Baixe e instale o PsExecutilitário da Microsoft no dispositivo.

  6. Use o PsExec utilitário para armazenar o nome de usuário e a senha do usuário padrão na instância do Credential Manager da LocalSystem conta. Substitua a senha pela senha do usuário que você definiu anteriormente.

    psexec -s cmd /c cmdkey /generic:ggc_user /user:ggc_user /pass:password

    Se for PsExec License Agreementaberto, opte por Acceptconcordar com a licença e execute o comando.

    nota

    Em dispositivos Windows, a LocalSystem conta executa o núcleo Greengrass, e você deve usar o PsExec utilitário para armazenar as informações padrão do usuário na conta. LocalSystem O uso do aplicativo Credential Manager armazena essas informações na conta do Windows do usuário atualmente conectado, em vez da LocalSystem conta.