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.
# Konfiguration des Stage-Rollbacks
Sie können eine Phase auf eine Ausführung zurücksetzen, die in dieser Phase erfolgreich war. Sie können eine Phase für das Rollback bei einem Fehler vorkonfigurieren, oder Sie können eine Phase manuell rückgängig machen. Der Rollback-Vorgang führt zu einer neuen Ausführung. Die für das Rollback gewählte Ziel-Pipeline-Ausführung wird zum Abrufen von Quellrevisionen und Variablen verwendet.
Die Art der Ausführung, entweder Standard oder Rollback, wird im Pipeline-Verlauf, im Pipeline-Status und in den Details zur Pipeline-Ausführung angezeigt.
**Topics**
+ [
## Überlegungen zu Rollbacks
](#stage-rollback-considerations)
+ [
# Manuelles Rollback einer Phase
](stage-rollback-manual.md)
+ [
# Konfigurieren Sie eine Phase für das automatische Rollback
](stage-rollback-auto.md)
+ [
# Den Rollback-Status in der Ausführungsliste anzeigen
](stage-rollback-view-listing.md)
+ [
# Details zum Rollback-Status anzeigen
](stage-rollback-view-details.md)
## Überlegungen zu Rollbacks
Beim Stufen-Rollback sollten folgende Überlegungen angestellt werden:
+ Sie können eine Quellstufe nicht rückgängig machen.
+ Die Pipeline kann nur dann zu einer vorherigen Ausführung zurückkehren, wenn die vorherige Ausführung in der aktuellen Version der Pipeline-Struktur gestartet wurde.
+ Sie können nicht zu einer Ziel-Ausführungs-ID zurückkehren, bei der es sich um einen Rollback-Ausführungstyp handelt.
+ CodePipeline verwendet die Variablen und Artefakte aus der Ausführung, zu der ein Rollback durchgeführt wird.
# Manuelles Rollback einer Phase
Sie können eine Phase mithilfe der Konsole oder der CLI manuell rückgängig machen. Die Pipeline kann nur dann zu einer vorherigen Ausführung zurückkehren, wenn die vorherige Ausführung in der aktuellen Version der Pipeline-Struktur gestartet wurde.
Sie können eine Phase auch so konfigurieren, dass bei einem Fehler ein automatisches Rollback ausgeführt wird, wie unter beschrieben[Konfigurieren Sie eine Phase für das automatische Rollback](stage-rollback-auto.md).
## Manuelles Rollback einer Phase (Konsole)
Sie können die Konsole verwenden, um eine Phase manuell auf eine Ziel-Pipeline-Ausführung zurückzusetzen. Wenn eine Phase zurückgesetzt wird, wird in der Pipeline-Visualisierung in der Konsole ein **Rollback-Label** angezeigt.
**Manuelles Rollback einer Phase (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](https://console.aws.amazon.com/codesuite/codepipeline/home).
Die Namen und der Status aller mit Ihrem AWS Konto verknüpften Pipelines werden angezeigt.
1. Wählen Sie unter **Name** den Namen der Pipeline mit der Phase aus, für die ein Rollback ausgeführt werden soll.
![\[Ein Beispieldiagramm einer Pipeline mit zwei Stufen CodePipeline.\]](http://docs.aws.amazon.com/de_de/codepipeline/latest/userguide/images/rollback-stage-first.png)
1. Wählen Sie auf der Bühne **Rollback starten** aus. Das Dialogfeld **„Zurück zur** Seite“ wird angezeigt.
1. Wählen Sie die Zielausführung aus, auf die Sie die Phase zurücksetzen möchten.
**Anmerkung**
Die Liste der verfügbaren Ziel-Pipeline-Ausführungen umfasst alle Ausführungen in der aktuellen Pipeline-Version, die am 1. Februar 2024 beginnt.
![\[Ein Beispiel für die Auswahl der Zielausführungs-ID in. CodePipeline\]](http://docs.aws.amazon.com/de_de/codepipeline/latest/userguide/images/rollback-stage-dialog.png)
Das folgende Diagramm zeigt ein Beispiel für die Rollback-Stufe mit der neuen Ausführungs-ID.
![\[Ein Beispieldiagramm einer Pipeline mit einer Rollback-Phase CodePipeline.\]](http://docs.aws.amazon.com/de_de/codepipeline/latest/userguide/images/stage-rolled-back.png)
## Manuelles Rollback einer Phase (CLI)
Verwenden Sie den `rollback-stage` Befehl, AWS CLI um eine Phase manuell rückgängig zu machen.
Sie können eine Phase auch manuell rückgängig machen, wie unter beschrieben[Manuelles Rollback einer Phase](#stage-rollback-manual).
**Anmerkung**
Die Liste der verfügbaren Ziel-Pipeline-Ausführungen umfasst alle Ausführungen in der aktuellen Pipeline-Version, die am 1. Februar 2024 beginnt.
**So führen Sie ein manuelles Rollback einer Phase durch (CLI)**
1. Der CLI-Befehl für das manuelle Rollback erfordert die Ausführungs-ID einer zuvor erfolgreichen Pipeline-Ausführung in der Phase. Um die von Ihnen angegebene Ziel-Pipeline-Ausführungs-ID abzurufen, verwenden Sie den list-pipeline-executions Befehl mit einem Filter, der erfolgreiche Ausführungen in der Phase zurückgibt. Öffnen Sie ein Terminal (Linux, macOS oder Unix) oder eine Befehlszeile (Windows) und verwenden Sie die, AWS CLI um den `list-pipeline-executions` Befehl auszuführen. Geben Sie dabei den Namen der Pipeline und den Filter für erfolgreiche Ausführungen in der Phase an. In diesem Beispiel werden in der Ausgabe Pipeline-Ausführungen für die angegebene Pipeline MyFirstPipeline und für erfolgreiche Ausführungen in der genannten Phase aufgeführt. `deploys3`
```
aws codepipeline list-pipeline-executions --pipeline-name MyFirstPipeline --filter succeededInStage={stageName=deploys3}
```
Kopieren Sie in der Ausgabe die Ausführungs-ID der zuvor erfolgreichen Ausführung, die Sie für das Rollback angeben möchten. Sie werden diese im nächsten Schritt als Zielausführungs-ID verwenden.
1. Öffnen Sie ein Terminal (Linux, macOS oder Unix) oder eine Befehlszeile (Windows) und verwenden Sie die, AWS CLI um den `rollback-stage` Befehl auszuführen. Geben Sie dabei den Namen der Pipeline, den Namen der Phase und die Zielausführung an, zu der Sie zurückkehren möchten. Um beispielsweise eine Phase namens Deploy für eine Pipeline mit dem Namen „Bereitstellen“ rückgängig zu machen*MyFirstPipeline*:
```
aws codepipeline rollback-stage --pipeline-name MyFirstPipeline --stage-name Deploy --target-pipeline-execution-id bc022580-4193-491b-8923-9728dEXAMPLE
```
Die Ausgabe gibt die Ausführungs-ID für die neue Ausführung zurück, für die ein Rollback ausgeführt wurde. Dies ist eine separate ID, die die Quellversionen und Parameter der angegebenen Zielausführung verwendet.
# Konfigurieren Sie eine Phase für das automatische Rollback
Sie können Phasen in einer Pipeline so konfigurieren, dass sie bei einem Ausfall automatisch zurückgesetzt werden. Wenn die Phase fehlschlägt, wird die Phase auf die letzte erfolgreiche Ausführung zurückgesetzt. Die Pipeline kann nur dann zu einer vorherigen Ausführung zurückkehren, wenn die vorherige Ausführung in der aktuellen Version der Pipeline-Struktur gestartet wurde. Da die automatische Rollback-Konfiguration Teil der Pipeline-Definition ist, wird Ihre Pipeline-Phase erst nach einer erfolgreichen Pipeline-Ausführung in der Pipeline-Phase automatisch zurückgesetzt.
## Konfigurieren Sie eine Phase für das automatische Rollback (Konsole)
Sie können eine Phase auf eine bestimmte vorherige erfolgreiche Ausführung zurücksetzen. Weitere Informationen finden Sie [RollbackStage](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_RollbackStage.html)im *CodePipeline API-Leitfaden*.
**Konfigurieren Sie eine Phase 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](https://console.aws.amazon.com/codesuite/codepipeline/home).
Die Namen und der Status aller mit Ihrem AWS Konto verknüpften Pipelines werden angezeigt.
1. Wählen Sie im Feld **Name** den Namen der Pipeline aus, die Sie bearbeiten möchten.
1. Wählen Sie auf der Pipelinedetails-Seite **Edit** aus.
1. Wählen Sie auf der Seite **Bearbeiten** für die Aktion, die Sie bearbeiten möchten, die Option **Phase bearbeiten** aus.
1. 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 zur Konfiguration einer Rollback-Stage in CodePipeline.\]](http://docs.aws.amazon.com/de_de/codepipeline/latest/userguide/images/rollback-configure.png)
## Konfigurieren Sie eine Phase für automatisches Rollback (CLI)
AWS CLI Um die Phase „Fehlgeschlagen“ so zu konfigurieren, dass sie automatisch zur letzten erfolgreichen Ausführung zurückkehrt, verwenden Sie die Befehle zum Erstellen oder Aktualisieren einer Pipeline, wie unter [Eine Pipeline, Phasen und Aktionen erstellen](pipelines-create.md) und [Eine Pipeline bearbeiten in CodePipeline](pipelines-edit.md) beschrieben.
+ Ö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, wobei Sie die Fehlerbedingung in der Pipeline-Struktur angeben. Im folgenden Beispiel wird das automatische Rollback für ein Staging-Objekt 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 Stage-Rollback finden Sie [FailureConditions](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_FailureConditions.html)in der API-Referenz. CodePipeline *
## Konfigurieren Sie eine Phase für das automatische Rollback ()CloudFormation
Verwenden Sie CloudFormation den `OnFailure` Parameter, um eine Phase so zu konfigurieren, dass sie bei einem Fehler automatisch zurückgesetzt wird. Bei einem Fehler führt die Phase automatisch ein Rollback zur letzten erfolgreichen Ausführung durch.
```
OnFailure:
Result: ROLLBACK
```
+ Aktualisieren Sie die Vorlage wie im folgenden Codeausschnitt gezeigt. Im folgenden Beispiel wird das automatische Rollback für ein Staging-Objekt 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 Stage-Rollback finden Sie weiter unten `StageDeclaration` im [OnFailure](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-codepipeline-pipeline-stagedeclaration.html#cfn-codepipeline-pipeline-stagedeclaration-onfailure)Benutzerhandbuch.CloudFormation *
# Den Rollback-Status in der Ausführungsliste anzeigen
Sie können den Status und die Zielausführungs-ID für eine Rollback-Ausführung anzeigen.
## Den Rollback-Status in der Liste der Ausführungen anzeigen (Konsole)
Sie können die Konsole verwenden, um den Status und die Zielausführungs-ID für eine Rollback-Ausführung in der Ausführungsliste anzuzeigen.
**Den Status der Rollback-Ausführung in der Liste der Ausführungen anzeigen (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](https://console.aws.amazon.com/codesuite/codepipeline/home).
Die Namen und der Status aller Pipelines, die mit Ihrer verknüpft AWS-Konto sind, werden angezeigt.
1. Wählen Sie **unter Name** den Namen der Pipeline aus, die Sie anzeigen möchten.
1. Wählen Sie **History (Verlauf)** aus. In der Liste der Ausführungen wird die Bezeichnung **Rollback** angezeigt.
![\[Ein Beispiel für eine Seite mit dem Ausführungsverlauf, auf der das Rollback-Label angezeigt wird. CodePipeline\]](http://docs.aws.amazon.com/de_de/codepipeline/latest/userguide/images/rollback-view-list-console.png)
Wählen Sie die Ausführungs-ID aus, für die Sie Details anzeigen möchten.
## Rollback-Status anzeigen mit `list-pipeline-executions` (CLI)
Sie können die CLI verwenden, um den Status und die Zielausführungs-ID für eine Rollback-Ausführung anzuzeigen.
+ Öffnen Sie ein Terminal (Linux, macOS oder Unix) oder eine Befehlszeile (Windows) und verwenden Sie den AWS CLI , um den **list-pipeline-executions** Befehl auszuführen:
```
aws codepipeline list-pipeline-executions --pipeline-name MyFirstPipeline
```
Dieser Befehl gibt eine Liste aller abgeschlossenen Ausführungen zurück, die mit der Pipeline verknüpft sind.
Das folgende Beispiel zeigt die zurückgegebenen Daten für eine Pipeline mit dem Namen, *MyFirstPipeline* wo die Pipeline durch eine Rollback-Ausführung gestartet wurde.
```
{
"pipelineExecutionSummaries": [
{
"pipelineExecutionId": "eb7ebd36-353a-4551-90dc-18ca5EXAMPLE",
"status": "Succeeded",
"startTime": "2024-04-16T09:00:28.185000+00:00",
"lastUpdateTime": "2024-04-16T09:00:29.665000+00:00",
"sourceRevisions": [
{
"actionName": "Source",
"revisionId": "revision_ID",
"revisionSummary": "Added README.txt",
"revisionUrl": "console-URL"
}
],
"trigger": {
"triggerType": "ManualRollback",
"triggerDetail": "{arn:aws:sts:::assumed-role/"}"
},
"executionMode": "SUPERSEDED",
"executionType": "ROLLBACK",
"rollbackMetadata": {
"rollbackTargetPipelineExecutionId": "f15b38f7-20bf-4c9e-94ed-2535eEXAMPLE"
}
},
{
"pipelineExecutionId": "fcd61d8b-4532-4384-9da1-2aca1EXAMPLE",
"status": "Succeeded",
"startTime": "2024-04-16T08:58:56.601000+00:00",
"lastUpdateTime": "2024-04-16T08:59:04.274000+00:00",
"sourceRevisions": [
{
"actionName": "Source",
"revisionId": "revision_ID",
"revisionSummary": "Added README.txt",
"revisionUrl": "console_URL"
}
],
"trigger": {
"triggerType": "StartPipelineExecution",
"triggerDetail": "arn:aws:sts:::assumed-role/"
},
"executionMode": "SUPERSEDED"
},
{
"pipelineExecutionId": "5cd064ca-bff7-425f-8653-f41d9EXAMPLE",
"status": "Failed",
"startTime": "2024-04-24T19:19:50.781000+00:00",
"lastUpdateTime": "2024-04-24T19:19:52.119000+00:00",
"sourceRevisions": [
{
"actionName": "Source",
"revisionId": "",
"revisionSummary": "Edited README.txt",
"revisionUrl": ""
}
],
"trigger": {
"triggerType": "AutomatedRollback",
"triggerDetail": "{\"FailedPipelineExecutionId\":\"b2e77fa5-9285-4dea-ae66-4389EXAMPLE\"}"
},
"executionMode": "SUPERSEDED",
"executionType": "ROLLBACK",
"rollbackMetadata": {
"rollbackTargetPipelineExecutionId": "5efcfa68-d838-4ca7-a63b-4a743EXAMPLE"
}
},
```
# Details zum Rollback-Status anzeigen
Sie können den Status und die Zielausführungs-ID für eine Rollback-Ausführung anzeigen.
## Den Rollback-Status auf der Detailseite (Konsole) anzeigen
Sie können die Konsole verwenden, um den Status und die Ziel-Pipeline-Ausführungs-ID für eine Rollback-Ausführung anzuzeigen.
![\[Eine Beispielstatusseite mit dem Feld für die Ausführungs-ID der Zielpipeline in CodePipeline.\]](http://docs.aws.amazon.com/de_de/codepipeline/latest/userguide/images/rollback-view-status-console.png)
## Rollback-Details anzeigen mit `get-pipeline-execution` (CLI)
Pipeline-Ausführungen, für die ein Rollback vorgenommen wurde, werden in der Ausgabe zum Abrufen der Pipeline-Ausführung angezeigt.
+ Um Informationen zu einer Pipeline anzuzeigen, führen Sie den Befehl **[get-pipeline-execution](https://docs.aws.amazon.com/cli/latest/reference/codepipeline/get-pipeline-execution.html)** unter Angabe des eindeutigen Namens der Pipeline aus. Wenn Sie beispielsweise Details zu einer Pipeline mit dem Namen *MyFirstPipeline* anzeigen möchten, geben Sie Folgendes ein:
```
aws codepipeline get-pipeline-execution --pipeline-name MyFirstPipeline --pipeline-execution-id 3f658bd1-69e6-4448-ba3e-79007EXAMPLE
```
Dieser Befehl gibt die Struktur der Pipeline zurück.
Das folgende Beispiel zeigt die zurückgegebenen Daten für einen Teil einer Pipeline mit dem Namen*MyFirstPipeline*, in dem die Rollback-Ausführungs-ID und die Metadaten angezeigt werden.
```
{
"pipelineExecution": {
"pipelineName": "MyFirstPipeline",
"pipelineVersion": 6,
"pipelineExecutionId": "2004a94e-8b46-4c34-a695-c8d20EXAMPLE",
"status": "Succeeded",
"artifactRevisions": [
{
"name": "SourceArtifact",
"revisionId": "",
"revisionSummary": "Added README.txt",
"revisionUrl": ""
}
],
"trigger": {
"triggerType": "ManualRollback",
"triggerDetail": "arn:aws:sts:::assumed-role/"
},
"executionMode": "SUPERSEDED",
"executionType": "ROLLBACK",
"rollbackMetadata": {
"rollbackTargetPipelineExecutionId": "4f47bed9-6998-476c-a49d-e60beEXAMPLE"
}
}
}
```
## Rollback-Status anzeigen mit `get-pipeline-state` (CLI)
Pipeline-Ausführungen, für die ein Rollback vorgenommen wurde, werden in der Ausgabe zum Abrufen des Pipeline-Status angezeigt.
+ Um Informationen zu einer Pipeline anzuzeigen, führen Sie den Befehl **get-pipeline-state** unter Angabe des eindeutigen Namens der Pipeline aus. Um beispielsweise Statusdetails zu einer Pipeline mit dem Namen anzuzeigen*MyFirstPipeline*, geben Sie Folgendes ein:
```
aws codepipeline get-pipeline-state --name MyFirstPipeline
```
Das folgende Beispiel zeigt die zurückgegebenen Daten mit dem Rollback-Ausführungstyp.
```
{
"pipelineName": "MyFirstPipeline",
"pipelineVersion": 7,
"stageStates": [
{
"stageName": "Source",
"inboundExecutions": [],
"inboundTransitionState": {
"enabled": true
},
"actionStates": [
{
"actionName": "Source",
"currentRevision": {
"revisionId": ""
},
"latestExecution": {
"actionExecutionId": "13bbd05d-b439-4e35-9c7e-887cb789b126",
"status": "Succeeded",
"summary": "update",
"lastStatusChange": "2024-04-24T20:13:45.799000+00:00",
"externalExecutionId": "10cbEXAMPLEID"
},
"entityUrl": "console-url",
"revisionUrl": "console-url"
}
],
"latestExecution": {
"pipelineExecutionId": "cf95a8ca-0819-4279-ae31-03978EXAMPLE",
"status": "Succeeded"
}
},
{
"stageName": "deploys3",
"inboundExecutions": [],
"inboundTransitionState": {
"enabled": true
},
"actionStates": [
{
"actionName": "s3deploy",
"latestExecution": {
"actionExecutionId": "3bc4e3eb-75eb-45b9-8574-8599aEXAMPLE",
"status": "Succeeded",
"summary": "Deployment Succeeded",
"lastStatusChange": "2024-04-24T20:14:07.577000+00:00",
"externalExecutionId": "mybucket/SampleApp.zip"
},
"entityUrl": "console-URL"
}
],
"latestExecution": {
"pipelineExecutionId": "fdf6b2ae-1472-4b00-9a83-1624eEXAMPLE",
"status": "Succeeded",
"type": "ROLLBACK"
}
}
],
"created": "2024-04-15T21:29:01.635000+00:00",
"updated": "2024-04-24T20:12:24.480000+00:00"
}
```