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á.
# Conceitos básicos de conectores do Greengrass (console)
Esse recurso está disponível para AWS IoT Greengrass Core v1.7 e versões posteriores.
Este tutorial mostra como usar o Console de gerenciamento da AWS para trabalhar com conectores.
Use conectores para acelerar o ciclo de vida de desenvolvimento. Os conectores são módulos pré-criados e reutilizáveis que podem facilitar a interação com serviços, protocolos e recursos. Eles podem ajudar você a implantar a lógica de negócios para Dispositivos Greengrass mais rapidamente. Para obter mais informações, consulte [Integrar a serviços e protocolos usando conectores do Greengrass](connectors.md).
Neste tutorial, você configura e implanta o conector de [notificações do Twilio](twilio-notifications-connector.md). O conector recebe informações de mensagem do Twilio como dados de entrada e aciona uma mensagem de texto do Twilio. O fluxo de dados é exibido no diagrama a seguir.
![\[Fluxo de dados da função do Lambda para o conector de notificações do Twilio para o Twilio.\]](http://docs.aws.amazon.com/pt_br/greengrass/v1/developerguide/images/connectors/twilio-solution.png)
Depois de configurar o conector, crie uma função do Lambda e uma assinatura.
+ A função avalia os dados simulados do sensor de temperatura. Ele publica, de forma condicional, as informações de mensagem do Twilio para um tópico MQTT. Esse é o tópico que o conector assina.
+ A assinatura permite que a função publique no tópico e que o conector receba os dados do tópico.
O conector de notificações do Twilio exige um token de autenticação do Twilio para interagir com a API do Twilio. O token é um segredo de tipo de texto criado AWS Secrets Manager e referenciado a partir de um recurso de grupo. Isso permite AWS IoT Greengrass criar uma cópia local do segredo no núcleo do Greengrass, onde ele é criptografado e disponibilizado para o conector. Para obter mais informações, consulte [Implante segredos até o AWS IoT Greengrass âmago](secrets.md).
O tutorial contém as seguintes etapas de nível elevado:
1. [Crie um segredo do Secrets Manager](#connectors-console-create-secret)
1. [Adicionar um recurso de segredo a um grupo](#connectors-console-create-resource)
1. [Adicionar um conector ao grupo](#connectors-console-create-connector)
1. [Crie um pacote de implantação para a função do Lambda](#connectors-console-create-deployment-package)
1. [Criar uma função do Lambda](#connectors-console-create-function)
1. [Adicionar uma função ao grupo](#connectors-console-create-gg-function)
1. [Adicionar assinaturas ao grupo](#connectors-console-create-subscription)
1. [Implantar o grupo](#connectors-console-create-deployment)
1. [Testar a solução](#connectors-console-test-solution)
O tutorial levará aproximadamente 20 minutos para ser concluído.
## Pré-requisitos
Para concluir este tutorial, é necessário:
+ Um grupo do Greengrass e um núcleo do Greengrass (versão 1.9.3 ou posterior). Para saber como criar um grupo e núcleo Greengrass, consulte [Começando com AWS IoT Greengrass](gg-gs.md). O tutorial Conceitos básicos também inclui etapas para instalar o software do núcleo do AWS IoT Greengrass .
+ Python 3.7 instalado no dispositivo principal AWS IoT Greengrass .
+ AWS IoT Greengrass deve ser configurado para oferecer suporte a segredos locais, conforme descrito em [Requisitos de segredos](secrets.md#secrets-reqs).
**nota**
Este requisito inclui permitir o acesso aos seus segredos do Secrets Manager. Se você estiver usando a função de serviço padrão do Greengrass, o Greengrass terá permissão para obter os valores de segredos com nomes que começam com *greengrass-*.
+ Um SID da conta do Twilio, um token de autorização e um número de telefone habilitado para Twilio. Depois de criar um projeto do Twilio, esses valores estarão disponíveis no painel do projeto.
**nota**
Você pode usar uma conta de teste do Twilio. Se você estiver usando uma conta de teste, você deve adicionar números de telefone que não são de destinatários do Twilio a uma lista de números de telefone verificados. Para obter mais informações, consulte [Como trabalhar com a sua conta de teste gratuita do Twilio](https://www.twilio.com/docs/usage/tutorials/how-to-use-your-free-trial-account).
## Etapa 1: Criar um segredo do Secrets Manager
Nesta etapa, você usa o AWS Secrets Manager console para criar um segredo de tipo de texto para seu token de autenticação do Twilio.
1. Faça login no [console do AWS Secrets Manager](https://console.aws.amazon.com/secretsmanager/).
**nota**
Para obter mais informações sobre esse processo, consulte [Etapa 1: Criar e armazenar seu segredo no AWS Secrets Manager](https://docs.aws.amazon.com/secretsmanager/latest/userguide/tutorials_basic.html) no *Guia do usuário do AWS Secrets Manager *.
1. Selecione **Armazenar um novo segredo**.
1. Em **Escolher tipo de segredo**, selecione **Outro tipo de segredo**.
1. Em **Especificar os key/value pares a serem armazenados para esse segredo**, na guia **Texto simples**, insira seu token de autenticação do Twilio. Remova toda a formatação JSON e insira apenas o valor do token.
1. Mantenha **aws/secretsmanager** selecionado para a chave de criptografia e selecione **Avançar**.
**nota**
Você não será cobrado AWS KMS se usar a chave AWS gerenciada padrão que o Secrets Manager cria em sua conta.
1. Em **Secret name**, digite **greengrass-TwilioAuthToken** e selecione **Next**.
**nota**
Por padrão, a função de serviço do Greengrass permite AWS IoT Greengrass obter o valor de segredos com nomes que começam com *greengrass* -. Para obter mais informações, consulte os [requisitos de segredos](secrets.md#secrets-reqs).
1. A alternância não é necessária neste tutorial, portanto, selecione Desabilitar a alternância automática e, em seguida, **Avançar**.
1. Na página **Review (Revisar)**, revise as configurações e selecione **Store (Armazenar)**.
Em seguida, crie um recurso de segredo no seu grupo do Greengrass que faz referência ao segredo.
## Etapa 2: Adicionar um recurso de segredo a um grupo do Greengrass
Nesta etapa, você adiciona um *recurso de segredo* ao grupo do Greengrass. Esse recurso é uma referência ao segredo que você criou na etapa anterior.
1. No painel de navegação do AWS IoT console, em **Gerenciar**, expanda dispositivos **Greengrass** e **escolha Grupos (**V1).
1. Selecione o grupo ao qual você deseja adicionar o recurso de segredo.
1. Na página de configuração do grupo, selecione a guia **Recursos** e, em seguida, role para baixo até a seção **Segredos**. A seção **Segredos** exibe os recursos de segredos que pertencem ao grupo. Você pode adicionar, editar e remover recursos de segredos nessa seção.
**nota**
Como alternativa, o console permite que você crie um segredo e um recurso de segredo ao configurar um conector ou uma função do Lambda. Você pode fazer isso na página **Configurar parâmetros** do conector ou na página **Recursos** da função do Lambda.
1. Selecione **Adicionar** na seção **Segredos**.
1. Na página **Adicionar um recurso de segredo**, insira **MyTwilioAuthToken** em **Nome do recurso**.
1. Para o **segredo**, escolha **greengrass-. TwilioAuthToken**
1. Na seção **Selecionar rótulos (opcional)**, o rótulo AWSCURRENT intermediário representa a versão mais recente do segredo. Esse rótulo é sempre incluído em um recurso de segredo.
**nota**
Este tutorial requer somente o AWSCURRENT rótulo. Você também pode incluir rótulos que a função do Lambda ou o connector exige.
1. Selecione **Adicionar recurso**.
## Etapa 3: Adicionar um conector ao grupo do Greengrass
Nesta etapa, você configura parâmetros para o [conector de notificações Twilio](twilio-notifications-connector.md) e o adiciona ao grupo.
1. Na página de configuração do grupo, selecione **Connectors** e, em seguida, **Add a connector**.
1. Na página **Adicionar conector**, selecione **Notificações do Twilio**.
1. Selecione a versão .
1. Na seção **Configuração**:
+ Para **Recurso de token de autenticação do Twilio**, insira o recurso que você criou na etapa anterior.
**nota**
Quando você insere o recurso, a propriedade **ARN of Twilio auth token secret** é preenchida para você.
+ Para **Default from phone number**, insira seu número de telefone habilitado para Twilio.
+ Para **Twilio account SID**, insira seu SID da conta do Twilio.
1. Selecione **Adicionar recurso**.
## Etapa 4: crie um pacote de implantação para a função do Lambda
Para criar uma função do Lambda, você deve, primeiro, criar um *pacote de implantação* da função do Lambda que contenha o código da função e as dependências. As funções do Lambda do Greengrass exigem o [ SDK do AWS IoT Greengrass Core](lambda-functions.md#lambda-sdks-core) para tarefas como comunicação com mensagens MQTT no ambiente de núcleo e acesso a segredos locais. Este tutorial cria uma função Python, então você usa a versão Python do SDK no pacote de implantação.
1. Na página de downloads do [AWS IoT Greengrass Core SDK](what-is-gg.md#gg-core-sdk-download), baixe o AWS IoT Greengrass Core SDK para Python em seu computador.
1. Descompacte o pacote obtido por download para obter o SDK. O SDK é a pasta do `greengrasssdk`.
1. Salve a seguinte função do código Python em um arquivo local denominado `temp_monitor.py`.
```
import greengrasssdk
import json
import random
client = greengrasssdk.client('iot-data')
# publish to the Twilio Notifications connector through the twilio/txt topic
def function_handler(event, context):
temp = event['temperature']
# check the temperature
# if greater than 30C, send a notification
if temp > 30:
data = build_request(event)
client.publish(topic='twilio/txt', payload=json.dumps(data))
print('published:' + str(data))
print('temperature:' + str(temp))
return
# build the Twilio request from the input data
def build_request(event):
to_name = event['to_name']
to_number = event['to_number']
temp_report = 'temperature:' + str(event['temperature'])
return {
"request": {
"recipient": {
"name": to_name,
"phone_number": to_number,
"message": temp_report
}
},
"id": "request_" + str(random.randint(1,101))
}
```
1. Comprima os seguintes itens em um arquivo denominado `temp_monitor_python.zip`. Ao criar o arquivo ZIP, inclua apenas o código e suas dependências, e não a pasta que contém os arquivos.
+ **temp\$1monitor.py**. Lógica do aplicativo.
+ **greengrasssdk**. Biblioteca necessária para funções Python do Lambda do Greengrass que publicam mensagens MQTT.
Esse é o pacote de implantação de sua função do Lambda.
Agora, crie uma função do Lambda que usa o pacote de implantação.
## Etapa 5: criar uma função Lambda no console AWS Lambda
Nesta etapa, você usa o AWS Lambda console para criar uma função Lambda e configurá-la para usar seu pacote de implantação. Depois, publique uma versão da função e crie um alias.
1. Primeiro, crie a função do Lambda.
1. No Console de gerenciamento da AWS, escolha **Serviços** e abra o AWS Lambda console.
1. Selecione **Criar função** e, em seguida, selecione **Criar do zero**.
1. Na seção **Basic information (Informações básicas)**, use os seguintes valores:
+ Em **Function name** (Nome da função), insira **TempMonitor**.
+ 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. Na parte inferior da página, selecione **Create function**.
1. Em seguida, registre o manipulador e faça upload do seu pacote de implantação da função do Lambda.
1. 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 `temp_monitor_python.zip`. Selecione **Salvar**.
1. 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 **temp\$1monitor.function\$1handler**.
1. Escolha **Salvar**.
**nota**
O botão **Testar** no AWS Lambda console não funciona com essa função. O SDK AWS IoT Greengrass principal não contém módulos necessários para executar suas funções do Greengrass Lambda de forma independente no console. AWS Lambda Esses módulos (por exemplo, `greengrass_common`) são fornecidos às funções depois de serem implantados no núcleo do Greengrass.
1. Agora, publique a primeira versão da sua função do Lambda e 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**.
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 **TempMonitor: 1**, no menu **Ações**, escolha **Criar alias**.
1. Na página **Create a new alias**, use os seguintes valores:
+ Em **Nome**, digite **GG\$1TempMonitor**.
+ Em **Version**, selecione **1**.
**nota**
AWS IoT Greengrass **não oferece suporte a aliases Lambda para as versões \$1LATEST.**
1. Selecione **Create** (Criar).
Agora você está pronto para adicionar a função do Lambda ao seu grupo do Greengrass.
## Etapa 6: Adicionar uma função do Lambda ao grupo do Greengrass
Nesta etapa, você adiciona a função do Lambda ao grupo e configura o ciclo de vida e as variáveis de ambiente. Para obter mais informações, consulte [Controlar a execução de funções do Lambda do Greengrass usando a configuração específica do grupo](lambda-group-config.md).
1. Na página de configuração do grupo, selecione a guia **Funções do Lambda**.
1. Em **Minhas funções do Lambda**, selecione **Adicionar**.
1. Na página **Adicionar função Lambda, escolha **TempMonitor**sua função** Lambda.
1. Para a **versão da função Lambda**, escolha **Alias**: GG\$1. TempMonitor
1. Selecione **Adicionar função do Lambda**.
## Etapa 7: Adicionar assinaturas ao grupo do Greengrass
Nesta etapa, adicione uma assinatura que permita que a função do Lambda envie dados de entrada para o conector. O conector define os tópicos MQTT que assina, para que essa assinatura use um dos tópicos. Esse é o mesmo tópico no qual a função de exemplo publica.
Para este tutorial, você também cria assinaturas que permitem que a função receba leituras simuladas de temperatura AWS IoT e receba informações de status do conector. AWS IoT
1. Na página de configuração do grupo, selecione a guia **Assinaturas** e, em seguida, **Adicionar assinatura**.
1. Na página **Criar uma assinatura**, configure a origem e o destino, da seguinte forma:
1. Em **Tipo de fonte**, escolha **Função Lambda** e, em seguida, escolha. **TempMonitor**
1. Em **Tipo de destino**, selecione **Conector** e, em seguida, selecione **Notificações Twilio**.
1. Para o **Filtro de tópico**, insira **twilio/txt**.
1. Selecione **Criar assinatura**.
1. Repita as etapas 1 a 4 para criar uma assinatura que permita AWS IoT publicar mensagens na função.
1. Para **Tipo de origem**, selecione **Serviço** e, em seguida, selecione **IoT Cloud**.
1. Em **Selecionar um alvo**, escolha **Função Lambda** e, em seguida, escolha. **TempMonitor**
1. Para **Topic filter**, insira **temperature/input**.
1. Repita as etapas 1 a 4 para criar uma assinatura que permita que o conector publique mensagens no AWS IoT.
1. Em **Tipo de origem**, selecione **Connector (Conector)** e, em seguida, selecione **Twilio Notifications (Notificações Twilio)**.
1. Para **Tipo de destino**, selecione **Serviço** e, em seguida, **IoT Cloud**.
1. Para **Topic filter (Filtro de tópico)**, **twilio/message/status** é inserido para você. Este é o tópico predefinido no qual o conector publica.
## Etapa 8: Implantar o grupo do Greengrass
Implante o grupo no dispositivo do núcleo.
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/ggc-version/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**.
1.
1. Na guia **Funções do Lambda**, na seção **Funções do Lambda do sistema**, selecione **Detector de IP** e 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 ajuda sobre a solução de problemas, consulte [Solução de problemas AWS IoT Greengrass](gg-troubleshooting.md).
**nota**
Um grupo do Greengrass só pode conter uma versão do conector por vez. Para obter informações sobre como fazer upgrade de uma versão do conector, consulte [Atualizar a versões do conector](connectors.md#upgrade-connector-versions).
## Testar a solução
1. Na página inicial do AWS IoT console, escolha **Testar**.
1. Em **Inscrever-se no tópico**, use os seguintes valores e, em seguida, selecione **Inscrever-se**. O conector de notificações do Twilio publica informações de status nesse tópico.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v1/developerguide/connectors-console.html)
1. Para **Publicar no tópico**, use os valores a seguir e, em seguida selecione **Publicar** para invocar a função.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v1/developerguide/connectors-console.html)
Se for bem-sucedido, o destinatário receberá a mensagem de texto e o console exibirá o `success` status dos [dados de saída](twilio-notifications-connector.md#twilio-notifications-connector-data-output).
Agora, altere a `temperature` na mensagem de entrada para **29** e publique. Como isso é menor que 30, a TempMonitor função não aciona uma mensagem do Twilio.
## Consulte também
+ [Integrar a serviços e protocolos usando conectores do Greengrass](connectors.md)
+ [Conectores do Greengrass fornecidos pela AWS](connectors-list.md)