

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

# Como configurar a inferência de aprendizado de máquina usando o Console de gerenciamento da AWS
<a name="ml-console"></a>

Para seguir as etapas deste tutorial, você precisa do AWS IoT Greengrass Core v1.10 ou posterior.

Você pode realizar inferência de machine learning (ML) localmente em um dispositivo de núcleo do Greengrass usando dados gerados localmente. Para obter mais informações, inclusive sobre os requisitos e restrições, consulte [Executar a inferência de machine learning](ml-inference.md).

Este tutorial descreve como usar o Console de gerenciamento da AWS para configurar um grupo do Greengrass para executar um aplicativo de inferência Lambda que reconhece imagens de uma câmera localmente, sem enviar dados para a nuvem. O aplicativo de inferência acessa o módulo da câmera em um Raspberry Pi e executa a inferência usando o modelo de código aberto. [SqueezeNet](https://github.com/DeepScale/SqueezeNet)

O tutorial contém as seguintes etapas de nível elevado:

1. [Configurar o Raspberry Pi](#config-raspberry-pi)

1. [Instale a MXNet estrutura](#install-mxnet)

1. [Criar um pacote de modelo](#package-ml-model)

1. [Crie e publique uma função do Lambda](#ml-console-create-lambda)

1. [Adicionar a função do Lambda ao grupo](#ml-console-config-lambda)

1. [Adicionar recursos ao grupo](#ml-console-add-resources)

1. [Adicionar uma assinatura ao grupo](#ml-console-add-subscription)

1. [Implantar o grupo](#ml-console-deploy-group)

1. [Testar o aplicativo](#ml-console-test-app)

## Pré-requisitos
<a name="ml-inference-prerequisites"></a>

Para concluir este tutorial, é necessário:
+ Raspberry Pi 4 Modelo B, ou Raspberry Pi 3 Modelo B/B\$1, instalado e configurado para uso com. AWS IoT Greengrass Para configurar seu Raspberry Pi com o AWS IoT Greengrass, execute o script [Greengrass Device Setup](quick-start.md) ou conclua o [Módulo 1](https://docs.aws.amazon.com/greengrass/latest/developerguide/module1.html) e o [Módulo 2](https://docs.aws.amazon.com/greengrass/latest/developerguide/module2.html) do [Começando com AWS IoT Greengrass](gg-gs.md).
**nota**  
O Raspberry Pi pode exigir uma [fonte de alimentação](https://www.raspberrypi.org/documentation/hardware/raspberrypi/power/) de 2,5 A para executar as estruturas de aprendizado profundo que normalmente são usadas para classificação de imagens. Uma fonte de alimentação com uma classificação mais baixa pode fazer com que o dispositivo seja reinicializado.
+ [Módulo de câmera Raspberry Pi V2 - 8 megapixels, 1080 p](https://www.amazon.com/Raspberry-Pi-Camera-Module-Megapixel/dp/B01ER2SKFS). Para obter informações sobre como configurar a câmera, consulte [Conectar a câmera](https://www.raspberrypi.org/documentation/usage/camera/) na documentação do Raspberry Pi. 
+ Um grupo do Greengrass e um núcleo do Greengrass. Para obter informações sobre como criar um grupo ou núcleo do Greengrass, consulte [Começando com AWS IoT Greengrass](gg-gs.md).

**nota**  
Este tutorial usa um Raspberry Pi, mas AWS IoT Greengrass oferece suporte a outras plataformas, como [Intel Atom](#atom-lambda-config) e [NVIDIA](#jetson-lambda-config) Jetson. TX2 No exemplo do Jetson TX2, você pode usar imagens estáticas em vez de imagens transmitidas de uma câmera. Se estiver usando o TX2 exemplo do Jetson, talvez seja necessário instalar o Python 3.6 em vez do Python 3.7. Para obter informações sobre como configurar seu dispositivo para que você possa instalar o software AWS IoT Greengrass Core, consulte[Configurar outros dispositivos](setup-filter.other.md).  
Para plataformas de terceiros que AWS IoT Greengrass não oferecem suporte, você deve executar sua função Lambda no modo não conteinerizado. Para executar no modo sem contêiner, você deve executar sua função do Lambda como root. Para obter mais informações, consulte [Considerações ao escolher a conteinerização de função do Lambda](lambda-group-config.md#lambda-containerization-considerations) e [Definir a identidade de acesso padrão para as funções do Lambda em um grupo](lambda-group-config.md#lambda-access-identity-groupsettings).

## Etapa 1: Configurar o Raspberry Pi
<a name="config-raspberry-pi"></a>

Nesta etapa, instale as atualizações no sistema operacional Raspbian, instale o software do módulo da câmera e as dependências do Python e ative a interface da câmera.

Execute os seguintes comandos no seu terminal do Raspberry Pi.

1. Instale as atualizações no Raspbian.

   ```
   sudo apt-get update
   sudo apt-get dist-upgrade
   ```

1. <a name="install-picamera-step"></a>Instale a interface do `picamera` para o módulo da câmera e outras bibliotecas do Python que são necessárias para este tutorial.

   ```
   sudo apt-get install -y python3-dev python3-setuptools python3-pip python3-picamera
   ```

   Valide a instalação:
   + Verifique se a instalação do Python 3.7 inclui o pip.

     ```
     python3 -m pip
     ```

     Se o pip não estiver instalado, faça download dele no [site do pip](https://pip.pypa.io/en/stable/installing/) e execute o seguinte comando.

     ```
     python3 get-pip.py
     ```
   + Verifique se a versão do Python é 3.7 ou superior.

     ```
     python3 --version
     ```

     Se a saída listar uma versão anterior, execute o seguinte comando.

     ```
     sudo apt-get install -y python3.7-dev
     ```
   + Verifique se o Setuptools e Picamera foram instalados com êxito.

     ```
     sudo -u ggc_user bash -c 'python3 -c "import setuptools"'
     sudo -u ggc_user bash -c 'python3 -c "import picamera"'
     ```

     Se a saída não contiver erros, a validação será bem-sucedida.
**nota**  
Se o Python executável instalado no dispositivo for o `python3.7`, use `python3.7` em vez de `python3` para os comandos neste tutorial. Verifique se a instalação do pip mapeia para a versão correta do `python3` ou `python3.7` para evitar erros de dependência.

1. Reinicie o Raspberry Pi.

   ```
   sudo reboot
   ```

1. Abra a ferramenta de configuração do Raspberry Pi.

   ```
   sudo raspi-config
   ```

1. Use as setas do teclado para abrir **Interfacing Options** e habilitar a interface da câmera. Se solicitado, permita que o dispositivo seja reinicializado.

1. Use o seguinte comando para testar a configuração da câmera.

   ```
   raspistill -v -o test.jpg
   ```

   Isso abre uma janela de visualização no Raspberry Pi, salva uma imagem chamada `test.jpg` no seu diretório atual e exibe informações sobre a câmera no terminal do Raspberry Pi.

## Etapa 2: instalar a MXNet estrutura
<a name="install-mxnet"></a>

Nesta etapa, instale MXNet bibliotecas no seu Raspberry Pi.

1. <a name="ssh-rpi-step"></a>Inicie sessão no seu Raspberry Pi remotamente.

   ```
   ssh pi@your-device-ip-address
   ```

1. Abra a MXNet documentação, abra [Instalação MXNet](https://mxnet.apache.org/get_started/?) e siga as instruções para instalar MXNet no dispositivo.
**nota**  
Recomendamos instalar a versão 1.5.0 e compilar a MXNet partir do código-fonte para este tutorial para evitar conflitos de dispositivos.

1. Depois de instalar MXNet, valide a seguinte configuração:
   + Certifique-se de que a conta `ggc_user` do sistema possa usar a MXNet estrutura.

     ```
     sudo -u ggc_user bash -c 'python3 -c "import mxnet"'
     ```
   + Verifique se NumPy está instalado.

     ```
     sudo -u ggc_user bash -c 'python3 -c "import numpy"'
     ```

## Etapa 3: criar um pacote de MXNet modelo
<a name="package-ml-model"></a>

Nesta etapa, crie um pacote de modelo que contenha uma amostra de MXNet modelo pré-treinado para ser carregada no Amazon Simple Storage Service (Amazon S3). AWS IoT Greengrass pode usar um pacote de modelo do Amazon S3, desde que você use o formato tar.gz ou zip.

1. No seu computador, baixe a MXNet amostra do Raspberry Pi em. [Exemplos de machine learning](what-is-gg.md#gg-ml-samples)

1.  Não descompacte o arquivo `mxnet-py3-armv7l.tar.gz` obtido por download. 

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

   ```
   cd path-to-downloaded-sample/mxnet-py3-armv7l/models/squeezenet
   ```

   O arquivo `squeezenet.zip` neste diretório é o pacote de modelo. Ele contém artefatos de modelo de código SqueezeNet aberto para um modelo de classificação de imagens. Posteriormente, esse pacote de modelo é carregado no Amazon S3.

## Etapa 4: Crie e publique uma função do Lambda
<a name="ml-console-create-lambda"></a>

Nesta etapa, crie um pacote de implantação da função do Lambda e uma função do Lambda. Depois, publique uma versão da função e crie um alias.

Primeiro, crie o pacote de implantação da função do Lambda.

1. No computador, navegue até o diretório `examples` no pacote de exemplo que você descompactou em [Etapa 3: criar um pacote de MXNet modelo](#package-ml-model).

   ```
   cd path-to-downloaded-sample/mxnet-py3-armv7l/examples
   ```

   O diretório `examples` contém código de função e dependências.
   + O `greengrassObjectClassification.py` é o código de inferência usado neste tutorial. Você pode usar esse código como modelo para criar sua própria função de inferência.
   + <a name="ml-samples-ggc-sdk"></a>`greengrasssdk` é a versão 1.5.0 do SDK do AWS IoT Greengrass Core para Python.
**nota**  <a name="ml-samples-ggc-sdk-upgrade"></a>
Se uma nova versão estiver disponível, você poderá fazer download dela e atualizar a versão do SDK no seu pacote de implantação. Para obter mais informações, consulte [AWS IoT Greengrass Core SDK para GitHub Python on](https://github.com/aws/aws-greengrass-core-sdk-python/).

1.  Compacte o conteúdo do diretório `examples` em um arquivo chamado `greengrassObjectClassification.zip`. Esse é o pacote de implantação. 

   ```
   zip -r greengrassObjectClassification.zip .
   ```
**nota**  <a name="ml-samples-function-zip"></a>
 Verifique se os arquivos `.py` e as dependências estão na raiz do diretório. 

    

   Depois, crie a função do Lambda .

1. No AWS IoT console, escolha **Funções** e **Criar função**.

1. Selecione **Criar do zero** e use os valores a seguir para criar a função:
   + Em **Function name** (Nome da função), insira **greengrassObjectClassification**.
   + Em **Runtime (Tempo de execução)**, selecione **Python 3.7**.

   Em **Permissões**, mantenha a configuração padrão. Isso cria uma função de execução que concede permissões básicas do Lambda. Essa função não é usada por AWS IoT Greengrass.

1. Selecione **Criar função**.

    

   Agora, carregue o seu pacote de implantação da função do Lambda e registre o manipulador.

1. Selecione sua função do Lambda e carregue seu pacote de implantação da função do Lambda.

   1. <a name="lambda-console-upload"></a>Na guia **Código**, em **Fonte do código**, selecione **Fazer upload a partir de**. No menu suspenso, selecione o **arquivo .zip**.  
![\[O menu suspenso Fazer upload a partir de com o arquivo .zip destacado.\]](http://docs.aws.amazon.com/pt_br/greengrass/v1/developerguide/images/lra-console/upload-deployment-package.png)

   1. Selecione **Upload** e, em seguida, selecione seu pacote de implantação `greengrassObjectClassification.zip`. Selecione **Salvar**.

   1. <a name="lambda-console-runtime-settings-para"></a>Na guia **Código** da função, em **Configurações de runtime**, selecione **Editar** e insira os valores a seguir.
      + Em **Runtime (Tempo de execução)**, selecione **Python 3.7**.
      + Em **Handler (Manipulador)**, insira **greengrassObjectClassification.function\$1handler**.

      Selecione **Salvar**.

   Em seguida, publique a primeira versão da sua função do Lambda. Em seguida, crie um [alias para a versão](https://docs.aws.amazon.com/lambda/latest/dg/versioning-aliases.html).
**nota**  
Os grupos do Greengrass podem fazer referência a uma função do Lambda por alias (recomendado) ou por versão. Usar um alias facilita o gerenciamento de atualizações de código porque você não precisa alterar a tabela de assinaturas nem a definição do grupo ao atualizar a função do código. Em vez disso, você pode simplesmente apontar o alias para a nova versão da função.

1. No menu **Actions**, selecione **Publish new version**.  
![\[A opção Publish new version (Publicar nova versão) no menu Actions (Ações).\]](http://docs.aws.amazon.com/pt_br/greengrass/v1/developerguide/images/ml-inference/lambda-publish-version.png)

1. Em **Version description (Descrição da versão)**, insira **First version** e, em seguida, selecione **Publish (Publicar)**.

1. Na página de configuração **greengrassObjectClassification: 1**, no menu **Ações**, escolha **Criar alias**.  
![\[A opção Create alias (Criar alias) no menu Actions (Ações).\]](http://docs.aws.amazon.com/pt_br/greengrass/v1/developerguide/images/ml-inference/lambda-create-alias.png)

1. Na página **Create a new alias**, use os seguintes valores:
   + Em **Nome**, digite **mlTest**.
   + Em **Version (Versão)**, insira **1**.
**nota**  
AWS IoT Greengrass **não oferece suporte a aliases Lambda para as versões \$1LATEST.**

1. Selecione **Salvar**.

    

   Agora, adicione a função do Lambda ao seu grupo do Greengrass.

## Etapa 5: adicionar a função do Lambda ao grupo do Greengrass
<a name="ml-console-config-lambda"></a>

Nesta etapa, adicione a função do Lambda ao grupo e configura o ciclo de vida e as variáveis de ambiente.

Primeiro, adicione a função do Lambda ao seu grupo do Greengrass.

1. No painel de navegação do AWS IoT console, em **Gerenciar**, expanda dispositivos **Greengrass** e **escolha Grupos (**V1).

1. Na página de configuração do grupo, selecione a guia **Funções do Lambda**.

1. Na seção **Minhas funções do Lambda**, selecione **Adicionar**.

1. Para a **função Lambda, escolha**. **greengrassObjectClassification**

1. Para a **Versão da função do Lambda**, selecione **Alias:mlTest**.

    

   Em seguida, configure o ciclo de vida e as variáveis de ambiente da função do Lambda.

1. Na seção **Configuração da função do Lambda**, faça as atualizações a seguir.
**nota**  
Recomendamos que você execute sua função do Lambda sem conteinerização, a menos que seu caso de negócios faça essa exigência. Isso ajuda a habilitar o acesso à GPU e à câmera do seu dispositivo sem configurar os recursos do dispositivo. Se você executa sem conteinerização, também deve conceder acesso root às suas funções do Lambda AWS IoT Greengrass . 

   1. **Para executar sem conteinerização:**
      + Para **Usuário e grupo do sistema**, selecione **Another user ID/group ID**. Para **ID de usuário do sistema**, insira **0**. Para **ID do grupo do sistema**, insira **0**.

        Isso permite que sua função do Lambda seja executada como root. Para obter mais informações sobre como executar como raiz, consulte [Definir a identidade de acesso padrão para as funções do Lambda em um grupo](lambda-group-config.md#lambda-access-identity-groupsettings).
**dica**  
Você também deve atualizar seu arquivo `config.json` para conceder acesso root à sua função do Lambda. Para o procedimento, consulte [Executar uma função do Lambda como raiz](lambda-group-config.md#lambda-running-as-root).
      + Para **conteinerização da função do Lambda**, selecione **Sem contêiner**.

        Para obter mais informações sobre como executar sem conteinerização, consulte [Considerações ao escolher a conteinerização de função do Lambda](lambda-group-config.md#lambda-containerization-considerations).
      + Em **Timeout (Tempo limite)**, insira **10 seconds**.
      + Para **Fixado**, selecione **Verdadeiro**. 

        Para obter mais informações, consulte [Configuração do ciclo de vida das funções do Lambda do Greengrass](lambda-functions.md#lambda-lifecycle).

   1.  **Em vez disso, para executar no modo conteinerizado:** 
**nota**  
Não recomendamos a execução no modo conteinerizado, a menos que seu caso de negócios faça essa exigência.
      + Para **Usuário e grupo do sistema**, selecione **Usar padrão de grupo**.
      + Para **Conteinerização da função do Lambda**, selecione **Usar padrão de grupo**.
      + Em **Memory limit (Limite de memória)**, insira **96 MB**.
      + Em **Timeout (Tempo limite)**, insira **10 seconds**.
      + Para **Fixado**, selecione **Verdadeiro**. 

        Para obter mais informações, consulte [Configuração do ciclo de vida das funções do Lambda do Greengrass](lambda-functions.md#lambda-lifecycle).

1. Em **Environment variables (Variáveis de ambiente)**, crie um par de chave/valor. Um par de valores-chave é exigido por funções que interagem com MXNet modelos em um Raspberry Pi.

   Na chave, use MXNET\$1ENGINE\$1TYPE. Para o valor, use NaiveEngine. 
**nota**  
Se preferir, nas suas próprias funções do Lambda definidas pelo usuário, é possível definir a variável de ambiente no código da função.

1. Mantenha os valores padrão para todas as outras propriedades e selecione **Adicionar função do Lambda**.

## Etapa 6: Adicionar recursos ao grupo do Greengrass
<a name="ml-console-add-resources"></a>

Nesta etapa, crie recursos para o módulo da câmera e o modelo de inferência de ML e afilie os recursos com a função do Lambda. Isso possibilita que a função do Lambda acesse os recursos no dispositivo básico.

**nota**  
Se você executar no modo não conteinerizado, AWS IoT Greengrass poderá acessar a GPU e a câmera do dispositivo sem configurar esses recursos do dispositivo. 

Primeiro, crie dois recursos de dispositivos locais para a câmera: um para memória compartilhada e outro para a interface do dispositivo. Para obter mais informações sobre acesso a recursos locais, consulte [Acesso aos recursos locais com funções e conectores do Lambda](access-local-resources.md).

1. Na página de configuração do grupo, selecione a guia **Recursos**.

1. Na seção **Recursos locais**, selecione **Adicionar recurso local**.

1. Na página ** Adicionar recurso local**, use os seguintes valores:
   + Em **Resource Name (Nome do recurso)**, insira **videoCoreSharedMemory**.
   + Em **Resource type**, selecione **Device**.
   + Em **Caminho do dispositivo local**, insira **/dev/vcsm**.

     O caminho do dispositivo é o caminho absoluto local do recurso do dispositivo. Este caminho só pode se referir a um dispositivo de caractere ou dispositivo de blocos em `/dev`.
   + Em ‭‬**Permissões do proprietário do grupo do sistema e ‬‬ de acesso a ‭arquivos‭**‬, selecione **‭Adicionar automaticamente permissões de sistema de arquivos do grupo do sistema que é proprietário do recurso**‭.‬‬‬‬‬‬‬‬

     A opção **Proprietário do grupo do sistema e permissões de acesso ao arquivo** permite conceder permissões adicionais de acesso a arquivos para o processo do Lambda. Para obter mais informações, consulte [Permissão de acesso a arquivo do proprietário do grupo](access-local-resources.md#lra-group-owner).

1. Em seguida, você adiciona um recurso de dispositivo local para a interface da câmera.

1. Selecione **Adicionar recurso local**.

1. Na página **Adicionar recurso local**, use os seguintes valores:
   + Em **Resource Name (Nome do recurso)**, insira **videoCoreInterface**.
   + Em **Resource type**, selecione **Device**.
   + Em **Caminho do dispositivo local**, insira **/dev/vchiq**.
   + Em ‭‬**Permissões do proprietário do grupo do sistema e ‬‬ de acesso a ‭arquivos‭**‬, selecione **‭Adicionar automaticamente permissões de sistema de arquivos do grupo do sistema que é proprietário do recurso**‭.‬‬‬‬‬‬‬‬ 

1. Na parte inferior da página, selecione **Adicionar recurso**.

 

Agora, adicione o modelo de inferência como um recurso de machine learning. Esta etapa inclui o upload do pacote de modelo `squeezenet.zip` para o Amazon S3.

1. Na guia **Recursos** do seu grupo, na seção **Machine Learning**, selecione **Adicionar recurso de machine learning**.

1. Na página **Adicionar recurso de machine learning**, em **Nome do recurso**, insira **squeezenet\$1model**.

1. Em **Fonte do modelo**, selecione **Usar um modelo armazenado no S3, como um modelo otimizado por meio do compilador de aprendizado profundo**.

1. Para **S3 URI**, insira um caminho em que o bucket do S3 seja salvo. 

1.  Selecione **Browse S3 (Navegar no S3)**. Isso abre uma nova guia no console do Amazon S3. 

1.  Na guia do console do Amazon S3, faça upload do arquivo `squeezenet.zip` em um bucket do S3. Para obter informações, consulte [Como carregar arquivos e pastas em um bucket do S3?](https://docs.aws.amazon.com/AmazonS3/latest/user-guide/upload-objects.html) no *Guia do usuário do Amazon Simple Storage Service*. 
**nota**  
Para que o bucket do S3 seja acessível, o nome do bucket deve conter a string **greengrass** e o bucket deve estar na mesma região em que você usa o AWS IoT Greengrass. Selecione um nome exclusivo (como **greengrass-bucket-*user-id*-*epoch-time***). Não use ponto (`.`) no nome do bucket. 

1. Na guia AWS IoT Greengrass console, localize e escolha seu bucket do S3. Localize o arquivo `squeezenet.zip` carregado e, em seguida selecione **Select (Selecionar)**. Talvez seja necessário escolher **Refresh (Atualizar)** para atualizar a lista de buckets e arquivos disponíveis. 

1. Para **Destination path (Caminho de destino)**, insira **/greengrass-machine-learning/mxnet/squeezenet**.

   Este é o destino do modelo local no namespace de runtime do Lambda. Quando você implanta o grupo, AWS IoT Greengrass recupera o pacote do modelo de origem e, em seguida, extrai o conteúdo para o diretório especificado. O exemplo da função do Lambda para este tutorial já está configurado para usar este caminho (na variável `model_path`).

1. Em **Proprietário do grupo do sistema e permissões de acesso ao arquivo**, selecione **Sem grupo do sistema**.

1. Selecione **Adicionar recurso**.

### Usando modelos treinados em SageMaker IA
<a name="sm-models"></a>

Este tutorial usa um modelo armazenado no Amazon S3, mas você também pode usar modelos de SageMaker IA com facilidade. O AWS IoT Greengrass console tem integração de SageMaker IA integrada, então você não precisa fazer o upload manual desses modelos para o Amazon S3. Para requisitos e limitações do uso de modelos de SageMaker IA, consulte[Fontes de modelo compatíveis](ml-inference.md#supported-model-sources).

Para usar um modelo de SageMaker IA:
+ Em **Fonte do modelo**, escolha **Usar um modelo treinado em AWS SageMaker IA** e, em seguida, escolha o nome do trabalho de treinamento do modelo.
+ Em **Caminho de destino**, insira o caminho para o diretório em que sua função do Lambda procura o modelo.

## Etapa 7: Adicionar uma assinatura ao grupo do Greengrass
<a name="ml-console-add-subscription"></a>

Nesta etapa, adicione uma assinatura ao grupo. Essa assinatura permite que a função Lambda envie resultados de previsão AWS IoT publicando em um tópico do MQTT.

1. Na página de configuração do grupo, selecione a guia **Assinaturas** e, em seguida, **Adicionar assinatura**.

1. Na página de **Detalhes da assinatura**, configure a origem e o destino, da seguinte forma:

   1. Em **Tipo de fonte**, escolha **Função Lambda** e, em seguida, escolha. **greengrassObjectClassification**

   1. Em **Tipo de destino**, selecione **Serviços** e, em seguida, **IoT Cloud**.

1. Em **Filtro de tópicos**, insira **hello/world** e, em seguida, selecione **Criar assinatura**.

## Etapa 8: Implantar o grupo do Greengrass
<a name="ml-console-deploy-group"></a>

Nesta etapa, implante a versão atual da definição do grupo ao dispositivo de núcleo do Greengrass. A definição contém a função do Lambda, recursos e configurações de inscrição que você adicionou.

1. Certifique-se de que o AWS IoT Greengrass núcleo esteja funcionando. Execute os seguintes comandos no seu terminal do Raspberry Pi, conforme necessário.

   1. Para verificar se o daemon está em execução:

      ```
      ps aux | grep -E 'greengrass.*daemon'
      ```

      Se a saída contém uma entrada `root` para `/greengrass/ggc/packages/1.11.6/bin/daemon`, o daemon está em execução.
**nota**  
A versão no caminho depende da versão do software AWS IoT Greengrass principal que está instalada em seu dispositivo principal.

   1. Para iniciar o daemon:

      ```
      cd /greengrass/ggc/core/
      sudo ./greengrassd start
      ```

1. Na página de configuração do grupo, selecione **Implantar**.  
![\[A página do grupo com Deployments (Implantações) e Deploy (Implantar) em destaque.\]](http://docs.aws.amazon.com/pt_br/greengrass/v1/developerguide/images/console-group-deployments-deploy.png)

1. Na guia **Funções do Lambda**, na seção **Funções do sistema Lambda**, selecione **Detector de IP** e, em seguida selecione **Editar**.

1. Na caixa de diálogo **Editar configurações do detector IP**, selecione **Detectar e substituir automaticamente os endpoints do corretor MQTT**.

1. Selecione **Salvar**.

   Isso permite que os dispositivos adquiram automaticamente as informações de conectividade para o núcleo, como endereço IP, DNS e o número da porta. A detecção automática é recomendada, mas AWS IoT Greengrass também oferece suporte a endpoints especificados manualmente. Você só é solicitado pelo método de descoberta na primeira vez em que o grupo for implantado.
**nota**  
Se solicitado, conceda permissão para criar a função de [serviço do Greengrass](service-role.md) e associá-la à Conta da AWS sua na atual. Região da AWS Essa função permite AWS IoT Greengrass acessar seus recursos em AWS serviços.

   A página **Deployments** mostra a data e hora, ID de versão e status da implantação. Quando concluída, o status exibido para a implantação deve ser **Concluída**.

   Para obter mais informações sobre implantações, consulte [Implante AWS IoT Greengrass grupos em um AWS IoT Greengrass núcleo](deployments.md). Para obter ajuda sobre a solução de problemas, consulte [Solução de problemas AWS IoT Greengrass](gg-troubleshooting.md).

## Etapa 9: Testar o aplicativo de inferência
<a name="ml-console-test-app"></a>

Agora você pode verificar se a implementação foi configurada corretamente. Para testar, inscreva-se no tópico `hello/world` e visualize os resultados de previsões publicados pela função do Lambda.

**nota**  
Se um monitor estiver conectado ao Raspberry Pi, o feed da câmera ao vivo será exibido em uma janela de visualização.

1. No AWS IoT console, em **Teste**, escolha **Cliente de teste MQTT**.

1. Para **Subscriptions**, use os seguintes valores:
   + No tópico de assinatura, use hello/world.
   + Em **Configuração adicional**, para **Exibição da carga útil do MQTT**, selecione **Exibir cargas úteis como strings**.

1. Selecione **Subscribe**.

   Se o teste for bem-sucedido, as mensagens da função do função do Lambda serão exibidas na parte inferior da página. Cada mensagem contém os cinco principais resultados de previsão da imagem, usando o formato: probabilidade, ID da classe prevista e nome da classe correspondente.  
![\[A página Subscriptions (Inscrições) mostrando resultados de teste com dados de mensagem.\]](http://docs.aws.amazon.com/pt_br/greengrass/v1/developerguide/images/ml-inference/prediction-results.png)

### Solução de problemas de inferência AWS IoT Greengrass de ML
<a name="ml-inference-troubleshooting"></a>

Se o teste não for bem-sucedido, você poderá tentar as etapas de solução de problemas a seguir. Execute os comandos no seu terminal Raspberry Pi.

#### Verificar logs de erros
<a name="troubleshooting-check-logs"></a>

1. <a name="root-access-logs"></a>Alterne para o usuário raiz e navegue até o diretório `log`. O acesso aos AWS IoT Greengrass registros requer permissões de root.

   ```
   sudo su
   cd /greengrass/ggc/var/log
   ```

1. No diretório `system`, verifique `runtime.log` ou `python_runtime.log`.

   No diretório `user/region/account-id`, verifique `greengrassObjectClassification.log`.

   Para obter mais informações, consulte [Solução de problemas com logs](gg-troubleshooting.md#troubleshooting-logs).

##### Erro "Unpacking" em runtime.log
<a name="troubleshooting-targz-unpacking"></a>

Se `runtime.log` contiver um erro semelhante ao seguinte, verifique se o pacote de modelos de origem `tar.gz` tem um diretório pai.

```
Greengrass deployment error: unable to download the artifact model-arn: Error while processing. 
Error while unpacking the file from /tmp/greengrass/artifacts/model-arn/path to /greengrass/ggc/deployment/path/model-arn,
error: open /greengrass/ggc/deployment/path/model-arn/squeezenet/squeezenet_v1.1-0000.params: no such file or directory
```

Se seu pacote não tiver um diretório pai que contenha os arquivos de modelo, use o comando a seguir para tentar empacotar o modelo novamente:

```
tar -zcvf model.tar.gz ./model
```

Por exemplo:

```
─$ tar -zcvf test.tar.gz ./test
./test
./test/some.file
./test/some.file2
./test/some.file3
```

**nota**  
Não inclui caracteres `/*` finais neste comando.

 

#### Verifique se a função do Lambda é implantada com sucesso
<a name="troubleshooting-check-lambda"></a>

1. Liste o conteúdo do Lambda implementado no diretório `/lambda`. Substitua os valores de espaço reservado antes de executar o comando.

   ```
   cd /greengrass/ggc/deployment/lambda/arn:aws:lambda:region:account:function:function-name:function-version
   ls -la
   ```

1. Verifique se o diretório contém o mesmo conteúdo do pacote de implantação `greengrassObjectClassification.zip` que você carregou no [Etapa 4: Crie e publique uma função do Lambda](#ml-console-create-lambda).

   Verifique se os arquivos `.py` e as dependências estão na raiz do diretório.

 

#### Verifique se o modelo de inferência é implantado com sucesso
<a name="troubleshooting-check-model"></a>

1. Encontre o número de identificação de processo (PID) do runtime do Lambda:

   ```
   ps aux | grep 'lambda-function-name*'
   ```

   Na saída, o PID aparece na segunda coluna da linha para o processo de runtime do Lambda.

1. Digite o namespace de runtime do Lambda. Certifique-se de substituir o *pid* valor do espaço reservado antes de executar o comando.
**nota**  
Este diretório e seu conteúdo estão no namespace de runtime do Lambda para que não sejam visíveis em um namespace comum do Linux.

   ```
   sudo nsenter -t pid -m /bin/bash
   ```

1. Liste o conteúdo do diretório local que você especificou para o recurso de ML.

   ```
   cd /greengrass-machine-learning/mxnet/squeezenet/
   ls -ls
   ```

   Você deve ver os arquivos a seguir:

   ```
   32 -rw-r--r-- 1 ggc_user ggc_group   31675 Nov 18 15:19 synset.txt
   32 -rw-r--r-- 1 ggc_user ggc_group   28707 Nov 18 15:19 squeezenet_v1.1-symbol.json
   4832 -rw-r--r-- 1 ggc_user ggc_group 4945062 Nov 18 15:19 squeezenet_v1.1-0000.params
   ```

## Próximas etapas
<a name="next-steps"></a>

Em seguida, explore outros aplicativos de inferência. AWS IoT Greengrass fornece outras funções do Lambda que você pode usar para testar a inferência local. Você pode encontrar o pacote de exemplos na pasta de bibliotecas pré-compiladas que você obteve por download [Etapa 2: instalar a MXNet estrutura](#install-mxnet).

## Como configurar um Intel Atom
<a name="atom-lambda-config"></a>

 Para executar este tutorial em um dispositivo Intel Atom, você deve fornecer imagens de origem, configurar a função do Lambda e adicionar outro recurso de dispositivo local. Para usar a GPU para inferência, verifique se o software a seguir está instalado no dispositivo:
+ OpenCL versão 1.0 ou posterior
+ Python 3.7 e pip
**nota**  
Se o dispositivo for pré-construído com o Python 3.6, você poderá criar um symlink para o Python 3.7. Para obter mais informações, consulte [Step 2](#python-symlink).
+ [NumPy](https://pypi.org/project/numpy/)
+ [OpenCV sobre rodas](https://pypi.org/project/opencv-python/)

1. Faça download de imagens PNG ou JPG estáticas para a função do Lambda para usá-las na classificação de imagens. O exemplo funciona melhor com arquivos de imagem pequenos. 

   Salve os arquivos de imagem no diretório que contém o arquivo `greengrassObjectClassification.py` (ou em um subdiretório desse diretório). Isso está no pacote de implantação da função do Lambda do qual você fez upload em [Etapa 4: Crie e publique uma função do Lambda](#ml-console-create-lambda).
**nota**  
 Se estiver usando AWS DeepLens, você pode usar a câmera integrada ou montar sua própria câmera para realizar inferência em imagens capturadas em vez de imagens estáticas. No entanto, recomendamos que você comece com imagens estáticas primeiro.   
Se utilizar uma câmara, verifique se o pacote APT `awscam` está instalado e atualizado. Para mais informações, consulte [Atualizar seu dispositivo AWS DeepLens](https://docs.aws.amazon.com/deeplens/latest/dg/deeplens-manual-updates.html) no *Guia do desenvolvedor AWS DeepLens *.

1. <a name="python-symlink"></a>Se você não estiver usando o Python 3.7, crie um symlink do Python 3.x para o Python 3.7. Isso configura seu dispositivo para usar o Python 3 com. AWS IoT Greengrass Execute o seguinte comando para localizar a instalação do Python:

   ```
   which python3
   ```

   Execute o comando a seguir para criar o symlink:

   ```
   sudo ln -s path-to-python-3.x/python3.x path-to-python-3.7/python3.7
   ```

   Reinicie o dispositivo.

1. Edite a configuração da função do Lambda. Siga o procedimento em [Etapa 5: adicionar a função do Lambda ao grupo do Greengrass](#ml-console-config-lambda). 
**nota**  
 Recomendamos que você execute sua função do Lambda sem conteinerização, a menos que seu caso de negócios faça essa exigência. Isso ajuda a habilitar o acesso à GPU e à câmera do seu dispositivo sem configurar os recursos do dispositivo. Se você executa sem conteinerização, também deve conceder acesso root às suas funções do Lambda AWS IoT Greengrass . 

   1. **Para executar sem conteinerização:**
      + Para **Usuário e grupo do sistema**, selecione **Another user ID/group ID**. Para **ID de usuário do sistema**, insira **0**. Para **ID do grupo do sistema**, insira **0**.

        Isso permite que sua função do Lambda seja executada como root. Para obter mais informações sobre como executar como raiz, consulte [Definir a identidade de acesso padrão para as funções do Lambda em um grupo](lambda-group-config.md#lambda-access-identity-groupsettings).
**dica**  
Você também deve atualizar seu arquivo `config.json` para conceder acesso root à sua função do Lambda. Para o procedimento, consulte [Executar uma função do Lambda como raiz](lambda-group-config.md#lambda-running-as-root).
      + Para **Conteinerização da função do Lambda**, selecione **Sem contêiner**.

        Para obter mais informações sobre como executar sem conteinerização, consulte [Considerações ao escolher a conteinerização de função do Lambda](lambda-group-config.md#lambda-containerization-considerations).
      + Atualize o valor de **Tempo limite** para 5 segundos. Isso garante que a solicitação não expire muito cedo. Leva alguns minutos para que a inferência seja executada após a configuração.
      + Em **Fixado**, selecione **Verdadeiro**.
      + Em **Parâmetros adicionais**, para **Acesso de leitura ao diretório /sys)**, selecione **Habilitado**. 
      +  Em **Lambda lifecycle (Ciclo de vida Lambda)**, selecione **Make this function long-lived and keep it running indefinitely (Definir esta função de longa duração e mantê-la em execução indefinidamente)**. 

   1.  **Em vez disso, para executar no modo conteinerizado:** 
**nota**  
Não recomendamos a execução no modo conteinerizado, a menos que seu caso de negócios faça essa exigência.
      + Atualize o valor de **Tempo limite** para 5 segundos. Isso garante que a solicitação não expire muito cedo. Leva alguns minutos para que a inferência seja executada após a configuração.
      +  Para **Fixado**, selecione **Verdadeiro**. 
      + Em **Parâmetros adicionais**, para **Acesso de leitura ao diretório /sys**, selecione **Habilitado**. 

1. **Se estiver executando no modo conteinerizado**, adicione o recurso de dispositivo local necessário para conceder acesso à GPU do seu dispositivo.
**nota**  
Se você executar no modo não conteinerizado, AWS IoT Greengrass poderá acessar a GPU do seu dispositivo sem configurar os recursos do dispositivo. 

   1. Na página de configuração do grupo, selecione a guia **Recursos**.

   1. Selecione **Adicionar recurso local**.

   1. Defina o recurso:
      + Em **Resource Name (Nome do recurso)**, insira **renderD128**.
      + Em **Tipo de recurso**, selecione **Dispositivo local**.
      + Em **Device path (Caminho do dispositivo)**, insira **/dev/dri/renderD128**.
      + Em ‭‬**Permissões do proprietário do grupo do sistema e ‬‬ de acesso a ‭arquivos‭**‬, selecione **‭Adicionar automaticamente permissões de sistema de arquivos do grupo do sistema que é proprietário do recurso**‭.‬‬‬‬‬‬‬‬
      + Para **Afiliações da função do Lambda**, conceda a permissão **Acesso para leitura e gravação** para sua função Lambda.

## Configurando um NVIDIA Jetson TX2
<a name="jetson-lambda-config"></a>

Para executar este tutorial em um NVIDIA Jetson TX2, forneça imagens de origem e configure a função Lambda. Se estiver usando a GPU, você também deverá adicionar recursos do dispositivo local.

1.  Certifique-se de que seu dispositivo Jetson esteja configurado para que você possa instalar o software AWS IoT Greengrass Core. Para obter mais informações sobre como configurar seu projeto, consulte [Configurar outros dispositivos](setup-filter.other.md). 

1. Abra a MXNet documentação, acesse [Instalando MXNet em um Jetson](https://mxnet.apache.org/get_started/jetson_setup) e siga as instruções para instalar MXNet no dispositivo Jetson.
**nota**  
 Se você quiser criar a MXNet partir do código-fonte, siga as instruções para criar a biblioteca compartilhada. Edite as seguintes configurações em seu `config.mk` arquivo para trabalhar com um TX2 dispositivo Jetson:   
Adicione `-gencode arch=compute-62, code=sm_62` à `CUDA_ARCH` configuração.
Ligue o CUDA.  

     ```
     USE_CUDA = 1
     ```

1. Faça download de imagens PNG ou JPG estáticas para a função do Lambda para usá-las na classificação de imagens. O aplicativo funciona melhor com arquivos de imagem pequenos. Se preferir, é possível instrumentar uma câmera na placa Jetson para capturar as imagens de origem.

   Salve seus arquivos de imagem no diretório que contém o arquivo `greengrassObjectClassification.py`. Você também pode salvá-los em um subdiretório desse diretório. Esse diretório está no pacote de implantação da função do Lambda do qual você fez upload em [Etapa 4: Crie e publique uma função do Lambda](#ml-console-create-lambda).

1. Crie um link simbólico do Python 3.7 para o Python 3.6 para usar o Python 3 com o. AWS IoT Greengrass Execute o seguinte comando para localizar a instalação do Python:

   ```
   which python3
   ```

   Execute o comando a seguir para criar o symlink:

   ```
   sudo ln -s path-to-python-3.6/python3.6 path-to-python-3.7/python3.7
   ```

   Reinicie o dispositivo.

1. Certifique-se de que a conta `ggc_user` do sistema possa usar a MXNet estrutura:

   ```
   “sudo -u ggc_user bash -c 'python3 -c "import mxnet"'
   ```

1. Edite a configuração da função do Lambda. Siga o procedimento em [Etapa 5: adicionar a função do Lambda ao grupo do Greengrass](#ml-console-config-lambda).
**nota**  
 Recomendamos que você execute sua função do Lambda sem conteinerização, a menos que seu caso de negócios faça essa exigência. Isso ajuda a habilitar o acesso à GPU e à câmera do seu dispositivo sem configurar os recursos do dispositivo. Se você executa sem conteinerização, também deve conceder acesso root às suas funções do Lambda AWS IoT Greengrass . 

   1. **Para executar sem conteinerização:**
      + Para **Usuário e grupo do sistema**, selecione **Another user ID/group ID**. Para **ID de usuário do sistema**, insira **0**. Para **ID do grupo do sistema**, insira **0**.

        Isso permite que sua função do Lambda seja executada como root. Para obter mais informações sobre como executar como raiz, consulte [Definir a identidade de acesso padrão para as funções do Lambda em um grupo](lambda-group-config.md#lambda-access-identity-groupsettings).
**dica**  
Você também deve atualizar seu arquivo `config.json` para conceder acesso root à sua função do Lambda. Para o procedimento, consulte [Executar uma função do Lambda como raiz](lambda-group-config.md#lambda-running-as-root).
      + Para **conteinerização da função do Lambda**, selecione **Sem contêiner**.

        Para obter mais informações sobre como executar sem conteinerização, consulte [Considerações ao escolher a conteinerização de função do Lambda](lambda-group-config.md#lambda-containerization-considerations).
      + Em **Parâmetros adicionais**, para **Acesso de leitura ao diretório /sys**, selecione **Habilitado**. 
      +  Em **Variáveis de ambiente**, adicione os seguintes pares chave-valor à sua função do Lambda. Isso configura AWS IoT Greengrass para usar a MXNet estrutura.     
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v1/developerguide/ml-console.html)

   1.  **Em vez disso, para executar no modo conteinerizado:** 
**nota**  
Não recomendamos a execução no modo conteinerizado, a menos que seu caso de negócios faça essa exigência.
      + Aumente o valor de **Memory limit (Limite de memória)**. Use 500 MB para a CPU ou pelo menos 2000 MB para a GPU. 
      + Em **Parâmetros adicionais**, para **Acesso de leitura ao diretório /sys**, selecione **Habilitado**. 
      +  Em **Variáveis de ambiente**, adicione os seguintes pares chave-valor à sua função do Lambda. Isso configura AWS IoT Greengrass para usar a MXNet estrutura.     
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v1/developerguide/ml-console.html)

1. **Se estiver executando no modo conteinerizado**, adicione os recursos de dispositivo local a seguir para conceder acesso à GPU do seu dispositivo. Siga o procedimento em [Etapa 6: Adicionar recursos ao grupo do Greengrass](#ml-console-add-resources).
**nota**  
 Se você executar no modo não conteinerizado, AWS IoT Greengrass poderá acessar a GPU do seu dispositivo sem configurar os recursos do dispositivo. 

   Para cada recurso:
   + Em **Resource type**, selecione **Device**.
   + Em **Permissões do proprietário do grupo do sistema e de acesso a arquivos**, selecione **Adicionar automaticamente permissões de sistema de arquivos do grupo do sistema que é proprietário do recurso**.

          
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v1/developerguide/ml-console.html)

1. **Se estiver executando no modo conteinerizado**, adicione o recurso de volume local a seguir para conceder acesso à câmera do seu dispositivo. Siga o procedimento em [Etapa 6: Adicionar recursos ao grupo do Greengrass](#ml-console-add-resources).
**nota**  
 Se você executar no modo não conteinerizado, AWS IoT Greengrass poderá acessar a câmera do seu dispositivo sem configurar os recursos de volume. 
   + Em **Tipo de recurso**, selecione **Volume**.
   + Em **Permissões do proprietário do grupo do sistema e de acesso a arquivos**, selecione **Adicionar automaticamente permissões de sistema de arquivos do grupo do sistema que é proprietário do recurso**.

          
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v1/developerguide/ml-console.html)