AWS IoT Greengrass Version 1 entró en la fase de vida útil prolongada el 30 de junio de 2023. Para obtener más información, consulte la política de mantenimiento de AWS IoT Greengrass V1 Después de esta fecha, AWS IoT Greengrass V1 no se publicarán actualizaciones que proporcionen funciones, mejoras, correcciones de errores o parches de seguridad. Los dispositivos que se ejecuten AWS IoT Greengrass V1 no se verán afectados y seguirán funcionando y conectándose a la nube. Le recomendamos encarecidamente que migre a AWS IoT Greengrass Version 2, ya que añade importantes funciones nuevas y es compatible con plataformas adicionales.

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Implementación de grupos de AWS IoT Greengrass en un núcleo de AWS IoT Greengrass

Use los grupos de AWS IoT Greengrass para organizar entidades en el entorno perimetral. También puede utilizar los grupos para controlar cómo interactúan las entidades del grupo entre sí y con el Nube de AWS. Por ejemplo, solo las funciones de Lambda del grupo se implementan para ejecutarse de manera local y solo los dispositivos del grupo pueden comunicarse mediante el servidor MQTT local.

Un grupo debe incluir un núcleo, que es un dispositivo de AWS IoT que ejecuta el software AWS IoT Greengrass Core. El núcleo actúa como una gateway perimetral y proporciona funcionalidades de AWS IoT Core en el entorno perimetral. En función de las necesidades de su negocio, también puede añadir a un grupo las siguientes entidades:

Puede administrar el grupo de Greengrass en la Nube de AWS e implementarlo después en un núcleo. La implementación copia la configuración del grupo en el archivo group.json del dispositivo del núcleo. Este archivo se encuentra en greengrass-root/ggc/deployments/group.

Implementación de grupos desde la consola de AWS IoT

Puede implementar un grupo y administrar sus implementaciones desde la página de configuración del grupo de la consola AWS IoT.

Implementación de grupos con la API de AWS IoT Greengrass

La API de AWS IoT Greengrass proporciona las siguientes acciones para implementar grupos de AWS IoT Greengrass y administrar implementaciones de grupo. Puede llamar a estas acciones desde la AWS CLI, la API de AWS IoT Greengrass o el SDK de AWS.

Obtener el ID del grupo

El ID del grupo se usa comúnmente en acciones de la API. Puede utilizar la ListGroupsacción para buscar el ID del grupo objetivo en su lista de grupos. Por ejemplo, en la AWS CLI, utilice el comando list-groups.

aws greengrass list-groups

También puede incluir la opción query para filtrar los resultados. Por ejemplo:

A continuación se muestra un ejemplo de respuesta de list-groups. La información de cada grupo incluye el ID del grupo (en la propiedad Id) y el ID de la versión de grupo más reciente (en la propiedad LatestVersion). Para obtener otros ID de versión para un grupo, usa el ID de grupo con ListGroupVersions.

{
    "Groups": [
        {
            "LatestVersionArn": "arn:aws:us-west-2:123456789012:/greengrass/groups/00dedaaa-ac16-484d-ad77-c3eedEXAMPLE/versions/4cbc3f07-fc5e-48c4-a50e-7d356EXAMPLE",
            "Name": "MyFirstGroup",
            "LastUpdatedTimestamp": "2019-11-11T05:47:31.435Z",
            "LatestVersion": "4cbc3f07-fc5e-48c4-a50e-7d356EXAMPLE",
            "CreationTimestamp": "2019-11-11T05:47:31.435Z",
            "Id": "00dedaaa-ac16-484d-ad77-c3eedEXAMPLE",
            "Arn": "arn:aws:us-west-2:123456789012:/greengrass/groups/00dedaaa-ac16-484d-ad77-c3eedEXAMPLE"
        },
        {
            "LatestVersionArn": "arn:aws:us-west-2:123456789012:/greengrass/groups/036ceaf9-9319-4716-ba2a-237f9EXAMPLE/versions/8fe9e8ec-64d1-4647-b0b0-01dc8EXAMPLE",
            "Name": "GreenhouseSensors",
            "LastUpdatedTimestamp": "2020-01-07T19:58:36.774Z",
            "LatestVersion": "8fe9e8ec-64d1-4647-b0b0-01dc8EXAMPLE",
            "CreationTimestamp": "2020-01-07T19:58:36.774Z",
            "Id": "036ceaf9-9319-4716-ba2a-237f9EXAMPLE",
            "Arn": "arn:aws:us-west-2:123456789012:/greengrass/groups/036ceaf9-9319-4716-ba2a-237f9EXAMPLE"
        },
        ...
    ]
}

