Réviser les déploiements - AWS IoT Greengrass

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éviser les déploiements

Chaque objet ou groupe d'objets cible peut faire l'objet d'un déploiement actif à la fois. Lorsque vous créez un déploiement pour une cible déjà déployée, les composants logiciels du nouveau déploiement remplacent ceux du déploiement précédent. Si le nouveau déploiement ne définit aucun composant défini par le déploiement précédent, le logiciel AWS IoT Greengrass Core supprime ce composant des équipements principaux cibles. Vous pouvez modifier un déploiement existant afin de ne pas supprimer les composants exécutés sur les appareils principaux d'un déploiement précédent vers une cible.

Pour réviser un déploiement, vous créez un déploiement qui part des mêmes composants et configurations que ceux d'un déploiement précédent. Vous utilisez l'CreateDeploymentopération, qui est la même que celle que vous utilisez pour créer des déploiements.

Pour réviser un déploiement (AWS CLI)

  1. Exécutez la commande suivante pour répertorier les déploiements pour la cible de déploiement. Remplacez TargetArn par l'ARN de l'objet ou du groupe d'AWS IoTobjets cible.

    aws greengrassv2 list-deployments --target-arn targetArn

    La réponse contient une liste du dernier déploiement pour la cible. Copiez le deploymentId contenu de la réponse pour l'utiliser à l'étape suivante.

    Note

    Vous pouvez également modifier un déploiement autre que la dernière révision pour la cible. Spécifiez l'--history-filter ALLargument pour répertorier tous les déploiements pour la cible. Copiez ensuite l'ID du déploiement que vous souhaitez modifier.

  2. Exécutez la commande suivante pour obtenir les détails du déploiement. Ces détails incluent les métadonnées, les composants et la configuration des tâches. Remplacez DeploymentID par l'ID de l'étape précédente.

    aws greengrassv2 get-deployment --deployment-id deploymentId

    La réponse contient les détails du déploiement.

  3. Créez un fichier appelé deployment.json et copiez la réponse de la commande précédente dans le fichier.

  4. Supprimez les paires clé-valeur suivantes de l'objet JSON dans deployment.json :

    • deploymentId

    • revisionId

    • iotJobId

    • iotJobArn

    • creationTimestamp

    • isLatestForTarget

    • deploymentStatus

    L'CreateDeploymentopération attend une charge utile dont la structure est la suivante.

    {
  "targetArn": "String",
  "components": Map of components,
  "deploymentPolicies": DeploymentPolicies,
  "iotJobConfiguration": DeploymentIoTJobConfiguration,
  "tags": Map of tags
}

  5. Dans deployment.json, effectuez l’une des actions suivantes :

    • Modifiez le nom du déploiement (deploymentName).

    • Modifiez les composants du déploiement (components).

    • Modifiez les politiques du déploiement (deploymentPolicies).

    • Modifiez la configuration des tâches du déploiement (iotJobConfiguration).

    • Modifiez les balises du déploiement (tags).

    Pour plus d'informations sur la définition de ces détails de déploiement, consultezCréer des déploiements.

  6. Exécutez la commande suivante pour créer le déploiement à partir dedeployment.json.

    aws greengrassv2 create-deployment --cli-input-json file://deployment.json

    La réponse inclut un deploymentId identifiant ce déploiement. Vous pouvez utiliser l'ID de déploiement pour vérifier l'état du déploiement. Pour plus d'informations, consultez Vérification du statut du déploiement.