Conceitos básicos de conectores do Greengrass (CLI)

Primeiro, crie o segredo.

aws secretsmanager create-secret --name greengrass-TwilioAuthToken --secret-string twilio-auth-token

Copie da saída o ARN do segredo. Use-o para criar o recurso de segredo e configurar o conector de notificações do Twilio.

Crie uma definição de recurso que inclua uma versão inicial.

Copie o LatestVersionArn da definição de recurso da saída. Você usa esse valor para adicionar a versão de definição do recurso à versão de grupo que você implanta no núcleo.

Crie uma definição de conector com uma versão inicial.

Copie o LatestVersionArn da definição do conector da saída. Use esse valor para adicionar a versão da definição do conector à versão de grupo que você implanta no núcleo.

Na página de downloads do SDK do Core AWS IoT Greengrass, 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

Crie um perfil do IAM para você transmitir no ARN da função ao criar a função.

Copie a Arn da saída.

Use a API AWS Lambda para criar a função TempMonitor. O comando a seguir pressupõe que o arquivo zip esteja no diretório atual.

aws lambda create-function \
--function-name TempMonitor \
--zip-file fileb://temp_monitor_python.zip \
--role role-arn \
--handler temp_monitor.function_handler \
--runtime python3.7

Publique uma versão da função.

aws lambda publish-version --function-name TempMonitor --description 'First version'

Crie um alias para a versão publicada.

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.

aws lambda create-alias --function-name TempMonitor --name GG_TempMonitor --function-version 1

Copie a AliasArn da saída. Você usa esse valor ao configurar a função para o AWS IoT Greengrass e ao criar uma assinatura.

Crie uma definição de função que inclua uma versão inicial.

Copie a LatestVersionArn da saída. Você usa esse valor para adicionar a versão de definição da função à versão de grupo que você implanta no núcleo.

Copie a Id da saída. Você pode usar esse valor no futuro, ao atualizar a função.

Crie uma definição de assinatura que contém uma versão inicial que inclui as assinaturas.

Copie a LatestVersionArn da saída. Você usa esse valor para adicionar a versão de definição da assinatura à versão de grupo que você implanta no núcleo.

Obtenha o ID do grupo e a versão mais recente do grupo:

1. Obtenha os IDs do grupo do Greengrass de destino e a versão do grupo. Esse procedimento pressupõe que esse seja o grupo e a versão mais recente do grupo. A consulta a seguir retorna o grupo criado mais recentemente.

   aws greengrass list-groups --query "reverse(sort_by(Groups, &CreationTimestamp))[0]"

   Ou é possível consultar por nome. Os nomes de grupo não precisam ser exclusivos, portanto, vários grupos podem ser retornados.

   aws greengrass list-groups --query "Groups[?Name=='MyGroup']"

   nota

   Também é possível encontrar esses valores no console do AWS IoT. O ID do grupo é exibido na página Settings (Configurações) do grupo. Os IDs de versão do grupo são exibidos na guia Implantações do grupo.

2. Copie da saída o Id do grupo de destino. Você usa isso para obter a versão de definição de núcleo e ao implantar o grupo.

3. Copie a LatestVersion da saída, que é o ID da última versão adicionada ao grupo. Você usa isso para obter a versão de definição do núcleo.

Obtenha o ARN da versão de definição de núcleo:

1. Obtenha a versão do grupo. Para esta etapa, vamos considerar que a versão mais recente do grupo inclui uma versão de definição do núcleo.

   • Substitua group-id pelo Id que você copiou para o grupo.

   • Substitua group-version-id pelo LatestVersion que você copiou para o grupo.

   aws greengrass get-group-version \
   --group-id group-id \
   --group-version-id group-version-id

2. Copie a CoreDefinitionVersionArn da saída.

Criar uma versão de grupo.

aws greengrass create-group-version \
--group-id group-id \
--core-definition-version-arn core-definition-version-arn \
--resource-definition-version-arn resource-definition-version-arn \
--connector-definition-version-arn connector-definition-version-arn \
--function-definition-version-arn function-definition-version-arn \
--subscription-definition-version-arn subscription-definition-version-arn

Copie o valor de Version da saída. Este é o ID da versão do grupo. Você usa esse valor para implantar a versão do grupo.

Em um terminal do dispositivo de núcleo, certifique-se de que o daemon do AWS IoT Greengrass está em execução.

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.

2. Para iniciar o daemon:

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

Crie um implantação do .

aws greengrass create-deployment \
--deployment-type NewDeployment \
--group-id group-id \
--group-version-id group-version-id

Copie a DeploymentId da saída.

Obtenha o status de implantação.

aws greengrass get-deployment-status \
--group-id group-id \
--deployment-id deployment-id

Se o status for Success, a implantação foi bem-sucedida. 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 Inscreva-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.