

Aviso de fim do suporte: em 7 de outubro de 2026, AWS o suporte para o. AWS IoT Greengrass Version 1 Depois de 7 de outubro de 2026, você não poderá mais acessar os AWS IoT Greengrass V1 recursos. Para obter mais informações, visite [Migrar de AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html).

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

# Módulo 1: Configuração do ambiente para o Greengrass
<a name="module1"></a>

Este módulo mostra como preparar um out-of-the-box Raspberry Pi, uma EC2 instância da Amazon ou outro dispositivo para ser usado AWS IoT Greengrass como seu dispositivo AWS IoT Greengrass principal.

**dica**  
Ou, para usar um script que configure o dispositivo de núcleo para você, consulte [Início rápido: Configuração do dispositivo do Greengrass](quick-start.md).

Este módulo deve demorar menos de 30 minutos para ser concluído.

Antes de começar, leia os [requisitos](gg-gs.md#gg-requirements) para este tutorial. Depois, siga as instruções de configuração em um dos tópicos a seguir. Selecione apenas aquele que se aplica ao seu tipo de dispositivo de núcleo.

**Topics**
+ [Configurar um Raspberry Pi](setup-filter.rpi.md)
+ [Configurando uma EC2 instância da Amazon](setup-filter.ec2.md)
+ [Configurar outros dispositivos](setup-filter.other.md)

**nota**  
Para saber como usar a AWS IoT Greengrass execução em um contêiner Docker pré-construído, consulte. [Executando AWS IoT Greengrass em um contêiner Docker](run-gg-in-docker-container.md)

# Configurar um Raspberry Pi
<a name="setup-filter.rpi"></a>

Siga as etapas deste tópico para configurar um Raspberry Pi para usar como AWS IoT Greengrass núcleo.

**dica**  
<a name="ggc-install-options"></a>AWS IoT Greengrass também fornece outras opções para instalar o software AWS IoT Greengrass Core. Por exemplo, você pode usar a [configuração do dispositivo Greengrass](quick-start.md) para configurar seu ambiente e instalar a versão mais recente do software AWS IoT Greengrass Core. Ou, em plataformas Debian suportadas, você pode usar o [gerenciador de pacotes APT](install-ggc.md#ggc-package-manager) para instalar ou atualizar o software AWS IoT Greengrass Core. Para obter mais informações, consulte [Instale o software AWS IoT Greengrass Core](install-ggc.md).

Se você estiver configurando um Raspberry Pi pela primeira vez, siga todas estas etapas. Caso contrário, pule para o [passo 9](#add-ggc-user-ggc-group). No entanto, recomendamos que você crie uma nova imagem do seu Raspberry Pi com o sistema operacional, conforme recomendado na Etapa 2.

 

1. Faça download e instale um formatador de cartão SD, como o [Formatador de cartão de memória SD](https://www.sdcard.org/downloads/formatter/). Insira o cartão SD no seu computador. Inicie o programa e selecione a unidade em que você inseriu seu cartão SD. Você pode executar uma formatação rápida do cartão SD.

1. Faça download do sistema operacional [Raspbian Buster](https://downloads.raspberrypi.org/raspbian/images/raspbian-2020-02-14/) como um arquivo `zip`.

1. Usando uma ferramenta de gravação de cartão SD (como [Etcher](https://etcher.io/)), siga as instruções da ferramenta para instalar a imagem do arquivo `zip` obtido por download no cartão SD. Como a imagem do sistema operacional é grande, essa etapa deve levar algum tempo. Ejete seu cartão SD do computador e insira o cartão microSD no seu Raspberry Pi.

1. Durante a primeira inicialização, recomendamos que você conecte o Raspberry Pi a um monitor (por meio de HDMI), teclado e mouse. Em seguida, conecte seu Pi a uma fonte de energia micro USB e o sistema operacional Raspbian deverá ser iniciado. 

1. Você pode configurar o layout de teclado do Pi antes de continuar. Para fazer isso, clique no ícone Raspberry no canto superior direito, selecione **Preferences (Preferências)** e, em seguida, **Mouse and Keyboard Settings (Configurações de mouse e teclado)**. Depois, clique na guia **Keyboard (Teclado)**, **Keyboard Layout (Layout de teclado)** e, em seguida, selecione uma variante apropriada do teclado.

1. Em seguida, [conecte seu Raspberry Pi à Internet por meio de uma rede Wi-Fi](https://www.raspberrypi.org/documentation/configuration/wireless/desktop.md) ou com um cabo Ethernet.
**nota**  
Conecte seu Raspberry Pi à *mesma* rede que o seu computador está conectado, e certifique-se de que o computador e o Raspberry Pi tenham acesso à Internet antes de continuar. Se você estiver em um ambiente de trabalho ou atrás de um firewall, talvez seja necessário conectar o Pi e o computador à rede de convidado para colocar ambos os dispositivos na mesma rede. No entanto, essa abordagem pode desconectar o computador dos recursos da rede local, como sua intranet. Uma solução é conectar o Pi à rede Wi-Fi de convidado e conectar o computador à rede Wi-Fi de convidado *e* à rede local por meio de um cabo Ethernet. Com essa configuração, o computador deverá poder se conectar ao Raspberry PI por meio da rede Wi-Fi de convidado e a seus recursos de rede local por meio do cabo Ethernet.

1. Você deve configurar o [SSH](https://en.wikipedia.org/wiki/Secure_Shell) no seu Pi para se conectar remotamente a ele. No Raspberry Pi, abra uma [janela de terminal](https://www.raspberrypi.org/documentation/usage/terminal/) e execute o seguinte comando:

   ```
   sudo raspi-config
   ```

   Você deve ver o seguinte:  
![\[Captura de tela da ferramenta de configuração de software do Raspberry Pi (raspi-config).\]](http://docs.aws.amazon.com/pt_br/greengrass/v1/developerguide/images/gg-get-started-001.png)

   Role para baixo e selecione **Interfacing Options** e, em seguida, selecione **P2 SSH**. Quando solicitado, selecione **Sim**. (Use a tecla Tab seguida por Enter). Agora, o SSH deve estar habilitado. Selecione **OK**. Use a tecla Tab para escolher **Finish (Concluir)** e, em seguida, pressione Enter. Se o Raspberry Pi não reinicializar automaticamente, execute o seguinte comando:

   ```
   sudo reboot
   ```

1. No Raspberry Pi, execute o seguinte comando no terminal:

   ```
   hostname -I
   ```

   Isso retorna o endereço IP do seu Raspberry Pi.
**nota**  
Para o seguinte, se você receber uma mensagem relacionada à impressão digital da chave ECDSA (`Are you sure you want to continue connecting (yes/no)?`), insira `yes`. A senha padrão do Raspberry Pi é **raspberry**.

   Se você estiver usando macOS, abra uma janela de terminal e insira o seguinte:

   ```
   ssh pi@IP-address
   ```

   *IP-address*é o endereço IP do seu Raspberry Pi que você obteve usando o `hostname -I` comando.

   Se você estiver usando uma máquina com Windows, precisará instalar e configurar o [PuTTY](https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html). Expanda **Connection (Conexão)**, selecione **Data (Dados)** e certifique-se de que **Prompt (Solicitar)** esteja selecionado:   
![\[Janela PuTTY com Prompt selecionado.\]](http://docs.aws.amazon.com/pt_br/greengrass/v1/developerguide/images/gg-get-started-001.4.png)

   Em seguida, selecione **Session (Sessão)**, insira o endereço IP do Raspberry Pi e selecione **Open (Abrir)** usando as configurações padrão.   
![\[Janela PuTTY com o endereço IP no campo “Host Name (or IP address)” (Nome de host [ou endereço IP]).\]](http://docs.aws.amazon.com/pt_br/greengrass/v1/developerguide/images/gg-get-started-001.5.png)

   Se um alerta de segurança do PuTTY for exibido, selecione **Yes (Sim)**.

   O login e senha padrão do Raspberry Pi são **pi** e **raspberry**, respectivamente.  
![\[Janela de terminal de PuTTY inicial.\]](http://docs.aws.amazon.com/pt_br/greengrass/v1/developerguide/images/gg-get-started-001.6.png)
**nota**  
Se o seu computador estiver conectado a uma rede remota usando VPN , isso poderá dificultar a conexão do computador com o Raspberry Pi usando SSH.

1. <a name="add-ggc-user-ggc-group"></a>Agora você está pronto para configurar o Raspberry Pi para AWS IoT Greengrass. Primeiro, execute os seguintes comandos a partir de uma janela de terminal local do Raspberry Pi ou uma janela de terminal SSH:
**dica**  
<a name="ggc-install-options"></a>AWS IoT Greengrass também fornece outras opções para instalar o software AWS IoT Greengrass Core. Por exemplo, você pode usar a [configuração do dispositivo Greengrass](quick-start.md) para configurar seu ambiente e instalar a versão mais recente do software AWS IoT Greengrass Core. Ou, em plataformas Debian suportadas, você pode usar o [gerenciador de pacotes APT](install-ggc.md#ggc-package-manager) para instalar ou atualizar o software AWS IoT Greengrass Core. Para obter mais informações, consulte [Instale o software AWS IoT Greengrass Core](install-ggc.md).

   ```
   sudo adduser --system ggc_user
   sudo addgroup --system ggc_group
   ```

1. Para aumentar a segurança no dispositivo Pi, habilite as proteções de hardlink e softlink (symlink) no sistema operacional durante a startup.

   1. Navegue até o arquivo `98-rpi.conf`.

      ```
      cd /etc/sysctl.d
      ls
      ```
**nota**  
Se você não encontrar o arquivo `98-rpi.conf`, siga as instruções no arquivo `README.sysctl`.

   1. Use um editor de texto (como Leafpad, GNU nano ou vi) para adicionar as duas linhas a seguir ao final do arquivo. Pode ser necessário usar o comando `sudo` para editar como raiz (por exemplo, `sudo nano 98-rpi.conf`).

      ```
      fs.protected_hardlinks = 1
      fs.protected_symlinks = 1
      ```

   1. Reinicialize o Pi.

      ```
      sudo reboot
      ```

      Depois de cerca de um minuto, conecte-se ao Pi usando SSH e então execute o comando a seguir para confirmar a alteração:

      ```
      sudo sysctl -a 2> /dev/null | grep fs.protected
      ```

      Você deve ver `fs.protected_hardlinks = 1` e `fs.protected_symlinks = 1`.

1. <a name="stretch-step"></a> Edite o arquivos de inicialização da linha de comando para habilitar e montar cgroups de memória. Isso permite AWS IoT Greengrass definir o limite de memória para funções Lambda. Também é necessário que os Cgroups sejam executados AWS IoT Greengrass no modo de [contêinerização](lambda-group-config.md#lambda-containerization-considerations) padrão.

   1.  Navegue até o diretório `boot`. 

      ```
      cd /boot/
      ```

   1.  Use um editor de texto para abrir `cmdline.txt`. Anexe o seguinte ao final da linha existente, e não como uma nova linha. Pode ser necessário usar o comando `sudo` para editar como raiz (por exemplo, `sudo nano cmdline.txt`).

      ```
      cgroup_enable=memory cgroup_memory=1
      ```

   1. Agora, reinicialize o Pi.

      ```
      sudo reboot
      ```

   Agora, seu Raspberry Pi deve estar pronto para o AWS IoT Greengrass.

1. <a name="install-java-8-runtime"></a>Opcional. Instale o tempo de execução do Java 8, que é exigido pelo [ gerenciador de fluxo](stream-manager.md). Este tutorial não usa o gerenciador de fluxo, mas usa o fluxo de trabalho de **Criação de grupo padrão** que habilita o gerenciador de fluxo por padrão. Use os comandos a seguir para instalar o módulo de tempo de execução do Java 8 no dispositivo de núcleo ou desabilite o gerenciador de fluxo antes de implantar seu grupo. As instruções para desabilitar o gerenciador de fluxo são fornecidas no Módulo 3.

   ```
   sudo apt install openjdk-8-jdk
   ```

1. [Para garantir que você tenha todas as dependências necessárias, baixe e execute o verificador de dependências do Greengrass a partir do AWS IoT Greengrass repositório Samples em.](https://github.com/aws-samples/aws-greengrass-samples) GitHub Esses comandos descompactam e executam o script verificador de dependências no diretório `Downloads`.
**nota**  
 O verificador de dependências pode falhar se você estiver executando a versão 5.4.51 do kernel Raspbian. Essa versão não monta cgroups de memória corretamente. Isso pode fazer com que as funções do Lambda em execução no modo contêiner falhem.  
Para obter mais informações sobre como atualizar seu kernel, consulte os [Cgroups não carregados após a atualização do kernel](https://www.raspberrypi.org/forums/viewtopic.php?t=280656) nos fóruns do Raspberry Pi. 

   ```
   cd /home/pi/Downloads
   mkdir greengrass-dependency-checker-GGCv1.11.x
   cd greengrass-dependency-checker-GGCv1.11.x
   wget https://github.com/aws-samples/aws-greengrass-samples/raw/master/greengrass-dependency-checker-GGCv1.11.x.zip
   unzip greengrass-dependency-checker-GGCv1.11.x.zip
   cd greengrass-dependency-checker-GGCv1.11.x
   sudo modprobe configs
   sudo ./check_ggc_dependencies | more
   ```

   Se `more` for exibido, pressione a tecla Spacebar para exibir outra tela de texto. 
**Importante**  
<a name="lambda-runtime-prereqs"></a>Este tutorial requer o Python 3.7 Runtime para executar funções locais do Lambda. Quando o gerenciador de fluxo está habilitado, ele também requer o Java 8 Runtime. Se o script `check_ggc_dependencies` gerar avisos sobre esses pré-requisitos de tempo de execução ausentes, certifique-se de instalá-los antes de continuar. Você pode ignorar os avisos sobre outros pré-requisitos de tempo de execução opcionais ausentes.

   Para obter informações sobre o comando **modprobe**, execute **man modprobe** no terminal. 

A configuração do Raspberry Pi está concluída. Avance para [Módulo 2: Instalação do software AWS IoT Greengrass principal](module2.md).

# Configurando uma EC2 instância da Amazon
<a name="setup-filter.ec2"></a>

Siga as etapas deste tópico para configurar uma EC2 instância da Amazon para usar como seu AWS IoT Greengrass núcleo.

**dica**  
Ou, para usar um script que configura seu ambiente e instala o software AWS IoT Greengrass principal para você, consulte[Início rápido: Configuração do dispositivo do Greengrass](quick-start.md).

 Embora você possa concluir este tutorial usando uma EC2 instância da Amazon, ele AWS IoT Greengrass deve ser usado idealmente com hardware físico. Recomendamos que você [configure um Raspberry Pi](setup-filter.rpi.md) em vez de usar uma EC2 instância da Amazon quando possível. Se estiver usando um Raspberry Pi, você não precisará seguir as etapas deste tópico. 

 

1. Faça login no [Console de gerenciamento da AWS](https://console.aws.amazon.com/)e execute uma EC2 instância da Amazon usando uma Amazon Linux AMI. Para obter informações sobre EC2 instâncias da Amazon, consulte o [Amazon EC2 Getting Started Guide](https://docs.aws.amazon.com/AWSEC2/latest/GettingStartedGuide/).

1. Depois que sua EC2 instância da Amazon estiver em execução, habilite a porta 8883 para permitir a entrada de comunicações MQTT para que outros dispositivos possam se conectar ao núcleo. AWS IoT Greengrass 

   1. No painel de navegação do EC2 console da Amazon, escolha **Security Groups**.  
![\[Painel de navegação com Grupos de segurança em destaque.\]](http://docs.aws.amazon.com/pt_br/greengrass/v1/developerguide/images/gg-get-started-002.6.1.png)

   1. Selecione o grupo de segurança da instância que você acabou de executar e, em seguida, selecione a guia **Regras de entrada**.

   1. Selecione **Edit inbound rules** (Editar regras de entrada).

      Para habilitar a porta 8883, você adiciona uma regra de TCP personalizada ao grupo de segurança. Para obter mais informações, consulte [Adicionar regras a um grupo de segurança](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-network-security.html#adding-security-group-rule) no *Guia EC2 do usuário da Amazon*.

   1. Na página **Edita regras de entrada**, selecione **Adicionar regra**, insira as configurações a seguir e, depois, selecione **Salvar**.
      + Para **Tipo**, selecione **Regra TCP personalizada**.
      + Em **Intervalo de portas**, insira **8883**.
      + Para **Source (Origem)**, selecione **Anywhere (Qualquer lugar)**.
      + Em **Descrição**, insira **MQTT Communications**.

       

1. Conecte-se à sua EC2 instância da Amazon.

   1. No painel de navegação, selecione **Instances (Instâncias)**, selecione sua instância e, em seguida, selecione **Connect (Conectar)**.

   1. Siga as instruções na página **Connect To Your Instance (Conectar à sua instância)** para conectar-se à instância [ usando SSH](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AccessingInstancesLinux.html) e o arquivo da chave privada.

   Você pode usar [PuTTY](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/putty.html) para Windows ou Terminal para macOS. Para obter mais informações, consulte [Connect to your Linux instance](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AccessingInstances.html) no *Amazon EC2 User Guide*.

   Agora você está pronto para configurar sua EC2 instância da Amazon para AWS IoT Greengrass.

1. Depois de se conectar à sua EC2 instância da Amazon, crie as `ggc_group` contas `ggc_user` e:

   ```
   sudo adduser --system ggc_user
   sudo groupadd --system ggc_group
   ```
**nota**  
Se o comando `adduser` não estiver disponível no sistema, use o comando a seguir.  

   ```
   sudo useradd --system ggc_user
   ```

1. Para melhorar a segurança, certifique-se de que as proteções de hardlink e softlink (link simbólico) estejam ativadas no sistema operacional da instância Amazon EC2 na inicialização.
**nota**  
 As etapas para habilitar as proteções de hardlink e softlink variam de acordo com o sistema operacional. Consulte a documentação para obter sua distribuição. 

   1.  Execute o seguinte comando para verificar se as proteções de hardlink e softlink estão habilitadas: 

      ```
      sudo sysctl -a | grep fs.protected
      ```

       Se hardlinks e softlinks estão definidos como `1`, suas proteções estão habilitadas corretamente. Prossiga para a etapa 6. 
**nota**  
Os softlinks são representados por `fs.protected_symlinks`.

   1. Se hardlinks e softlinks não estão definidos como `1`, habilite essas proteções. Navegue até o arquivo de configuração do sistema. 

      ```
      cd /etc/sysctl.d
      ls
      ```

   1. Usando o editor de texto de sua preferência (Leafpad, GNU nano ou vi), adicione as duas linhas a seguir ao final do arquivo de configuração do sistema. No Amazon Linux 1, esse é o arquivo `00-defaults.conf`. No Amazon Linux 2, esse é o arquivo `99-amazon.conf`. Talvez seja necessário alterar as permissões (usando o comando `chmod`) para gravar no arquivo ou usar o comando `sudo` para editar como raiz (por exemplo, `sudo nano 00-defaults.conf`).

      ```
      fs.protected_hardlinks = 1
      fs.protected_symlinks = 1
      ```

   1. Reinicie a EC2 instância da Amazon.

      ```
      sudo reboot
      ```

      Depois de alguns minutos, conecte-se à sua instância usando SSH e então execute o comando a seguir para confirmar a alteração.

      ```
      sudo sysctl -a | grep fs.protected
      ```

      Os hardlinks e softlinks estão definidos como 1.

1. Extraia e execute o script a seguir para montar [Grupos de controle do Linux](https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/6/html/resource_management_guide/ch01) (cgroups). Isso permite AWS IoT Greengrass definir o limite de memória para funções Lambda. Também é necessário que os Cgroups sejam executados AWS IoT Greengrass no modo de [contêinerização](lambda-group-config.md#lambda-containerization-considerations) padrão.

   ```
   curl https://raw.githubusercontent.com/tianon/cgroupfs-mount/951c38ee8d802330454bdede20d85ec1c0f8d312/cgroupfs-mount > cgroupfs-mount.sh
   chmod +x cgroupfs-mount.sh 
   sudo bash ./cgroupfs-mount.sh
   ```

   Sua EC2 instância da Amazon agora deve estar pronta para AWS IoT Greengrass.

1. <a name="install-java-8-runtime"></a>Opcional. Instale o tempo de execução do Java 8, que é exigido pelo [ gerenciador de fluxo](stream-manager.md). Este tutorial não usa o gerenciador de fluxo, mas usa o fluxo de trabalho de **Criação de grupo padrão** que habilita o gerenciador de fluxo por padrão. Use os comandos a seguir para instalar o módulo de tempo de execução do Java 8 no dispositivo de núcleo ou desabilite o gerenciador de fluxo antes de implantar seu grupo. As instruções para desabilitar o gerenciador de fluxo são fornecidas no Módulo 3.
   + Para distribuições com base em Debian:

     ```
     sudo apt install openjdk-8-jdk
     ```
   + Para distribuições com base em Red Hat:

     ```
     sudo yum install java-1.8.0-openjdk
     ```

1. [Para garantir que você tenha todas as dependências necessárias, baixe e execute o verificador de dependências do Greengrass a partir do AWS IoT Greengrass repositório Samples em.](https://github.com/aws-samples/aws-greengrass-samples) GitHub Esses comandos baixam, descompactam e executam o script do verificador de dependências na sua instância da Amazon. EC2 

   ```
   mkdir greengrass-dependency-checker-GGCv1.11.x
   cd greengrass-dependency-checker-GGCv1.11.x
   wget https://github.com/aws-samples/aws-greengrass-samples/raw/master/greengrass-dependency-checker-GGCv1.11.x.zip
   unzip greengrass-dependency-checker-GGCv1.11.x.zip
   cd greengrass-dependency-checker-GGCv1.11.x
   sudo ./check_ggc_dependencies | more
   ```
**Importante**  
<a name="lambda-runtime-prereqs"></a>Este tutorial requer o Python 3.7 Runtime para executar funções locais do Lambda. Quando o gerenciador de fluxo está habilitado, ele também requer o Java 8 Runtime. Se o script `check_ggc_dependencies` gerar avisos sobre esses pré-requisitos de tempo de execução ausentes, certifique-se de instalá-los antes de continuar. Você pode ignorar os avisos sobre outros pré-requisitos de tempo de execução opcionais ausentes.

A configuração da sua EC2 instância Amazon está completa. Avance para [Módulo 2: Instalação do software AWS IoT Greengrass principal](module2.md).

# Configurar outros dispositivos
<a name="setup-filter.other"></a>

Siga as etapas deste tópico para configurar um dispositivo (que não seja um Raspberry Pi) para usar como seu AWS IoT Greengrass núcleo.

**dica**  
Ou, para usar um script que configura seu ambiente e instala o software AWS IoT Greengrass principal para você, consulte[Início rápido: Configuração do dispositivo do Greengrass](quick-start.md).

Se você é novato AWS IoT Greengrass, recomendamos que você use um Raspberry Pi ou uma EC2 instância da Amazon como seu dispositivo principal e siga as [etapas de configuração](module1.md) apropriadas para seu dispositivo.

Se você planeja criar um sistema personalizado baseado em Linux usando o Projeto Yocto, você pode usar a Receita AWS IoT Greengrass Bitbake do projeto. `meta-aws` Essa receita também ajuda você a desenvolver uma plataforma de software que ofereça suporte a software de AWS ponta para aplicativos incorporados. A compilação do Bitbake instala, configura e executa automaticamente o software AWS IoT Greengrass Core em seu dispositivo.

Projeto Yocto  
Um projeto de colaboração de código aberto que ajuda você a criar sistemas personalizados baseados em Linux para aplicativos incorporados, independentemente da arquitetura do hardware. Para obter mais informações, consulte o [Projeto Yocto](https://www.yoctoproject.org/).

`meta-aws`  
Um projeto AWS gerenciado que fornece receitas de Yocto. Você pode usar as receitas para desenvolver software de AWS ponta em sistemas baseados em Linux criados com [OpenEmbedded](https://www.openembedded.org/wiki/Main_Page)o Projeto Yocto. Para obter mais informações sobre esse recurso suportado pela comunidade, consulte o [https://github.com/aws/meta-aws](https://github.com/aws/meta-aws)projeto em GitHub.

`meta-aws-demos`  
Um projeto AWS gerenciado que contém demonstrações do `meta-aws` projeto. Para obter mais exemplos sobre o processo de integração, consulte o [https://github.com/aws-samples/meta-aws-demos](https://github.com/aws-samples/meta-aws-demos)projeto em GitHub.

Para usar outro dispositivo ou [plataforma compatível](what-is-gg.md#gg-platforms), siga as etapas deste tópico.

1. <a name="setup-jetson"></a>Se o seu dispositivo principal for um dispositivo NVIDIA Jetson, você deve primeiro atualizar o firmware com o instalador JetPack 4.3. Se estiver configurando um dispositivo diferente, vá para a etapa 2.
**nota**  
A versão JetPack do instalador que você usa é baseada na versão de destino do CUDA Toolkit. As instruções a seguir usam JetPack 4.3 e CUDA Toolkit 10.0. Para obter informações sobre como usar as versões apropriadas para o seu dispositivo, consulte [How to Install Jetpack](https://docs.nvidia.com/jetson/jetpack/install-jetpack/index.html) na documentação do NVIDIA.

   1. Em um desktop físico que esteja executando o Ubuntu 16.04 ou posterior, atualize o firmware com o instalador JetPack 4.3, conforme descrito em [Download e instalação JetPack](https://docs.nvidia.com/jetson/archives/jetpack-archived/jetpack-33/index.html#jetpack/3.3/install.htm%3FTocPath%3D_____3) (4.3) na documentação da NVIDIA.

      Siga as instruções exibidas para instalar todos os pacotes e dependências na placa Jetson, que deve ser conectada ao desktop com um cabo Micro-B.

   1. Reinicialize sua placa no modo normal e conecte um monitor à placa.
**nota**  
Quando você usar o SSH para se conectar à placa Jetson, use o nome de usuário padrão (**nvidia**) e a senha padrão (**nvidia**).

1. Execute um dos comandos a seguir para criar um usuário `ggc_user` e grupo `ggc_group`. Os comandos que você executa são diferentes, dependendo da distribuição instalada no dispositivo de núcleo.
   + Se o seu dispositivo principal estiver em execução OpenWrt, execute os seguintes comandos:

     ```
     opkg install shadow-useradd
     opkg install shadow-groupadd
     useradd --system ggc_user
     groupadd --system ggc_group
     ```
   + Caso contrário, execute os seguintes comandos:

     ```
     sudo adduser --system ggc_user
     sudo addgroup --system ggc_group
     ```
**nota**  
Se o comando `addgroup` não estiver disponível no sistema, use o comando a seguir.  

     ```
     sudo groupadd --system ggc_group
     ```

1. <a name="install-java-8-runtime"></a>Opcional. Instale o tempo de execução do Java 8, que é exigido pelo [ gerenciador de fluxo](stream-manager.md). Este tutorial não usa o gerenciador de fluxo, mas usa o fluxo de trabalho de **Criação de grupo padrão** que habilita o gerenciador de fluxo por padrão. Use os comandos a seguir para instalar o módulo de tempo de execução do Java 8 no dispositivo de núcleo ou desabilite o gerenciador de fluxo antes de implantar seu grupo. As instruções para desabilitar o gerenciador de fluxo são fornecidas no Módulo 3.
   + Para distribuições com base em Debian ou em Ubuntu:

     ```
     sudo apt install openjdk-8-jdk
     ```
   + Para distribuições com base em Red Hat:

     ```
     sudo yum install java-1.8.0-openjdk
     ```

1. [Para garantir que você tenha todas as dependências necessárias, baixe e execute o verificador de dependências do Greengrass a partir do AWS IoT Greengrass repositório Samples em.](https://github.com/aws-samples/aws-greengrass-samples) GitHub Esses comandos descompactam e executam o script verificador de dependências.

   ```
   mkdir greengrass-dependency-checker-GGCv1.11.x
   cd greengrass-dependency-checker-GGCv1.11.x
   wget https://github.com/aws-samples/aws-greengrass-samples/raw/master/greengrass-dependency-checker-GGCv1.11.x.zip
   unzip greengrass-dependency-checker-GGCv1.11.x.zip
   cd greengrass-dependency-checker-GGCv1.11.x
   sudo ./check_ggc_dependencies | more
   ```
**nota**  
O `check_ggc_dependencies` script é executado em plataformas AWS IoT Greengrass suportadas e requer comandos específicos do sistema Linux. Para obter mais informações, consulte o [Readme](https://github.com/aws-samples/aws-greengrass-samples/blob/master/greengrass-dependency-checker-GGCv1.11.x/README.md) do verificador de dependências.

1. Instale todas as dependências necessárias no seu dispositivo, conforme indicado pelo resultado do verificador de dependências. Para as dependências ausentes no nível do kernel, pode ser necessário recompilar o kernel. Para montar grupos de controle do Linux (`cgroups`), você pode executar o script [cgroupfs-mount](https://raw.githubusercontent.com/tianon/cgroupfs-mount/master/cgroupfs-mount). Isso permite AWS IoT Greengrass definir o limite de memória para funções Lambda. Também é necessário que os Cgroups sejam executados AWS IoT Greengrass no modo de [contêinerização](lambda-group-config.md#lambda-containerization-considerations) padrão.

   Se nenhum erro aparecer na saída, AWS IoT Greengrass deve ser capaz de ser executado com sucesso em seu dispositivo.
**Importante**  
<a name="lambda-runtime-prereqs"></a>Este tutorial requer o Python 3.7 Runtime para executar funções locais do Lambda. Quando o gerenciador de fluxo está habilitado, ele também requer o Java 8 Runtime. Se o script `check_ggc_dependencies` gerar avisos sobre esses pré-requisitos de tempo de execução ausentes, certifique-se de instalá-los antes de continuar. Você pode ignorar os avisos sobre outros pré-requisitos de tempo de execução opcionais ausentes.

   Para obter a lista de AWS IoT Greengrass requisitos e dependências, consulte[Plataformas compatíveis e requisitos](what-is-gg.md#gg-platforms).