Konfiguration des Wiederholungsversuchs für eine fehlgeschlagene Phase oder für fehlgeschlagene Aktionen

Um eine fehlgeschlagene Phase oder fehlgeschlagene Aktionen in einer Phase zu wiederholen — 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 aller mit Ihrem AWS Konto verknüpften Pipelines werden angezeigt.

2. Wählen Sie im Feld Name den Namen der Pipeline.

3. Suchen Sie die Phase mit der fehlgeschlagenen Aktion und wählen Sie dann eine der folgenden Optionen aus:

   • Um alle Aktionen in der Phase zu wiederholen, wählen Sie Phase wiederholen.

   • Um nur fehlgeschlagene Aktionen in der Phase zu wiederholen, wählen Sie Fehlgeschlagene Aktionen wiederholen.

   

   Wenn alle wiederholten Aktionen in der Stufe erfolgreich abgeschlossen sind, wird die Pipeline weiter ausgeführt.

Um eine fehlgeschlagene Phase oder fehlgeschlagene Aktionen in einer Phase zu wiederholen — CLI

Um die zu verwenden AWS CLI , um alle Aktionen oder alle fehlgeschlagenen Aktionen erneut zu versuchen, führen Sie den retry-stage-execution Befehl mit den folgenden Parametern aus:

--pipeline-name <value>
--stage-name <value>
--pipeline-execution-id <value>
--retry-mode ALL_ACTIONS/FAILED_ACTIONS

1. Führen Sie den Befehl an einem Terminal (Linux, macOS oder Unix) oder einer retry-stage-execution Befehlszeile (Windows) aus, wie im folgenden Beispiel für eine Pipeline mit dem Namen gezeigtMyPipeline.

   aws codepipeline retry-stage-execution --pipeline-name MyPipeline --stage-name Deploy --pipeline-execution-id b59babff-5f34-EXAMPLE --retry-mode FAILED_ACTIONS

   Die Ausgabe gibt die Ausführungs-ID zurück:

   {
       "pipelineExecutionId": "b59babff-5f34-EXAMPLE"
   }

2. Sie können den Befehl auch mit einer JSON-Eingabedatei ausführen. Sie erstellen zunächst eine JSON-Datei, die die Pipeline, die Stufe mit den fehlgeschlagenen Aktionen und die letzte Pipeline-Ausführung in dieser Stufe ermittelt. Führen Sie den Befehl retry-stage-execution mit dem Parameter --cli-input-json aus. Am einfachsten können Sie die für die JSON-Datei benötigten Details über den Befehl get-pipeline-state abrufen.

   1. Führen Sie den Befehl an einem Terminal (Linux, macOS oder Unix) oder einer get-pipeline-state Befehlszeile (Windows) in einer Pipeline aus. Für eine Pipeline mit dem Namen würden Sie MyFirstPipeline beispielsweise etwas eingeben, das dem Folgenden ähnelt:

      aws codepipeline get-pipeline-state --name MyFirstPipeline

      Die Ausgabe des Befehls umfasst die Pipeline-Statusinformationen für jede einzelne Stufe. Im folgenden Beispiel zeigt die Ausgabe, dass eine oder mehrere Aktionen in der Staging-Stufe fehlgeschlagen sind:

      {
          "updated": 1427245911.525,
          "created": 1427245911.525,
          "pipelineVersion": 1,
          "pipelineName": "MyFirstPipeline",
          "stageStates": [
              {
                  "actionStates": [...],
                  "stageName": "Source",
                  "latestExecution": {
                      "pipelineExecutionId": "9811f7cb-7cf7-SUCCESS",
                      "status": "Succeeded"
                  }
              },
              {
                  "actionStates": [...],
                  "stageName": "Staging",
                  "latestExecution": {
                      "pipelineExecutionId": "3137f7cb-7cf7-EXAMPLE",
                      "status": "Failed"
                  }
              }
          ]
      }

   2. Erstellen Sie in einem Texteditor eine Datei im JSON-Format, in der Sie Folgendes festhalten:

      • Der Name der Pipeline mit den fehlgeschlagenen Aktionen

      • Der Name der Stufe mit den fehlgeschlagenen Aktionen

      • Die ID der letzten Pipeline-Ausführung in der Stufe

      • Der Retry-Modus.

      Für das vorherige MyFirstPipeline Beispiel würde Ihre Datei ungefähr so aussehen:

      {
          "pipelineName": "MyFirstPipeline",
          "stageName": "Staging",
          "pipelineExecutionId": "3137f7cb-7cf7-EXAMPLE",
          "retryMode": "FAILED_ACTIONS"
      }

   3. Speichern Sie die Datei mit einem Namen wie retry-failed-actions.json.

   4. Rufen Sie die beim Ausführen des Befehls retry-stage-execution erstellte Datei auf. Beispiel:

      Wichtig

      Achten Sie darauf, dass file:// vor dem Dateinamen steht. Dies ist bei diesem Befehl erforderlich.

      aws codepipeline retry-stage-execution --cli-input-json file://retry-failed-actions.json

   5. Um die Ergebnisse des Wiederholungsversuchs anzuzeigen, öffnen Sie entweder die CodePipeline Konsole und wählen Sie die Pipeline aus, die die fehlgeschlagenen Aktionen enthält, oder verwenden Sie den get-pipeline-state Befehl erneut. Weitere Informationen finden Sie unter Pipelines und Details anzeigen in CodePipeline.

Konfigurieren Sie eine Phase für die automatische Wiederholung (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 Automatische Wiederholung bei Ausfall einer Phase aktivieren aus. Speichern Sie die Änderungen an Ihrer Pipeline.

6. Wählen Sie unter Automatisierte Stufenkonfiguration: einen der folgenden Wiederholungsmodi aus:

   • Um anzugeben, dass der Modus alle Aktionen in der Phase wiederholt, wählen Sie „Fehlgeschlagene Phase wiederholen“.

   • Um festzulegen, dass der Modus nur fehlgeschlagene Aktionen in der Phase wiederholt, wählen Sie Fehlgeschlagene Aktionen wiederholen.

   Speichern Sie die Änderungen an Ihrer Pipeline.

   

7. Wenn die Phase nach der Ausführung Ihrer Pipeline ausfällt, wird der automatische Wiederholungsversuch unternommen. Die folgenden Beispiele zeigen eine Build-Phase, die automatisch wiederholt wurde.

   

8. Um Details zum Wiederholungsversuch anzuzeigen, wählen Sie. Das Fenster wird angezeigt.

   

• Öffnen Sie ein Terminal (Linux, macOS oder Unix) oder eine Eingabeaufforderung (Windows) und verwenden Sie den, AWS CLI um den update-pipeline Befehl auszuführen. Geben Sie dabei die Fehlerbedingung in der Pipeline-Struktur an. Im folgenden Beispiel wird die automatische Wiederholung 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": "RETRY",
                      "retryConfiguration": {
                          "retryMode": "ALL_ACTIONS",
                      },
              } 

• Aktualisieren Sie die Vorlage wie im folgenden Codeausschnitt gezeigt. Im folgenden Beispiel wird die automatische Wiederholung 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: RETRY
             RetryConfiguration: 
                RetryMode: ALL_ACTIONS
      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 von Wiederholungsversuchen im Fehlerfall finden Sie OnFailure unter StageDeclaration im CloudFormation Benutzerhandbuch.