Conceitos básicos de conectores do Greengrass (console)

Faça login no console do AWS Secrets Manager.

Selecione Store a new secret (Armazenar um novo segredo).

Em Escolher tipo de segredo, selecione Outro tipo de segredo.

Em Specify the key/value pairs to be stored for this secret, na guia Plaintext, insira o token de autenticação do Twilio. Remova toda a formatação JSON e insira apenas o valor do token.

Mantenha aws/secretsmanager selecionado para a chave de criptografia e selecione Avançar.

Em Secret name, digite greengrass-TwilioAuthToken e selecione Next.

A alternância não é necessária neste tutorial, portanto, selecione Desabilitar a alternância automática e, em seguida, Avançar.

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.

No painel de navegação do console de AWS IoT, em Gerenciar, expanda Dispositivos Greengrass e, em seguida selecione Grupos (V1).

Selecione o grupo ao qual você deseja adicionar o recurso de segredo.

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.

Selecione Adicionar na seção Segredos.

Na página Adicionar um recurso de segredo, insira MyTwilioAuthToken em Nome do recurso.

Em Segredo, selecione greengrass-TwilioAuthToken.

Na seção ‭‬Selecionar rótulos (Opcional)‭‬, o rótulo de preparação AWSCURRENT representa a versão mais recente do segredo.‬‬‬‬‬‬. Esse rótulo é sempre incluído em um recurso de segredo.

Selecione Adicionar recurso.

Na página de configuração do grupo, selecione Connectors e, em seguida, Add a connector.

Na página Adicionar conector, selecione Notificações do Twilio.

Selecione a versão .

Na seção Configuração:

Selecione Adicionar recurso.

Na página de downloads do SDK do AWS IoT Greengrass Core, baixe o AWS IoT Greengrass SDK do Core para Python em seu computador.

Descompacte o pacote obtido por download para obter o SDK. O SDK é a pasta do greengrasssdk.

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))
    }

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.

Esse é o pacote de implantação de sua função do Lambda.

Primeiro, crie a função do Lambda.

1. No AWS Management Console, selecione Services (Serviços) e abra o console do AWS Lambda.

2. Selecione Criar função e Criar desde o início.

3. 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 pelo AWS IoT Greengrass.

4. Na parte inferior da página, selecione Create function.

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.

   

2. Selecione Upload e, em seguida, selecione seu pacote de implantação temp_monitor_python.zip. Selecione Salvar.

3. 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_monitor.function_handler.

4. Selecione Salvar.

   nota

   O botão Testar no console do AWS Lambda não funciona com essa função. O AWS IoT GreengrassSDK do Core não contém os módulos necessários para executar suas funções do Lambda do Greengrass de forma independente no console do AWS Lambda. Esses módulos (por exemplo, greengrass_common) são fornecidos às funções depois de serem implantados no núcleo do Greengrass.

Agora, publique a primeira versão da sua função do Lambda e crie um alias para a versão.

1. No menu Actions, selecione Publish new version.

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

3. Na página de configuração TempMonitor: 1, no menu Actions, selecione Create alias.

4. Na página Create a new alias, use os seguintes valores:

   • Em Name (Nome), insira GG_TempMonitor.

   • Em Version, selecione 1.

   nota

   O AWS IoT Greengrass não oferece suporte a alias do Lambda para as versões $LATEST.

5. Selecione Create (Criar).

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

Em Minhas funções do Lambda, selecione Adicionar.

Na página Adicionar função do Lambda, selecione TempMonitor para a sua função do Lambda.

Em Versão da função do Lambda, selecione Alias: GG_TempMonitor.

Selecione Adicionar função do Lambda.

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

Na página Criar uma assinatura, configure a origem e o destino, da seguinte forma:

1. Em Tipo de origem, selecione Função do Lambda e, em seguida, TempMonitor.

2. Em Tipo de destino, selecione Conector e, em seguida, selecione Notificações Twilio.

Para o Filtro de tópico, insira twilio/txt.

Selecione Create subscription.

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.

2. Para Selecionar uma origem, selecione Função do Lambda e, em seguida, TempMonitor.

3. Para Topic filter, insira temperature/input.

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

2. Para Tipo de destino, selecione Serviço e, em seguida, IoT Cloud.

3. Para Topic filter (Filtro de tópico), twilio/message/status é inserido para você. Este é o tópico predefinido no qual o conector publica.

Verifique se o núcleo AWS IoT Greengrass está em execução. 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 do AWS IoT Greengrass Core que foi instalada no seu dispositivo de núcleo.

2. Para iniciar o daemon:

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

Na página de configuração do grupo, selecione Implantar.

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

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

3. 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 o 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 o perfil de serviço do Greengrass e associá-lo à sua Conta da AWS na Região da AWS atual. Essa função permite que AWS IoT Greengrass acessem seus recursos nos serviços do AWS.

   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 de AWS IoT Greengrass.

Na página inicial do console do AWS IoT, selecione Testar.

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.

Para Publicar no tópico, use os valores a seguir e, em seguida selecione Publicar para invocar a função.

{
   "to_name": "recipient-name",
   "to_number": "recipient-phone-number",
   "temperature": 31
}

Se for bem-sucedido, o destinatário receberá a mensagem de texto e o console exibirá o success status dos dados de saída.

Agora, altere a temperature na mensagem de entrada para 29 e publique. Como é inferior a 30, a função TempMonitor não dispara o gatilho da mensagem do Twilio.