Si no especifica una Región de AWS, los comandos de la AWS CLI utilizan la región predeterminada de su perfil. Para devolver grupos en una región distinta, incluya la opción de región. Por ejemplo:

aws greengrass list-groups --region us-east-1

Información general sobre el modelo de objetos de grupo de AWS IoT Greengrass

Cuando se programa con la API de AWS IoT Greengrass, resulta útil conocer el modelo de objetos de grupo de Greengrass.

Grupos

En la API de AWS IoT Greengrass, el objeto Group de nivel superior se compone de metadatos y de una lista de objetos GroupVersion. Los objetos GroupVersion están asociados con un objeto Group a través de su ID.

Versiones del grupo

Los objetos GroupVersion definen la pertenencia a los grupos. Cada GroupVersion hace referencia a un objeto CoreDefinitionVersion y a otras versiones de componentes a través de su ARN. Estas referencias determinan qué entidades se van a incluir en el grupo.

Por ejemplo, para incluir tres funciones de Lambda, un dispositivo y dos suscripciones en el grupo, GroupVersion hace referencia a:

El objeto GroupVersion implementado en un dispositivo de núcleo determina las entidades que están disponibles en el entorno local y cómo pueden interactuar.

Componentes del grupo

Los componentes que añada a los grupos tienen una jerarquía de tres niveles:

En el siguiente ejemplo, DeviceDefinition hace referencia a tres objetos DeviceDefinitionVersion, cada uno de los cuales contiene varios objetos Device. En los grupos, solo se utiliza un DeviceDefinitionVersion cada vez.

Actualización de grupos

En la API de AWS IoT Greengrass, se utilizan versiones para actualizar la configuración de un grupo. Las versiones son inmutables, por lo que para añadir, eliminar o cambiar los componentes del grupo, debe crear DefinitionVersionobjetos que contengan entidades nuevas o actualizadas.

Puede asociar DefinitionVersionsobjetos nuevos a objetos de definición nuevos o existentes. Por ejemplo, puede utilizar la acción CreateFunctionDefinition para crear un objeto FunctionDefinition que incluya el objeto FunctionDefinitionVersion como versión inicial, o puede utilizar la acción CreateFunctionDefinitionVersion y hacer referencia a un objeto FunctionDefinition existente.

Tras crear los componentes del grupo, se crea uno GroupVersion que contenga todos los DefinitionVersionobjetos que se desean incluir en el grupo. A continuación, debe implementar GroupVersion.

Para implementar un objeto GroupVersion, debe hacer referencia a un objeto CoreDefinitionVersion que contenga exactamente un objeto Core. Todas las entidades a las que se haga referencia deben ser miembros del grupo. Además, debe haber un rol de servicio de Greengrass asociado a su Cuenta de AWS en la Región de AWS en la que va a implementar el GroupVersion.

Actualización de entidades que hacen referencia a recursos de AWS

Las funciones de Lambda de Greengrass y los recursos secretos definen propiedades específicas de Greengrass y también hacen referencia a los recursos de AWS correspondientes. Para actualizar estas entidades, puede realizar cambios en el recurso de AWS correspondiente en lugar de en los objetos de Greengrass. Por ejemplo, las funciones DE Lambda hacen referencia a una función de AWS Lambda y también definen el ciclo de vida y otras propiedades específicas del grupo de Greengrass.

Véase también