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.
# Tutorial: Verwenden Sie eine AWS Step Functions Aufrufaktion in einer Pipeline
Sie können sie verwenden AWS Step Functions , um Zustandsmaschinen zu erstellen und zu konfigurieren. In diesem Tutorial erfahren Sie, wie Sie einer Pipeline eine Aufrufaktion hinzufügen, mit der die Ausführung von Zustandsautomaten über Ihre Pipeline aktiviert wird.
**Wichtig**
Im Rahmen der Erstellung einer Pipeline wird ein vom Kunden bereitgestellter S3-Artefakt-Bucket von CodePipeline for Artifacts verwendet. (Dies unterscheidet sich von dem Bucket, der für eine S3-Quellaktion verwendet wird.) Wenn sich der S3-Artefakt-Bucket in einem anderen Konto befindet als das Konto für Ihre Pipeline, stellen Sie sicher, dass der S3-Artefakt-Bucket denjenigen gehört AWS-Konten , die sicher und zuverlässig sind.
In diesem Tutorial führen Sie folgende Aufgaben aus:
+ Erstellen Sie eine Standard-Zustandsmaschine in. AWS Step Functions
+ Sie geben die Eingabedaten für den Zustandsautomaten direkt im JSON-Format ein. Sie können die State Machine-Eingabedatei auch in einen Amazon Simple Storage Service (Amazon S3) -Bucket hochladen.
+ Sie aktualisieren Ihre Pipeline, indem Sie die Zustandsautomaten-Aktion hinzufügen.
**Topics**
+ [Voraussetzung: Erstellen oder Auswählen einer einfachen Pipeline](#tutorials-step-functions-prereq)
+ [Schritt 1: Erstellen des Beispielzustandsautomaten](#tutorials-step-functions-sample)
+ [Schritt 2: Fügen Sie Ihrer Pipeline eine Aktion zum Aufrufen von Step Functions hinzu](#tutorials-step-functions-pipeline)
## Voraussetzung: Erstellen oder Auswählen einer einfachen Pipeline
In diesem Tutorial fügen Sie einer vorhandenen Pipeline eine Aufrufaktion hinzu. Sie können die Pipeline verwenden, die Sie in [Tutorial: Erstellen einer einfachen Pipeline (S3-Bucket)](tutorials-simple-s3.md) oder [Tutorial: Erstellen Sie eine einfache Pipeline (CodeCommit Repository)](tutorials-simple-codecommit.md) erstellt haben.
Sie verwenden in für diesem Beispiel eine vorhandene Pipeline mit einer Quellaktion und einer mindestens zweistufigen Struktur, jedoch keine Quellartefakte.
**Anmerkung**
Möglicherweise müssen Sie die Servicerolle, die von der Pipeline verwendet wird, mit zusätzlichen Berechtigungen aktualisieren, die zum Ausführen dieser Aktion erforderlich sind. Öffnen Sie dazu die AWS Identity and Access Management (IAM-) Konsole, suchen Sie nach der Rolle und fügen Sie dann die Berechtigungen zur Rollenrichtlinie hinzu. Weitere Informationen finden Sie unter [Fügen Sie der CodePipeline Servicerolle Berechtigungen hinzu](how-to-custom-role.md#how-to-update-role-new-services).
## Schritt 1: Erstellen des Beispielzustandsautomaten
Erstellen Sie in der Step Functions Functions-Konsole mithilfe der `HelloWorld` Beispielvorlage eine Zustandsmaschine. Anweisungen finden Sie unter [Create a State Machine](https://docs.aws.amazon.com/step-functions/latest/dg/getting-started.html#create-state-machine) im *AWS Step Functions Entwicklerhandbuch*.
## Schritt 2: Fügen Sie Ihrer Pipeline eine Aktion zum Aufrufen von Step Functions hinzu
Fügen Sie Ihrer Pipeline wie folgt eine Aktion zum Aufrufen von Step Functions hinzu:
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 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. Auf diese Weise wird eine detaillierte Ansicht der Pipeline geöffnet (einschließlich des Status der Aktionen in den einzelnen Stufen der Pipeline).
1. Wählen Sie auf der Pipelinedetails-Seite **Edit** aus.
1. Wählen Sie in der zweiten Phase Ihrer einfachen Pipeline die Option **Edit stage (Phase bearbeiten)**aus. Wählen Sie **Löschen** aus. Dadurch wird die zweite Phase gelöscht, die Sie nicht mehr benötigen.
1. Wählen Sie unten im Diagramm **\$1 Add stage (\$1 Stufe hinzufügen)** aus.
1. Geben Sie unter **Stage Name (Name der Phase)** einen Namen für die Phase ein, etwa **Invoke**, und wählen Sie dann **Add stage (Phase hinzufügen)**.
1. Wählen Sie **\$1 Add action group (Aktionsgruppe hinzufügen)**.
1. Geben Sie unter **Action name (Aktionsname)** einen Namen ein, z. B. **Invoke**.
1. Wählen Sie unter **Aktionsanbieter** die Option **AWS Step Functions** aus. Belassen Sie unter **Region** als Standardeinstellung die Pipeline-Region.
1. Wählen Sie unter **Input artifacts (Eingabeartefakte)** die Option `SourceArtifact` aus.
1. Wählen Sie unter **State machine ARN (Zustandsautomaten-ARN)** den von Ihnen zuvor für den Zustandsautomaten erstellten Amazon-Ressourcennamen (ARN) aus.
1. (Optional) Geben Sie unter **Execution name prefix (Präfix des Ausführungsnamens)** ein Präfix ein, das der Ausführungs-ID des Zustandsautomaten hinzugefügt werden soll.
1. Wählen Sie unter **Input type (Eingabetyp)** die Option **Literal**.
1. Geben Sie unter **Input (Eingabe)** die Eingabe im JSON-Format ein, den der `HelloWorld` Beispielzustandsautomat erwartet.
**Anmerkung**
Die Eingabe für die State-Machine-Ausführung unterscheidet sich von dem Begriff, der CodePipeline zur Beschreibung von Eingabeartefakten für Aktionen verwendet wird.
Geben Sie in diesem Beispiel den folgenden JSON-Code ein:
```
{"IsHelloWorldExample": true}
```
1. Wählen Sie **Fertig** aus.
1. Wählen Sie die Phase aus, die Sie bearbeiten, und wählen Sie dann **Done (Fertig)**. Wählen Sie im AWS CodePipeline -Fenster **Save (Speichern)** und dann in der Warnmeldung **Save (Speichern)**.
1. Um Ihre Änderungen zu übertragen und eine Pipelineausführung zu starten, wählen Sie **Release change (Änderung freigeben)** und dann **Release (Freigeben)**.
1. Wählen Sie in Ihrer abgeschlossenen Pipeline in Ihrer Aufrufaktion **AWS Step Functions** aus. Sehen Sie sich in der AWS Step Functions Konsole Ihre State-Machine-Ausführungs-ID an. Die ID enthält den Namen des Zustandsautomaten `HelloWorld` und die Ausführungs-ID des Zustandsautomaten mit dem Präfix `my-prefix`.
```
arn:aws:states:us-west-2:account-ID:execution:HelloWorld:my-prefix-0d9a0900-3609-4ebc-925e-83d9618fcca1
```