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.
# Configuration d'une étape pour une annulation automatique
Vous pouvez configurer les étapes d'un pipeline pour qu'elles soient annulées automatiquement en cas de défaillance. Lorsque l'étape échoue, elle est rétablie à la dernière exécution réussie. Le pipeline ne peut revenir à une exécution précédente que si celle-ci a été démarrée dans la version actuelle de la structure du pipeline. Étant donné que la configuration de la restauration automatique fait partie de la définition du pipeline, votre étape de pipeline ne sera annulée automatiquement qu'une fois que l'exécution du pipeline aura été réussie au cours de l'étape de pipeline.
## Configuration d'une étape pour une restauration automatique (console)
Vous pouvez revenir d'une étape à une exécution réussie précédente spécifiée. Pour plus d'informations, consultez [RollbackStage](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_RollbackStage.html)le *guide de CodePipeline l'API*.
**Configuration d'une étape pour une restauration automatique (console)**
1. Connectez-vous à la CodePipeline console AWS Management Console et ouvrez-la à l'[adresse http://console.aws.amazon. com/codesuite/codepipeline/home](https://console.aws.amazon.com/codesuite/codepipeline/home).
Les noms et le statut de tous les pipelines associés à votre AWS compte sont affichés.
1. Dans **Name**, choisissez le nom du pipeline que vous souhaitez modifier.
1. Sur la page des détails du pipeline, choisissez **Edit**.
1. Sur la page **Modifier**, pour l'action que vous souhaitez modifier, choisissez **Modifier l'étape**.
1. Choisissez **Configuration automatique de l'étape :**, puis sélectionnez **Configurer la restauration automatique en cas d'échec de l'étape**. Enregistrez les modifications apportées à votre pipeline.
## Configuration d'une étape pour le rollback automatique (CLI)
Pour utiliser l' AWS CLI étape de configuration d'un échec afin de revenir automatiquement à la dernière exécution réussie, utilisez les commandes pour créer ou mettre à jour un pipeline, comme indiqué dans [Création d'un pipeline, d'étapes et d'actions](pipelines-create.md) et[Modifier un pipeline dans CodePipeline](pipelines-edit.md).
+ Ouvrez un terminal (Linux, macOS ou Unix) ou une invite de commande (Windows) et utilisez le AWS CLI pour exécuter la `update-pipeline` commande, en spécifiant la condition de défaillance dans la structure du pipeline. L'exemple suivant configure l'annulation automatique pour un stage nommé : `S3Deploy`
```
{
"name": "S3Deploy",
"actions": [
{
"name": "s3deployaction",
"actionTypeId": {
"category": "Deploy",
"owner": "AWS",
"provider": "S3",
"version": "1"
},
"runOrder": 1,
"configuration": {
"BucketName": "static-website-bucket",
"Extract": "false",
"ObjectKey": "SampleApp.zip"
},
"outputArtifacts": [],
"inputArtifacts": [
{
"name": "SourceArtifact"
}
],
"region": "us-east-1"
}
],
{{"onFailure": {
"result": "ROLLBACK"}}
}
}
```
Pour plus d'informations sur la configuration des conditions de défaillance pour la restauration par étapes, consultez [FailureConditions](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_FailureConditions.html)la *référence de l'CodePipeline API*.
## Configurer une étape pour le rollback automatique ()CloudFormation
Pour configurer une étape CloudFormation afin qu'elle soit annulée automatiquement en cas d'échec, utilisez le `OnFailure` paramètre. En cas d'échec, l'étape revient automatiquement à la dernière exécution réussie.
```
OnFailure:
Result: ROLLBACK
```
+ Mettez à jour le modèle comme indiqué dans l'extrait suivant. L'exemple suivant configure l'annulation automatique pour un stage nommé : `Release`
```
AppPipeline:
Type: AWS::CodePipeline::Pipeline
Properties:
RoleArn:
Ref: CodePipelineServiceRole
Stages:
-
Name: Source
Actions:
-
Name: SourceAction
ActionTypeId:
Category: Source
Owner: AWS
Version: 1
Provider: S3
OutputArtifacts:
-
Name: SourceOutput
Configuration:
S3Bucket:
Ref: SourceS3Bucket
S3ObjectKey:
Ref: SourceS3ObjectKey
RunOrder: 1
-
Name: Release
Actions:
-
Name: ReleaseAction
InputArtifacts:
-
Name: SourceOutput
ActionTypeId:
Category: Deploy
Owner: AWS
Version: 1
Provider: CodeDeploy
Configuration:
ApplicationName:
Ref: ApplicationName
DeploymentGroupName:
Ref: DeploymentGroupName
RunOrder: 1
OnFailure:
Result: ROLLBACK
ArtifactStore:
Type: S3
Location:
Ref: ArtifactStoreS3Location
EncryptionKey:
Id: arn:aws:kms:useast-1:ACCOUNT-ID:key/KEY-ID
Type: KMS
DisableInboundStageTransitions:
-
StageName: Release
Reason: "Disabling the transition until integration tests are completed"
Tags:
- Key: Project
Value: ProjectA
- Key: IsContainerBased
Value: 'true'
```
Pour plus d'informations sur la configuration des conditions de défaillance pour la restauration par étapes, voir [OnFailure](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-codepipeline-pipeline-stagedeclaration.html#cfn-codepipeline-pipeline-stagedeclaration-onfailure)le *Guide `StageDeclaration` de l'CloudFormation utilisateur ci-dessous*.