Introducción a los conectores de Greengrass (consola)

Inicie sesión en la consola de AWS Secrets Manager.

Elija Store a new secret (Almacenar un nuevo secreto).

En Seleccionar tipo de secreto, elija Otro tipo de secretos.

En Specify the key/value pairs to be stored for this secret (Especificar los pares clave-valor que se almacenarán para este secreto), en la pestaña Plaintext (Texto no cifrado), escriba su token de autenticación de Twilio. Quite todo el formato JSON e introduzca solo el valor del token.

Mantenga aws/secretsmanager seleccionado para la clave de cifrado y, a continuación, seleccione Siguiente.

En Secret name (Nombre del secreto), escriba greengrass-TwilioAuthToken y, a continuación, seleccione Next (Siguiente).

Este tutorial no requiere rotación, así que elija desactivar la rotación automática y, a continuación, seleccione Siguiente.

En la página Review (Revisar), revise los ajustes y, a continuación, seleccione Store (Almacenar).

A continuación, se crea un recurso de secreto en su grupo de Greengrass que hace referencia al secreto.

En el panel de navegación de la consola AWS IoT, en Administrar, expanda los dispositivos Greengrass y, a continuación, elija Grupos (V1).

Elija el grupo al que desee añadir el recurso de secreto.

En la página de configuración del grupo, elija la pestaña Recursos y, a continuación, desplácese hacia abajo hasta la sección Secretos. La sección Secretos muestra los recursos secretos que pertenecen al grupo. Puede añadir, editar y quitar los recursos de secreto de esta sección.

Seleccione Añadir en la sección Secretos.

En la página Añadir un recurso secreto, introduzca MyTwilioAuthToken el nombre del recurso.

Para el secreto, elija Greengrass-TwilioAuthToken.

En la sección Seleccionar etiquetas (opcional), la etiqueta provisional AWSCURRENT representa la versión más reciente del secreto. Esta etiqueta siempre está incluida en un recurso de secreto.

Seleccione Add resource (Añadir recurso).

En la página de configuración de grupo, elija Connectors (Conectores) y, a continuación, elija Add a connector (Añadir un conector).

En la página Añadir conector, selecciona Notificaciones de Twilio.

Elija la versión .

En la sección Configuración:

Seleccione Add resource (Añadir recurso).

Desde la página de descargas del Core SDK AWS IoT Greengrass, descargue el SDK AWS IoT Greengrass básico para Python en su ordenador.

Descomprima el paquete descargado para obtener el SDK. El SDK es la carpeta greengrasssdk.

Guarde la siguiente función de código de Python en un archivo local llamado "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 en un archivo ZIP los siguientes elementos en un archivo denominado "temp_monitor_python.zip". Al crear el archivo ZIP, incluya únicamente el código y sus dependencias, no la carpeta donde se encuentran.

Este es el paquete de implementación de la función de Lambda.

Primero, cree una función de Lambda.

1. En la AWS Management Console, elija Servicios y abra la consola de AWS Lambda.

2. Elija Crear función, y, a continuación, elija Autor desde cero.

3. En la sección Basic information (Información básica), utilice los siguientes valores:

   • En Function name (Nombre de la función), introduzca TempMonitor.

   • En Runtime (Tiempo de ejecución), elija Python 3.7.

   • En Permisos, mantenga la configuración predeterminada. Esto crea un rol de ejecución que otorga permisos Lambda básicos. AWS IoT Greengrass no utiliza este rol.

4. En la parte inferior de la página, elija Create function.

A continuación, registre el controlador y cargue el paquete de implementación de la función de Lambda.

1. En la pestaña Código, en Código fuente, seleccione Cargar desde. En el menú desplegable, seleccione un archivo .zip..

   

2. Seleccione Cargar y, a continuación, elija su paquete de implementación temp_monitor_python.zip. A continuación, elija Guardar.

3. En la pestaña Código de la función, en Configuración de tiempo de ejecución, elija Editar y, a continuación, introduzca los siguientes valores.

   • En Runtime (Tiempo de ejecución), elija Python 3.7.

   • En Handler (Controlador), escriba temp_monitor.function_handler.

4. Seleccione Save.

   nota

   El botón de prueba de la consola de AWS Lambda no funciona con esta función. El SDK AWS IoT Greengrass Core no contiene los módulos necesarios para ejecutar las funciones de Lambda de Greengrass de forma independiente en la consola AWS Lambda. Estos módulos (por ejemplo, greengrass_common) se suministran a las funciones una vez desplegados en el núcleo de Greengrass.

Ahora, publique la primera versión de su función de Lambda y cree un alias para la versión.

