

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
<a name="revise-deployments"></a>

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'[CreateDeployment](https://docs.aws.amazon.com/greengrass/v2/APIReference/API_CreateDeployment.html)opération, qui est la même que celle que vous utilisez pour [créer des déploiements.](create-deployments.md)

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

1. <a name="revise-deployment-list-deployments-intro"></a>Exécutez la commande suivante pour répertorier les déploiements pour la cible de déploiement. Remplacez *targetArn* par l'ARN de l' AWS IoT objet ou du groupe d'objets 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**  <a name="revise-deployment-list-deployments-revision-note"></a>
Vous pouvez également modifier un déploiement autre que la dernière révision pour la cible. Spécifiez l'`--history-filter ALL`argument pour répertorier tous les déploiements pour la cible. Copiez ensuite l'ID du déploiement que vous souhaitez modifier.

1. <a name="revise-deployment-get-deployment"></a>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. *deploymentId*Remplacez-le 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.

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

1. Supprimez les paires clé-valeur suivantes de l'objet JSON dans `deployment.json` :
   + `deploymentId`
   + `revisionId`
   + `iotJobId`
   + `iotJobArn`
   + `creationTimestamp`
   + `isLatestForTarget`
   + `deploymentStatus`

   L'[CreateDeployment](https://docs.aws.amazon.com/greengrass/v2/APIReference/API_CreateDeployment.html)opé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
   }
   ```

1. 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, consultez[Créer des déploiements](create-deployments.md).

1. Exécutez la commande suivante pour créer le déploiement à partir de`deployment.json`.

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

   <a name="check-new-deployment-status"></a>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 de plus amples informations, veuillez consulter [Vérifier l'état du déploiement](check-deployment-status.md#check-cloud-deployment-status).