View a markdown version of this page

Configurer une étape pour la restauration automatique - AWS CodePipeline
Configurer une étape pour la restauration automatique (console)Configurer une étape pour la restauration automatique (CLI)Configurez une étape pour la restauration automatique (CloudFormation)

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.

Configurer une étape pour la restauration automatique

Vous pouvez configurer les étapes d'un pipeline pour qu'elles soient annulées automatiquement en cas de panne. Lorsque la phase échoue, elle revient à la dernière exécution réussie. Le pipeline ne peut revenir à une exécution précédente que si l'exécution précédente a été démarrée dans la version actuelle de la structure du pipeline. Étant donné que la configuration de restauration automatique fait partie de la définition du pipeline, votre étape de pipeline ne sera automatiquement restaurée qu'une fois l'exécution réussie du pipeline dans la phase de pipeline.

Configurer une étape pour la restauration automatique (console)

Vous pouvez ramener une étape à une exécution réussie précédente spécifiée. Pour plus d'informations, consultez RollbackStage le Guide des CodePipeline API.

Configurer une étape pour la restauration automatique (console)

  1. Connectez-vous à Console de gestion AWS et ouvrez la CodePipeline console à l'adresse http://console.aws.amazon.com/codesuite/codepipeline/home.

    Les noms et l'état de tous les pipelines associés à votre AWS compte sont affichés.

  2. Dans Name, choisissez le nom du pipeline que vous souhaitez modifier.

  3. Sur la page des détails du pipeline, choisissez Edit.

  4. Sur la page Modifier, pour l'action que vous souhaitez modifier, choisissez Modifier l'étape.

  5. Choisissez Configuration automatique de l'étape :, puis choisissez Configurer la restauration automatique en cas de défaillance de la phase. Enregistrez les modifications apportées à votre pipeline.

    Un exemple d'écran d'édition pour configurer une étape annulée dans CodePipeline.

Configurer une étape pour la restauration automatique (CLI)

AWS CLI Pour configurer une étape ayant échoué 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éez un pipeline, des étapes et des actions etModifier un pipeline dans CodePipeline.

  • 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 la restauration automatique pour une étape nommée : 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 des étapes, consultez FailureConditions la référence de l'CodePipeline API.

Configurez une étape pour la restauration automatique (CloudFormation)

À utiliser CloudFormation pour configurer une étape pour qu'elle revienne automatiquement en cas d'échec, utilisez le OnFailure paramètre. En cas d'échec, la phase 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 la restauration automatique pour une étape nommée : 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 des étapes, consultez OnFailure le Guide StageDeclaration de l'CloudFormation utilisateur ci-dessous.