Réinitialiser les déploiements - AWS IoT Greengrass
Réinitialisez les déploiements depuis la console AWS IoTRéinitialiser les déploiements avec l'API AWS IoT GreengrassConsultez aussi

AWS IoT Greengrass Version 1 est entré dans la phase de durée de vie prolongée le 30 juin 2023. Pour plus d'informations, consultez la politique de AWS IoT Greengrass V1 maintenance. Après cette date, AWS IoT Greengrass V1 ne publiera pas de mises à jour fournissant des fonctionnalités, des améliorations, des corrections de bogues ou des correctifs de sécurité. Les appareils qui fonctionnent AWS IoT Greengrass V1 sous tension ne seront pas perturbés et continueront à fonctionner et à se connecter au cloud. Nous vous recommandons vivement de migrer vers AWS IoT Greengrass Version 2, qui ajoute de nouvelles fonctionnalités importantes et prend en charge des plateformes supplémentaires.

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.

Réinitialiser les déploiements

Cette fonctionnalité est disponible pour AWS IoT Greengrass Core v1.1 et versions ultérieures.

Vous pouvez souhaiter réinitialiser les déploiements d'un groupe pour :

  • Supprimez le groupe, par exemple lorsque vous souhaitez déplacer le noyau du groupe vers un autre groupe ou lorsque le noyau du groupe a été redessiné. Avant de supprimer un groupe, vous devez réinitialiser les déploiements du groupe pour utiliser le noyau avec un autre groupe Greengrass.

  • Déplacer le noyau du groupe vers un autre groupe.

  • Restaurer l'état antérieur d’un groupe avant tous les déploiements.

  • Supprimer la configuration de déploiement de l'appareil principal.

  • Supprimer des données sensibles de l'appareil principal ou du cloud.

  • Déployer une nouvelle configuration sur un noyau sans avoir à remplacer le noyau par un autre dans le groupe actuel.

Note

La fonctionnalité de réinitialisation des déploiements n'est pas disponible dans la version 1.0.0 du logiciel AWS IoT Greengrass Core. Vous ne pouvez pas supprimer un groupe qui a été déployé à l'aide de la version 1.0.0.

L'opération de réinitialisation des déploiements nettoie d'abord toutes les informations de déploiement stockées dans le cloud pour un groupe donné. Il demande ensuite au périphérique principal du groupe de nettoyer également toutes les informations relatives au déploiement (fonctions Lambda, journaux des utilisateurs, base de données fantôme et certificat de serveur, mais pas les certificats config.json définis par l'utilisateur ou les certificats principaux de Greengrass). Vous ne pouvez pas lancer une réinitialisation des déploiements pour un groupe si ce dernier a un déploiement dont l’état est In Progress ou Building.

Réinitialisez les déploiements depuis la console AWS IoT

Vous pouvez réinitialiser les déploiements de groupe à partir de la page de configuration de groupe de la AWS IoT console.

  1. Dans le volet de navigation de la AWS IoT console, sous Gérer, développez les appareils Greengrass, puis choisissez Groups (V1).

  2. Choisissez le groupe cible.

  3. Dans l'onglet Déploiements, choisissez Réinitialiser les déploiements.

  4. Dans la boîte de dialogue Réinitialiser les déploiements pour ce groupe Greengrass, confirm tapez pour accepter, puis choisissez Réinitialiser le déploiement.

Réinitialiser les déploiements avec l'API AWS IoT Greengrass

Vous pouvez utiliser l'action ResetDeployments dans l'AWS CLI, l'API AWS IoT Greengrass ou le kit de développement SDK AWS pour réinitialiser les déploiements. Les exemples de cette rubrique utilisent l’interface de ligne de commande.

aws greengrass reset-deployments --group-id GroupId [--force]
Arguments destinés à la commande reset-deployments de l'interface de ligne de commande :
--group-id

ID du groupe Utilisez la commande list-groups pour obtenir cette valeur.

--force

Facultatif. Utilisez ce paramètre si l'appareil principal du groupe a été perdu, volé ou détruit. Si cette option est activée, le processus de déploiement de la réinitialisation signale la réussite une fois que toutes les informations de déploiement dans le cloud ont été nettoyées, sans attendre la réponse d'un appareil principal. Toutefois, si l'appareil principal est ou devient actif, il effectue également des opérations de nettoyage.

La sortie de la commande reset-deployments de l'interface de ligne de commande ressemble à ceci :

{
    "DeploymentId": "4db95ef8-9309-4774-95a4-eea580b6ceef",
    "DeploymentArn": "arn:aws:greengrass:us-west-2:106511594199:/greengrass/groups/b744ed45-a7df-4227-860a-8d4492caa412/deployments/4db95ef8-9309-4774-95a4-eea580b6ceef"
}

Vous pouvez vérifier le statut du déploiement de la réinitialisation avec la commande get-deployment-status de l'interface de ligne de commande :

aws greengrass get-deployment-status --deployment-id DeploymentId --group-id GroupId
Arguments destinés à la commande get-deployment-status de l'interface de ligne de commande :
--deployment-id

ID de déploiement

--group-id

ID du groupe

La sortie de la commande get-deployment-status de l'interface de ligne de commande ressemble à ceci :

{
    "DeploymentStatus": "Success",
    "UpdatedAt": "2017-04-04T00:00:00.000Z"
}

DeploymentStatus est défini sur Building lorsque le déploiement de la réinitialisation est en cours de préparation. Lorsque le déploiement de réinitialisation est prêt mais que le AWS IoT Greengrass noyau n'a pas pris en charge le déploiement de réinitialisation, DeploymentStatus c'est le casInProgress.

Si l'opération de réinitialisation échoue, les informations relatives à l'erreur sont renvoyées dans la réponse.

Consultez aussi