Avis de fin de support : le 7 octobre 2026, AWS le support de. AWS IoT Greengrass Version 1 Après le 7 octobre 2026, vous ne pourrez plus accéder aux AWS IoT Greengrass V1 ressources. Pour plus d'informations, rendez-vous sur [Migrer depuis AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html).
Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Déploiement AWS IoT Greengrass groupes vers un AWS IoT Greengrass principal
Utilisez AWS IoT Greengrass des groupes pour organiser les entités dans votre environnement périphérique. Vous pouvez également utiliser des groupes pour contrôler la manière dont les entités du groupe interagissent entre elles et avec le AWS Cloud. Par exemple, seules les fonctions Lambda du groupe sont déployées pour être exécutées localement, et seuls les appareils du groupe peuvent communiquer via le serveur MQTT local.
Un groupe doit inclure un [noyau](gg-core.md), c'est-à-dire un AWS IoT appareil qui exécute le logiciel AWS IoT Greengrass Core. Le cœur agit comme une passerelle périphérique et fournit des AWS IoT Core fonctionnalités dans l'environnement périphérique. En fonction des besoins de votre entreprise, vous pouvez également ajouter les entités suivantes à un groupe :
+ **Appareils clients**. Représenté en tant qu'objets dans le registre AWS IoT . Ces appareils doivent exécuter [FreeRTOS](https://docs.aws.amazon.com/freertos/latest/userguide/freertos-lib-gg-connectivity.html) ou utiliser [AWS IoT le Device SDK AWS IoT Greengrass ou l'](what-is-gg.md#iot-device-sdk)[API Discovery](gg-discover-api.md) pour obtenir des informations de connexion pour le noyau. Seuls les appareils clients membres du groupe peuvent se connecter au cœur.
+ **Fonctions Lambda**. User-defined applications sans serveur qui exécutent du code sur le cœur. Les fonctions Lambda sont créées AWS Lambda et référencées à partir d'un groupe Greengrass. Pour de plus amples informations, veuillez consulter [Exécutez les fonctions Lambda sur le AWS IoT Greengrass principal](lambda-functions.md).
+ **Connecteurs**. Applications sans serveur prédéfinies qui exécutent du code sur le cœur. Les connecteurs peuvent fournir une intégration intégrée à l'infrastructure locale AWS, aux protocoles des appareils et à d'autres services cloud. Pour de plus amples informations, veuillez consulter [Intégrer à des services et protocoles à l'aide de connecteurs Greengrass](connectors.md).
+ **Abonnements**. Définit les éditeurs, les abonnés et les rubriques MQTT (ou sujets) qui sont autorisés pour la communication MQTT.
+ **Ressources**. Références à des [appareils et volumes](access-local-resources.md) locaux, à des [modèles d'apprentissage automatique](ml-inference.md) et à des [secrets](secrets.md), utilisés pour le contrôle d'accès par les fonctions et connecteurs Greengrass Lambda.
+ **Journaux**. Configurations de journalisation pour les composants AWS IoT Greengrass du système et les fonctions Lambda. Pour de plus amples informations, veuillez consulter [Surveillance avec AWS IoT Greengrass journaux](greengrass-logs-overview.md).
Vous gérez votre groupe Greengrass dans le, AWS Cloud puis vous le déployez sur un noyau. Le déploiement copie la configuration du groupe dans le fichier `group.json` sur l'appareil principal. Ce fichier se trouve dans le dossier `{{greengrass-root}}/ggc/deployments/group`.
**Note**
Au cours d'un déploiement, le processus de démon Greengrass sur l'appareil principal s'arrête, puis redémarre.
## Déploiement de groupes à partir du AWS IoT console
Vous pouvez déployer un groupe et gérer ses déploiements depuis la page de configuration du groupe dans la AWS IoT console.
**Note**
Pour ouvrir cette page dans la console, choisissez **Greengrass devices**, **Groups (V1)**, puis sous **Greengrass groups**, choisissez votre groupe.
**Pour déployer la version actuelle du groupe**
+ Sur la page de configuration du groupe, choisissez **Deploy**.
**Pour afficher l'historique de déploiement du groupe**
L'historique de déploiement d'un groupe inclut la date et l'heure, la version du groupe et l'état de chaque tentative de déploiement.
1. Sur la page de configuration du groupe, choisissez l'onglet **Déploiements**.
1. Pour obtenir plus d'informations sur un déploiement, y compris les messages d'erreur, choisissez **Déploiements** depuis la AWS IoT console, sous Appareils **Greengrass**.
**Pour redéployer un déploiement de groupe**
Vous pouvez souhaiter redéployer un déploiement si le déploiement actuel échoue ou revenir à une autre version de groupe.
1. Sur la AWS IoT console, choisissez **Greengrass devices**, puis **Groups (V1)**.
1. Choisissez l’onglet **Déploiements**.
1. Choisissez le déploiement que vous souhaitez redéployer, puis **Redéployer**.
**Pour réinitialiser les déploiements de groupe**
Vous pouvez souhaiter réinitialiser les déploiements de groupe pour déplacer ou supprimer un groupe ou supprimer des informations de déploiement. Pour de plus amples informations, veuillez consulter [Réinitialiser les déploiements](reset-deployments-scenario.md).
1. Sur la AWS IoT console, choisissez **Greengrass devices**, puis **Groups (V1)**.
1. Choisissez l’onglet **Déploiements**.
1. Choisissez le déploiement que vous souhaitez réinitialiser, puis sélectionnez **Réinitialiser les déploiements.**
## Déploiement de groupes avec AWS IoT Greengrass API
L' AWS IoT Greengrass API fournit les actions suivantes pour déployer des AWS IoT Greengrass groupes et gérer les déploiements de groupes. Vous pouvez appeler ces actions depuis AWS CLI l' AWS IoT Greengrass API ou le AWS SDK.
| Action | Description |
| --- | --- |
| [CreateDeployment](https://docs.aws.amazon.com/greengrass/v1/apireference/createdeployment-post.html) | Crée un déploiement `Redeployment` ou `NewDeployment`.
Vous pouvez souhaiter redéployer un déploiement si le déploiement actuel échoue. Ou vous pouvez souhaiter redéployer pour revenir à une autre version de groupe. |
| [GetDeploymentStatus](https://docs.aws.amazon.com/greengrass/v1/apireference/getdeploymentstatus-get.html) | Renvoie le statut d'un déploiement : `Building`, `InProgress`, `Success` ou `Failure`.
Vous pouvez configurer les EventBridge événements Amazon pour recevoir des notifications de déploiement. Pour de plus amples informations, veuillez consulter [Obtention des notifications de déploiement](deployment-notifications.md). |
| [ListDeployments](https://docs.aws.amazon.com/greengrass/v1/apireference/listdeployments-get.html) | Renvoie l'historique de déploiement pour le groupe. |
| [ResetDeployments](https://docs.aws.amazon.com/greengrass/v1/apireference/resetdeployments-post.html) | Réinitialise les déploiements pour le groupe.
Vous pouvez souhaiter réinitialiser les déploiements de groupe pour déplacer ou supprimer un groupe ou supprimer des informations de déploiement. Pour de plus amples informations, veuillez consulter [Réinitialiser les déploiements](reset-deployments-scenario.md). |
**Note**
Pour plus d'informations sur les opérations de déploiement en bloc, consultez [Créer des déploiements en bloc pour des groupes](bulk-deploy-cli.md).
### Obtention de l'ID de groupe
L'ID de groupe est couramment utilisé dans les actions API. Vous pouvez utiliser cette [ListGroups](https://docs.aws.amazon.com/greengrass/v1/apireference/listgroups-get.html)action pour trouver l'identifiant du groupe cible dans votre liste de groupes. Par exemple, dans le AWS CLI, utilisez la `list-groups` commande.
```
aws greengrass list-groups
```
Vous pouvez également inclure l'option `query` pour filtrer les résultats. Par exemple :
+ Pour obtenir le groupe créé le plus récemment :
```
aws greengrass list-groups --query "reverse(sort_by(Groups, &CreationTimestamp))[0]"
```
+ Pour obtenir un groupe par son nom :
```
aws greengrass list-groups --query "Groups[?Name=='{{MyGroup}}']"
```
Les noms de groupe ne devant pas nécessairement être uniques, plusieurs groupes peuvent être renvoyés.
Voici un exemple de réponse `list-groups` : Les informations relatives à chaque groupe comprennent l'ID du groupe (dans la propriété `Id`) et l'ID de la version de groupe la plus récente (dans la propriété `LatestVersion`). Pour obtenir d'autres identifiants de version pour un groupe, utilisez l'ID de groupe avec [ListGroupVersions](https://docs.aws.amazon.com/greengrass/v1/apireference/listgroupversions-get.html).
**Note**
Vous pouvez également trouver ces valeurs dans la AWS IoT console. L'ID du groupe s'affiche sur la page **Paramètres** du groupe. Les identifiants de version du groupe sont affichés dans l'onglet **Déploiements** du groupe.
```
{
"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 vous ne spécifiez pas de Région AWS, AWS CLI les commandes utilisent la région par défaut de votre profil. Pour renvoyer des groupes dans une autre région, incluez {{region}} cette option. Par exemple :
```
aws greengrass list-groups --region us-east-1
```
## Vue d'ensemble du AWS IoT Greengrass modèle d'objet de groupe
Lorsque vous programmez avec l' AWS IoT Greengrass API, il est utile de comprendre le modèle d'objet du groupe Greengrass.
### Groupes
Dans l' AWS IoT Greengrass API, l'`Group`objet de niveau supérieur se compose de métadonnées et d'une liste d'`GroupVersion`objets. `GroupVersion`les objets sont associés à un `Group` identifiant secondaire.
### Versions de groupe
Les objets `GroupVersion` définissent l'appartenance au groupe. Chaque objet `GroupVersion` fait référence à un objet `CoreDefinitionVersion` et d'autres versions de composant par ARN. Ces références déterminent les entités à inclure dans le groupe.
Par exemple, pour inclure trois fonctions Lambda, un appareil et deux abonnements dans le groupe, les `GroupVersion` références :
+ `CoreDefinitionVersion` contenant le noyau requis.
+ `FunctionDefinitionVersion`, qui contient les trois fonctions.
+ Celui `DeviceDefinitionVersion` qui contient l'appareil client.
+ `SubscriptionDefinitionVersion`, qui contient les deux abonnements.
L’objet `GroupVersion` déployé sur un périphérique noyau détermine les entités disponibles dans l'environnement local et la manière dont elles peuvent interagir.
### Composants de groupe
Les composants que vous ajoutez aux groupes ont une hiérarchie à trois niveaux :
+ *Définition* qui fait référence à une liste d'*DefinitionVersion*objets d'un type donné. Par exemple, un objet `DeviceDefinition` fait référence à une liste d'objets `DeviceDefinitionVersion`.
+ Un *DefinitionVersion*qui contient un ensemble d'entités d'un type donné. Par exemple, un objet `DeviceDefinitionVersion` contient une liste d'objets `Device`.
+ Entités individuelles qui définissent leurs propriétés et leur comportement. Par exemple, a `Device` définit l'ARN de l'appareil client correspondant dans le AWS IoT registre, l'ARN de son certificat d'appareil et indique si son shadow local se synchronise automatiquement avec le cloud.
Vous pouvez ajouter les types d'entité suivants à un groupe :
+ [Connecteur](https://docs.aws.amazon.com/greengrass/v1/apireference/definitions-connector.html)
+ [Principal](https://docs.aws.amazon.com/greengrass/v1/apireference/definitions-core.html)
+ [Device](https://docs.aws.amazon.com/greengrass/v1/apireference/definitions-device.html)
+ [Fonction](https://docs.aws.amazon.com/greengrass/v1/apireference/definitions-function.html)
+ [Logger](https://docs.aws.amazon.com/greengrass/v1/apireference/definitions-logger.html)
+ [Ressource](https://docs.aws.amazon.com/greengrass/v1/apireference/definitions-resource.html)
+ [Abonnement](https://docs.aws.amazon.com/greengrass/v1/apireference/definitions-subscription.html)
L'exemple suivant `DeviceDefinition` fait référence à trois objets `DeviceDefinitionVersion` qui contiennent chacun plusieurs objets `Device`. Un seul objet `DeviceDefinitionVersion` à la fois est utilisé dans un groupe.
### Mise à jour de groupes
Dans l' AWS IoT Greengrass API, vous utilisez les versions pour mettre à jour la configuration d'un groupe. Les versions étant immuables, pour ajouter, supprimer ou modifier des composants de groupe, vous devez créer *DefinitionVersion*des objets contenant des entités nouvelles ou mises à jour.
Vous pouvez associer de nouveaux *DefinitionVersions*objets à des objets de *définition* nouveaux ou existants. Par exemple, vous pouvez utiliser l'action `CreateFunctionDefinition` pour créer un objet `FunctionDefinition` qui inclut l’objet `FunctionDefinitionVersion` comme version initiale, ou vous pouvez utiliser l'action `CreateFunctionDefinitionVersion` et faire référence à un objet `FunctionDefinition` existant.
Après avoir créé les composants de votre groupe, vous en créez un `GroupVersion` qui contient tous les *DefinitionVersion*objets que vous souhaitez inclure dans le groupe. Vous déployez ensuite l’objet `GroupVersion`.
Pour déployer un objet `GroupVersion`, celui-ci doit faire référence à un objet `CoreDefinitionVersion` qui contient exactement un objet `Core`. Toutes les entités référencées doivent être membres du groupe. En outre, un rôle de [service Greengrass doit être associé à votre rôle](service-role.md) Compte AWS dans l' Région AWS endroit où vous déployez le. `GroupVersion`
**Note**
Les actions `Update` dans l'API sont utilisées pour modifier le nom d'un objet `Group` ou de composant *Definition*.
**Mettre à jour les entités qui font référence à AWS des ressources**
Les fonctions Lambda et les [ressources secrètes de Greengrass définissent les Greengrass-specific propriétés et font également référence aux ressources](secrets.md) correspondantes. AWS Pour mettre à jour ces entités, vous pouvez apporter des modifications à la AWS ressource correspondante plutôt qu'à vos objets Greengrass. Par exemple, les fonctions Lambda font référence à une fonction dans AWS Lambda et définissent également le cycle de vie et d'autres propriétés spécifiques au groupe Greengrass.
+ Pour mettre à jour le code de fonction Lambda ou les dépendances packagées, apportez vos modifications dans. AWS Lambda Lors du prochain déploiement de groupe, ces modifications sont extraites de votre environnement local AWS Lambda et copiées dans celui-ci.
+ Pour mettre à jour les [Greengrass-specific propriétés](lambda-group-config.md), vous devez créer un `FunctionDefinitionVersion` fichier contenant les `Function` propriétés mises à jour.
**Note**
Les fonctions Lambda Greengrass peuvent référencer une fonction Lambda par un alias ARN ou une version ARN. Si vous référencez l'ARN d'alias (recommandé), vous n'avez pas besoin de mettre à jour votre `FunctionDefinitionVersion` (ou `SubscriptionDefinitionVersion`) lorsque vous publiez une nouvelle version de fonction dans AWS Lambda. Pour de plus amples informations, veuillez consulter [Référencer les fonctions Lambda par alias ou par version](lambda-functions.md#lambda-versions-aliases).
## Consultez aussi
+ [Obtention des notifications de déploiement](deployment-notifications.md)
+ [Réinitialiser les déploiements](reset-deployments-scenario.md)
+ [Créer des déploiements en bloc pour des groupes](bulk-deploy-cli.md)
+ [Dépannage des problèmes de déploiement](gg-troubleshooting.md#gg-troubleshooting-deploymentissues)
+ [AWS IoT Greengrass Version 1 API Reference](https://docs.aws.amazon.com/greengrass/v1/apireference/)
+ [AWS IoT Greengrass commandes](https://docs.aws.amazon.com/cli/latest/reference/greengrass/index.html) dans la *référence des AWS CLI commandes*