View a markdown version of this page

Konfigurieren Sie eine Phase für das automatische Rollback - AWS CodePipeline
Konfigurieren Sie eine Phase für das automatische Rollback (Konsole)Konfigurieren Sie eine Phase für das automatische Rollback (CLI)Konfigurieren Sie eine Phase für das automatische Rollback (CloudFormation)

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Konfigurieren Sie eine Phase für das automatische Rollback

Sie können Stufen in einer Pipeline so konfigurieren, dass sie bei einem Ausfall automatisch rückgängig gemacht werden. Wenn die Phase fehlschlägt, wird die Phase auf die letzte erfolgreiche Ausführung zurückgesetzt. Die Pipeline kann nur dann zu einer früheren Ausführung zurückkehren, wenn die vorherige Ausführung in der aktuellen Pipeline-Strukturversion gestartet wurde. Da die automatische Rollback-Konfiguration Teil der Pipeline-Definition ist, erfolgt für Ihre Pipeline-Phase ein automatisches Rollback erst, wenn in der Pipeline-Phase eine erfolgreiche Pipeline-Ausführung erfolgt ist.

Konfigurieren Sie eine Phase für das automatische Rollback (Konsole)

Sie können eine Phase auf eine angegebene vorherige erfolgreiche Ausführung zurücksetzen. Weitere Informationen finden Sie RollbackStage im CodePipeline API-Handbuch.

Konfigurieren Sie eine Stufe für das automatische Rollback (Konsole)

  1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die CodePipeline Konsole unter http://console.aws.amazon.com/codesuite/codepipeline/home.

    Die Namen und der Status aller mit Ihrem AWS Konto verknüpften Pipelines werden angezeigt.

  2. Wählen Sie im Feld Name den Namen der Pipeline aus, die Sie bearbeiten möchten.

  3. Wählen Sie auf der Pipelinedetails-Seite Edit aus.

  4. Wählen Sie auf der Seite „Bearbeiten“ für die Aktion, die Sie bearbeiten möchten, die Option Phase bearbeiten aus.

  5. Wählen Sie Automatisierte Stufenkonfiguration: und wählen Sie dann Automatisches Rollback bei Stufenausfall konfigurieren aus. Speichern Sie die Änderungen an Ihrer Pipeline.

    Ein Beispiel für einen Bearbeitungsbildschirm zum Konfigurieren einer Rollback-Stufe CodePipeline.

Konfigurieren Sie eine Phase für das automatische Rollback (CLI)

Um eine fehlgeschlagene Phase so zu konfigurieren, dass sie automatisch zur letzten erfolgreichen Ausführung zurückkehrt, verwenden Sie die Befehle, um eine Pipeline zu erstellen oder zu aktualisieren, wie in Erstellen Sie eine Pipeline, Stufen und Aktionen und Eine Pipeline bearbeiten in CodePipeline beschrieben. AWS CLI

  • Öffnen Sie ein Terminal (Linux, macOS oder Unix) oder eine Befehlszeile (Windows) und verwenden Sie die, AWS CLI um den update-pipeline Befehl auszuführen. Geben Sie dabei die Fehlerbedingung in der Pipeline-Struktur an. Im folgenden Beispiel wird das automatische Rollback für eine Stufe mit dem Namen konfiguriert: 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"
                }
            }

    Weitere Informationen zur Konfiguration von Fehlerbedingungen für das Stagen-Rollback finden Sie FailureConditions in der CodePipeline API-Referenz.

Konfigurieren Sie eine Phase für das automatische Rollback (CloudFormation)

Verwenden Sie CloudFormation den OnFailure Parameter, um eine Stufe so zu konfigurieren, dass sie bei einem Ausfall automatisch rückgängig gemacht wird. Bei einem Ausfall wird die Stufe automatisch auf die letzte erfolgreiche Ausführung zurückgesetzt.

OnFailure:
     Result: ROLLBACK

  • Aktualisieren Sie die Vorlage wie im folgenden Codeausschnitt gezeigt. Im folgenden Beispiel wird das automatische Rollback für eine Stufe mit dem Namen konfiguriert: 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'

    Weitere Informationen zur Konfiguration der Fehlerbedingungen für das Stagen-Rollback finden Sie OnFailure unter StageDeclaration im CloudFormation Benutzerhandbuch.