1. En el menú Actions, elija Publish new version.

2. En Version description (Descripción de versión), escriba First version y, a continuación, elija Publish (Publicar).

3. En la página de configuración de TempMonitor: 1, en el menú Actions (Acciones), elija Create alias (Crear alias).

4. En la página Create a new alias, utilice los valores siguientes:

   • En Name (Nombre), ingrese GG_TempMonitor.

   • En Version (Versión), elija 1.

   nota

   AWS IoT Greengrass no admite alias de Lambda; para versiones de $LATEST.

5. Seleccione Create (Crear).

En la página de configuración del grupo, elija la pestaña Funciones de Lambda.

En la sección Mis funciones de Lambda, seleccione Añadir.

En la página Agregar función de Lambda, elija TempMonitor para la función de Lambda.

Para la versión de la función de Lambda, elija Alias: GG_TempMonitor.

Elija Añadir función de Lambda.

En la página de configuración del grupo, elija la pestaña Suscripciones y, a continuación, elija Añadir suscripción.

En la página Crear una suscripción, configure el origen y el destino de la siguiente manera:

1. Para Tipo de origen, elija Función de lambda y, a continuación, TempMonitor.

2. Para Tipo de destino, seleccione Conector y, a continuación, seleccione Notificaciones de Twilio.

En el Filtro de temas, escriba twilio/txt.

Elija Crear una suscripción.

Repita los pasos del 1 al 4 para crear una suscripción que permita a AWS IoT publicar mensajes en la función.

1. Para Tipo de origen, elija Servicio y, a continuación, Nube de IoT.

2. En Seleccionar un destino, elija Funciones de Lambda y, a continuación, elija TempMonitor.

3. En Topic filter (Filtro de temas), escriba temperature/input.

Repita los pasos del 1 al 4 para crear una suscripción que permita al conector publicar mensajes en AWS IoT.

1. Para Tipo de origen, seleccione Conector y, a continuación, seleccione Notificaciones de Twilio.

2. Para Tipo de destino, elija Servicio y, a continuación, Nube de IoT.

3. En Topic filter (Filtro de temas), se introduce twilio/message/status automáticamente. Este es el tema predefinido en el que publica el conector.

Asegúrese de que el núcleo de AWS IoT Greengrass se está ejecutando. Ejecute los siguientes comandos en el terminal de Raspberry Pi según sea necesario.

1. Para comprobar si el daemon está en ejecución:

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

   Si la salida contiene una entrada root para /greengrass/ggc/packages/ggc-version/bin/daemon, el daemon está en ejecución.

   nota

   La versión que figura en la ruta depende de la versión del software AWS IoT Greengrass Core que esté instalada en el dispositivo del núcleo.

2. Iniciar el daemon:

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

En la página de configuración de grupo, elija Implementar.

1. En la pestaña Funciones de Lambda, en la sección Funciones de Lambda del sistema, seleccione Detector IP y elija Editar.

2. En el cuadro de diálogo Editar configuración del detector IP, seleccione Detectar y anular automáticamente los puntos de conexión del agente MQTT.

3. Seleccione Save.

   Esto permite a los dispositivos adquirir automáticamente la información de conexión del dispositivo principal, como la dirección IP, el DNS y el número de puerto. Se recomienda la detección automática, pero AWS IoT Greengrass también es compatible con puntos de conexión especificados manualmente. Solo se le solicitará el método de detección la primera vez que se implemente el grupo.

   nota

   Si se le solicita, conceda permiso para crear el rol de servicio de Greengrass y asócielo a su Cuenta de AWS en el Región de AWS actual. Este rol permite a AWS IoT Greengrass acceder a los servicios de AWS.

   En la página Deployments (Implementaciones), se muestra la marca temporal, el ID de versión y el estado de la implementación. Una vez terminada, la implementación debería mostrar el estado Completado.

   Para obtener ayuda sobre la resolución de problemas, consulte Solución de problemas de AWS IoT Greengrass.

En la página de inicio de la consola AWS IoT, elija Pruebas.

Para Suscribirse al tema, utilice los siguientes valores y, a continuación, seleccione Suscribirse. El conector Notificaciones de Twilio publica información sobre el estado en este tema.

Para Publicar en tema, utilice los siguientes valores y, a continuación, seleccione Publicar para invocar la función.

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

Si se ejecuta correctamente, el destinatario recibe el mensaje de texto y la consola muestra el estado success de los datos de salida.

Ahora, cambie el valor de temperature en el mensaje de entrada a 29 y publíquelo. Dado que es menos de 30, la función TempMonitor no activa un mensaje de Twilio.