View a markdown version of this page

Arbeiten mit AWS Step Functions - AWS Toolkit für VS Code
Zustandsautomaten von Step Functions anzeigenEine Step Functions-Zustandsmaschine erstellenErstellen einer Step Functions-Zustandsmaschine aus einer VorlageHerunterladen einer Step Functions-ZustandsmaschineSpeichern von Änderungen an einer Step Functions-ZustandsmaschineAusführen einer Step Functions-ZustandsmaschineArbeiten mit CodefragmentenCode-Validierung

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.

Arbeiten mit AWS Step Functions

In den folgenden Abschnitten wird beschrieben, wie Sie mit AWS Step Functions Amazon State Language (ASL) Dateien arbeiten, die State-Machine-Definitionen im AWS Toolkit enthalten. Ausführliche Informationen zu AWS Step Functions Zustandsmaschinen finden Sie im Thema Learn about State Machines in Step Functions im AWS Step Functions Entwicklerhandbuch.

Zustandsautomaten von Step Functions anzeigen

Gehen Sie wie folgt vor, um Ihre vorhandenen ASL Dateien mit State-Machine-Definitionen im AWS Toolkit Explorer anzuzeigen.

  1. Erweitern Sie im AWS Toolkit Explorer den Bereich, der die ASL Datei enthält, die Sie anzeigen möchten.

  2. Erweitern Sie die Überschrift Step Functions.

  3. Ihre ASL Dateien werden im AWS Explorer angezeigt.

Eine Step Functions-Zustandsmaschine erstellen

Im AWS Toolkit können Sie eine neue Step Functions-Zustandsmaschine aus einer Datei erstellen oder eine Vorlage verwenden. Das folgende Verfahren beschreibt, wie Sie einen Step Functions-Zustandsmaschine aus einer Datei erstellen. Einzelheiten zum Erstellen einer SFN; State Machine aus einer Vorlage finden Sie im Abschnitt State-Machine-Vorlagen weiter unten in diesem Thema des Benutzerhandbuchs.

Anmerkung

Um mit Step Functions in VS Code zu arbeiten, muss die Erweiterung Ihrer Amazon State Language (ASL) -Datei, die Ihre State-Machine-Definition enthältasl.json, mitasl.yml, oder enden. .asl.yaml

Standardmäßig werden relevante Step Functions-Dateien in Workflow Studio geöffnet. Ausführliche Informationen zur Arbeit in Workflow Studio mithilfe des AWS Toolkits finden Sie im Thema Arbeiten mit Workflow Studio in diesem Benutzerhandbuch.

  1. Erstellen Sie in Ihrem Arbeitsbereich in VS Code eine neue Datei.

  2. Benennen Sie Ihre Datei und geben Sie die Dateierweiterung als asl.jsonasl.yml, oder an.asl.yaml.

  3. Nach der Erstellung öffnet das AWS Toolkit die neue Datei in AWS Step Functions Workflow Studio.

  4. Wählen Sie in Workflow Studio im Utility-Menü die Schaltfläche Speichern, um Ihre neue ASL Datei zu speichern.

Erstellen einer Step Functions-Zustandsmaschine aus einer Vorlage

Im AWS Toolkit können Sie eine Step Functions-Zustandsmaschine aus einer Vorlage erstellen. Der Vorlagenprozess erstellt eine ASL Datei, die eine Zustandsmaschinen-Definition enthält und als Ausgangspunkt für Ihr Projekt dient. Das folgende Verfahren beschreibt, wie Sie eine Step Functions-Zustandsmaschine aus einer Vorlage im AWS Toolkit erstellen.

  1. Erweitern Sie im AWS Toolkit Explorer den Bereich, in dem Sie einen Step Functions-Zustandsmaschine erstellen möchten.

  2. Öffnen Sie das Kontextmenü für Step Functions (mit der rechten Maustaste) und wählen Sie Create a new Step Functions State Machine, um den Assistenten zur Auswahl einer Startervorlage (1/2) in VS Code zu öffnen.

  3. Wählen Sie im Assistenten zur Auswahl einer Startervorlage (1/2) den Vorlagentyp für Ihre Step Functions-Zustandsmaschine aus, um fortzufahren.

  4. Wählen Sie auf dem Bildschirm „Vorlagenformat auswählen“ (2/2) entweder YAML oder JSON für Ihr Vorlagenformat aus.

  5. Eine neue ASL Datei mit Ihrer State-Machine-Definition wird im VS Code-Editor geöffnet.

Herunterladen einer Step Functions-Zustandsmaschine

