Aviso de fin de soporte: el 7 de octubre de 2026, AWS suspenderemos el soporte para AWS IoT Greengrass Version 1. Después del 7 de octubre de 2026, ya no podrá acceder a los AWS IoT Greengrass V1 recursos. Para obtener más información, visita [Migrar desde AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html).
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.
# Implemente AWS IoT Greengrass grupos en un AWS IoT Greengrass núcleo
Utilice AWS IoT Greengrass grupos para organizar las entidades de su entorno perimetral. También puede utilizar los grupos para controlar cómo interactúan las entidades del grupo entre sí y con la 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](gg-core.md), que es un AWS IoT dispositivo que ejecuta el software AWS IoT Greengrass Core. El núcleo actúa como una puerta de enlace perimetral y proporciona AWS IoT Core capacidades en el entorno perimetral. En función de las necesidades de su negocio, también puede añadir a un grupo las siguientes entidades:
+ **Dispositivos cliente**. Se representan como objetos en el registro de AWS IoT . Estos dispositivos deben ejecutar [FreeRTOS](https://docs.aws.amazon.com/freertos/latest/userguide/freertos-lib-gg-connectivity.html) o deben utilizar el [SDK de dispositivos de AWS IoT](what-is-gg.md#iot-device-sdk) o la [API de detección de AWS IoT Greengrass](gg-discover-api.md) para obtener la información de conexión del núcleo. Solo los dispositivos cliente que son miembros del grupo pueden conectarse al núcleo.
+ **Funciones de Lambda** Son aplicaciones definidas por los usuarios sin servidor que ejecutan código en el núcleo. Las funciones Lambda se crean AWS Lambda y se hace referencia a ellas desde un grupo de Greengrass. Para obtener más información, consulte [Ejecute funciones Lambda en el núcleo AWS IoT Greengrass](lambda-functions.md).
+ **Conectores**. Son aplicaciones predefinidas sin servidor que ejecutan código en el núcleo. Los conectores pueden proporcionar una integración integrada con la infraestructura local, los protocolos de los dispositivos y otros servicios en la nube. AWS Para obtener más información, consulte [Integración con servicios y protocolos mediante conectores de Greengrass](connectors.md).
+ **Suscripciones**. Definen los publicadores, los suscriptores y los temas (o asuntos) de MQTT que están autorizados para la comunicación con MQTT.
+ **Recursos**. Referencias a [dispositivos y volúmenes](access-local-resources.md) locales, [modelos de machine learning](ml-inference.md) y [secretos](secrets.md), que se utilizan para controlar el acceso por parte de Greengrass en funciones y conectores de Lambda.
+ **Registros**. Registrar las configuraciones de los componentes AWS IoT Greengrass del sistema y las funciones Lambda. Para obtener más información, consulte [Supervisión con AWS IoT Greengrass registros](greengrass-logs-overview.md).
Administra su grupo de Greengrass en Nube de AWS y, a continuación, lo despliega 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`.
**nota**
Durante una implementación, el proceso del demonio de Greengrass del dispositivo del núcleo se detiene y después se reinicia.
## Despliegue de grupos desde la consola AWS IoT
Puede implementar un grupo y administrar sus despliegues desde la página de configuración del grupo en la AWS IoT consola.
**nota**
Para abrir esta página en la consola, seleccione **Dispositivos Greengrass**, luego **Grupos (V1)** y, a continuación, en **Grupos de Greengrass**, seleccione su grupo.
**Para implementar la versión actual del grupo**
+ Desde la página de configuración de grupo, elija **Implementaciones**.
**Para ver el historial de implementaciones del grupo**
El historial de implementaciones de un grupo incluye la fecha y la hora, la versión del grupo y el estado de cada intento de implementación.
1. Desde la página de configuración de grupo, elija la pestaña **Implementaciones**.
1. Para ver más información sobre una implementación, incluidos los mensajes de error, selecciona **Implementaciones** en la AWS IoT consola, en Dispositivos **Greengrass**.
**Para volver a implementar una implementación de grupo**
Es posible que desee repetir una implementación si se produce un error en la implementación actual o si quiere volver a otra versión del grupo.
1. En la AWS IoT consola, selecciona **dispositivos Greengrass** y, a continuación, selecciona **Grupos (V1)**.
1. Elija la pestaña **Implementaciones**.
1. Elija la implementación que desea volver a implementar y elija **Reimplementar.**
**Para restablecer las implementaciones de grupo**
Es posible que desee restablecer las implementaciones de grupo para mover o eliminar un grupo o para eliminar la información de implementación. Para obtener más información, consulte [Restablecimiento de implementaciones](reset-deployments-scenario.md).
1. En la AWS IoT consola, selecciona **dispositivos Greengrass** y, a continuación, selecciona **Grupos (V1)**.
1. Elija la pestaña **Implementaciones**.
1. Elija la implementación que desea restablecer y elija **Restablecer implementaciones**.
## Desplegar grupos con la API AWS IoT Greengrass
La AWS IoT Greengrass API proporciona las siguientes acciones para implementar AWS IoT Greengrass grupos y administrar las implementaciones grupales. Puede llamar a estas acciones desde la AWS CLI AWS IoT Greengrass API o el AWS SDK.
| Action | Description (Descripción) |
| --- | --- |
| [CreateDeployment](https://docs.aws.amazon.com/greengrass/v1/apireference/createdeployment-post.html) | Crea una implementación `Redeployment` o `NewDeployment`.
Es posible que desee repetir una implementación si se produce un error en la implementación actual. O es posible que desee repetirla para revertir a otra versión del grupo. |
| [GetDeploymentStatus](https://docs.aws.amazon.com/greengrass/v1/apireference/getdeploymentstatus-get.html) | Devuelve el estado de una implementación: `Building`, `InProgress`, `Success` o `Failure`.
Puedes configurar EventBridge los eventos de Amazon para recibir notificaciones de despliegue. Para obtener más información, consulte [Obtención de notificaciones de implementación](deployment-notifications.md). |
| [ListDeployments](https://docs.aws.amazon.com/greengrass/v1/apireference/listdeployments-get.html) | Devuelve el historial de implementaciones del grupo. |
| [ResetDeployments](https://docs.aws.amazon.com/greengrass/v1/apireference/resetdeployments-post.html) | Restablece las implementaciones del grupo.
Es posible que desee restablecer las implementaciones de grupo para mover o eliminar un grupo o para eliminar la información de implementación. Para obtener más información, consulte [Restablecimiento de implementaciones](reset-deployments-scenario.md). |
**nota**
Para obtener información acerca de las operaciones de implementación por lotes, consulte [Creación de implementaciones de grupos por lotes](bulk-deploy-cli.md).
### Obtener el ID del grupo
El ID del grupo se usa comúnmente en acciones de la API. Puede utilizar la [ListGroups](https://docs.aws.amazon.com/greengrass/v1/apireference/listgroups-get.html)acción para buscar el ID del grupo objetivo en su lista de grupos. Por ejemplo, en AWS CLI, usa el `list-groups` comando.
```
aws greengrass list-groups
```
También puede incluir la opción `query` para filtrar los resultados. Por ejemplo:
+ Para obtener el grupo creado más recientemente:
```
aws greengrass list-groups --query "reverse(sort_by(Groups, &CreationTimestamp))[0]"
```
+ Para obtener un grupo por nombre:
```
aws greengrass list-groups --query "Groups[?Name=='{{MyGroup}}']"
```
No es necesario que los nombres de grupo sean únicos, por lo que podrían devolverse varios grupos.
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 otra versión IDs para un grupo, usa el ID de grupo con [ListGroupVersions](https://docs.aws.amazon.com/greengrass/v1/apireference/listgroupversions-get.html).
**nota**
También puedes encontrar estos valores en la AWS IoT consola. El ID de grupo se muestra en la página **Settings (Configuración)** del grupo. La versión del grupo IDs se muestra en la pestaña **Implementaciones** del grupo.
```
{
"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 especificas ninguna Región de AWS, AWS CLI los comandos utilizan la región predeterminada de tu perfil. Para devolver grupos de una región diferente, incluye la {{region}} opción. Por ejemplo:
```
aws greengrass list-groups --region us-east-1
```
## Descripción general del modelo de objetos AWS IoT Greengrass grupales
Al programar con la AWS IoT Greengrass API, es útil entender el modelo de objetos grupales de Greengrass.
### Groups
En la AWS IoT Greengrass API, el `Group` objeto de nivel superior consta de metadatos y una lista de `GroupVersion` objetos. `GroupVersion`los objetos están asociados a un `Group` por 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 `CoreDefinitionVersion` que contiene el núcleo requerido.
+ `FunctionDefinitionVersion` que contiene las tres funciones.
+ La `DeviceDefinitionVersion` que contiene el dispositivo de cliente.
+ `SubscriptionDefinitionVersion` que contiene las dos suscripciones.
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:
+ Una *definición* que hace referencia a una lista de *DefinitionVersion*objetos de un tipo determinado. Por ejemplo, un objeto `DeviceDefinition` hace referencia a una lista de objetos `DeviceDefinitionVersion`.
+ A *DefinitionVersion*que contiene un conjunto de entidades de un tipo determinado. Por ejemplo, un objeto `DeviceDefinitionVersion` contiene una lista de objetos `Device`.
+ Entidades individuales que definen sus propiedades y su comportamiento. Por ejemplo, a `Device` define el ARN del dispositivo cliente correspondiente en el AWS IoT registro, el ARN de su certificado de dispositivo y si su sombra local se sincroniza automáticamente con la nube.
Puede añadir los siguientes tipos de entidades a un grupo:
+ [Kinesis - S3](https://docs.aws.amazon.com/greengrass/v1/apireference/definitions-connector.html)
+ [Core](https://docs.aws.amazon.com/greengrass/v1/apireference/definitions-core.html)
+ [Dispositivo](https://docs.aws.amazon.com/greengrass/v1/apireference/definitions-device.html)
+ [Función](https://docs.aws.amazon.com/greengrass/v1/apireference/definitions-function.html)
+ [Logger](https://docs.aws.amazon.com/greengrass/v1/apireference/definitions-logger.html)
+ [Resource](https://docs.aws.amazon.com/greengrass/v1/apireference/definitions-resource.html)
+ [Suscripción](https://docs.aws.amazon.com/greengrass/v1/apireference/definitions-subscription.html)
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 AWS IoT Greengrass API, se utilizan las 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 *DefinitionVersion*objetos que contengan entidades nuevas o actualizadas.
Puede asociar *DefinitionVersions*objetos 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 *DefinitionVersion*objetos 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, un [rol de servicio de Greengrass](service-role.md) debe estar asociado a usted Cuenta de AWS en el Región de AWS lugar donde vaya a implementar el. `GroupVersion`
**nota**
Las acciones `Update` de la API se utilizan para cambiar el nombre de un objeto `Group` o *Definition* del componente.
**Actualizar las entidades que hacen referencia a los recursos AWS **
Las funciones Lambda y los [recursos secretos de Greengrass definen las propiedades específicas de Greengrass y también hacen referencia a los recursos](secrets.md) correspondientes. AWS Para actualizar estas entidades, puede realizar cambios en el AWS recurso correspondiente en lugar de en sus objetos de Greengrass. Por ejemplo, las funciones de Lambda hacen referencia a una función en el grupo Greengrass AWS Lambda y también definen el ciclo de vida y otras propiedades que son específicas del grupo Greengrass.
+ Para actualizar el código de la función de Lambda o las dependencias empaquetadas, realice los cambios en AWS Lambda. Durante la siguiente implementación grupal, estos cambios se recuperan del entorno local AWS Lambda y se copian en él.
+ Para actualizar las [propiedades específicas de Greengrass](lambda-group-config.md), debe crear un objeto `FunctionDefinitionVersion` que contenga las propiedades `Function` actualizadas.
**nota**
Las funciones de Lambda de Greengrass pueden hacer referencia a una función de Lambda por el ARN del alias o el ARN de versión. Si hace referencia al ARN del alias (recomendado), no es necesario actualizar `FunctionDefinitionVersion` (ni `SubscriptionDefinitionVersion`) al publicar una nueva versión de la función en AWS Lambda. Para obtener más información, consulte [Referencia a funciones de Lambda por alias o versión](lambda-functions.md#lambda-versions-aliases).
## Véase también
+ [Obtención de notificaciones de implementación](deployment-notifications.md)
+ [Restablecimiento de implementaciones](reset-deployments-scenario.md)
+ [Creación de implementaciones de grupos por lotes](bulk-deploy-cli.md)
+ [Solución de problemas de implementación](gg-troubleshooting.md#gg-troubleshooting-deploymentissues)
+ [AWS IoT Greengrass Version 1 Referencia de la API](https://docs.aws.amazon.com/greengrass/v1/apireference/)
+ [AWS IoT Greengrass comandos](https://docs.aws.amazon.com/cli/latest/reference/greengrass/index.html) de la *Referencia de AWS CLI comandos*