Gehen Sie wie folgt vor, um einen remote gespeicherten Step Functions-Zustandsmaschine auf Ihre lokale Instanz von VS Code herunterzuladen.

  1. Erweitern Sie im AWS Toolkit Explorer die Region, die den Step Functions-Zustandsmaschine enthält, den Sie herunterladen möchten.

  2. Erweitern Sie Step Functions, klicken Sie dann mit der rechten Maustaste auf den Step Functions State Machine, den Sie herunterladen möchten, und wählen Sie Definition herunterladen... .

  3. Geben Sie einen Ort an, an dem Ihre Step Functions-Zustandsmaschine lokal gespeichert werden soll, um fortzufahren.

  4. Der Step Functions-Zustandsmaschine wird in Workflow Studio geöffnet, wenn der Vorgang abgeschlossen ist.

Speichern von Änderungen an einer Step Functions-Zustandsmaschine

Das folgende Verfahren beschreibt, wie Sie Änderungen speichern, die Sie an Ihrer Step Functions-Zustandsmaschine vorgenommen haben.

Anmerkung

In Workflow Studio vorgenommene Änderungen werden mit Ihrer lokalen Datei synchronisiert, bleiben jedoch nicht gespeichert, bis Ihre Arbeit im VS Code-Editor oder in Workflow Studio gespeichert wird. Wenn Ihre lokale Datei geändert und gespeichert wird, während Workflow Studio geöffnet ist und in Ihrer ASL Datei keine Fehler festgestellt wurden, erhalten Sie in Workflow Studio eine Erfolgsmeldung, wenn das Speichern abgeschlossen ist. Wenn Ihre lokale Datei jedoch eine JSON ungültige Datei enthält YAML und Sie versuchen, sie zu speichern, kann Ihre lokale Datei nicht synchronisiert werden und Sie erhalten eine Warnmeldung in Workflow Studio.

  1. Navigieren Sie in einer geöffneten ASL Datei mit einer State-Machine-Definition in Workflow Studio zu den Utility-Schaltflächen.

  2. Wählen Sie die Schaltfläche Save (Speichern) aus.

  3. VS Code benachrichtigt Sie, wenn die Datei gespeichert wurde.

Ausführen einer Step Functions-Zustandsmaschine

Das folgende Verfahren beschreibt, wie eine Step Functions-Zustandsmaschine im AWS Toolkit ausgeführt wird.

  1. Erweitern Sie im AWS Toolkit Explorer den Bereich, in dem sich der Step Functions-Zustandsmaschine befindet, den Sie ausführen möchten.

  2. Erweitern Sie Step Functions und klicken Sie dann mit der rechten Maustaste auf den Step Functions-Zustandsmaschine, den Sie ausführen möchten.

  3. Wählen Sie im Kontextmenü Start Execution, um den Startvorgang zu starten.

  4. Der Status des Starts wird im AWS Toolkit-Ausgabefenster in VS Code angezeigt.

Arbeiten mit Codefragmenten

Codefragmente sind automatische Vorschläge, die auf der Grundlage des Codes generiert werden, an dem Sie gerade arbeiten. Gehen Sie wie folgt vor, um mit Codefragmenten mit den Step Functions im Toolkit zu arbeiten.

Anmerkung

Um mit Step Functions-Codefragmenten in VS Code zu arbeiten, muss die Erweiterung Ihrer ASL Datei, die Ihre State-Machine-Definition enthält, mit, oder enden. .asl.json .asl.yml .asl.yaml

Standardmäßig werden Ihre relevanten Step Functions-Dateien in Workflow Studio geöffnet.

  1. Öffnen Sie in VS Code eine ASL Datei mit der State-Machine-Definition, die Sie ändern möchten, oder erstellen Sie eine neue ASL Datei.

  2. Wechseln Sie von Workflow Studio in den Code-Modus, wenn Sie sich im Entwurfsmodus befinden.

  3. Platzieren Sie im Workflow Studio-Code-Editor den Cursor auf die "States" Eigenschaft.

  4. Drücken Siecontrol + space, um das Menü mit den Codefragmenten zu öffnen. Zusätzliche Eigenschaften können durch Drücken der Taste aufgerufen werden control + space und basieren auf dem. "State" "Type"

  5. Wählen Sie den gewünschten Codeausschnitt aus der Liste aus.

Code-Validierung

Während Sie in Workflow Studio an Step Functions arbeiten, identifiziert die Codevalidierung aktiv Fehler und macht Vorschläge für Folgendes:

  • Fehlende Eigenschaften

  • Inkorrekte Werte

  • Nicht terminaler Zustand

  • Nicht vorhandene Zustände, auf die verwiesen wird