Arbeiten mit AWS Step Functions

Sie können den AWS Toolkit for Visual Studio Code (VS-Code) verwenden, um verschiedene Operationen mit Zustandsmaschinen auszuführen.

Voraussetzungen

• Stellen Sie sicher, dass Ihr System die unter Installation des Toolkit for VS Code angegebenen Voraussetzungen erfüllt, und installieren Sie dann das Toolkit.

• Stellen Sie sicher, dass Sie Ihre Anmeldeinformationen konfiguriert haben, bevor Sie den AWS Explorer öffnen.

Arbeiten Sie mit Zustandsmaschinen in VS Code

Sie können VS Code verwenden, um mit Remote-Zustandsmaschinen zu interagieren und Zustandsmaschinen lokal im JSON- oder YAML-Format zu entwickeln. Sie können Zustandsmaschinen erstellen oder aktualisieren, vorhandene Zustandsmaschinen auflisten, sie ausführen und herunterladen. Mit VS Code können Sie auch neue Zustandsautomaten aus Vorlagen erstellen, eine Visualisierung Ihres Zustandsautomaten anzeigen und Codeausschnitte, Codevervollständigung und Codevalidierung bereitstellen.

Vorhandene Zustandsmaschinen auflisten

Wenn Sie bereits Zu8standsautomaten erstellt haben, können Sie eine Liste dieser Automaten anzeigen:

1. Öffnen Sie den AWS Explorer.

2. Wählen Sie Step Functions

3. Prüfen Sie, ob alle Zustandsautomaten in Ihrem Konto aufgelistet sind.

   

Laden Sie eine Zustandsmaschine herunter

So laden Sie einen Zustandsautomaten herunter:

1. Klicken Sie im AWS Explorer mit der rechten Maustaste auf den State Machine, den Sie herunterladen möchten.

2. Wählen Sie „Download (Herunterladen)“ aus, und wählen Sie dann den Speicherort aus, an dem Sie den Zustandsautomaten herunterladen möchten.

3. Überprüfen Sie, ob er richtig heruntergeladen wurde.

   

Erstellen eines Zustandsautomaten

Sie können selbst einen neuen Zustandsautomaten erstellen oder eine Vorlage verwenden. Weitere Informationen zum Erstellen eines Zustandsautomaten aus einer Vorlage finden Sie im Abschnitt Vorlagen für Zustandsautomaten. So erstellen Sie einen neuen Zustandsautomaten:

1. Erstellen Sie eine neue Amazon States Language (ASL)-Datei mit Ihrer Zustandsautomatendefinition. Verwenden Sie das Menü unten rechts, um es als Amazon States Language festzulegen.

2. Wählen Sie Publish to Step Functions (Zu Schrittfunktionen veröffentlichen).

   

3. Wählen Sie Quick Create (Schnellerstellung), wählen Sie eine Rolle aus, und benennen Sie Ihren Zustandsautomaten.

   
   
   

Aktualisieren eines Zustandsautomaten

So aktualisieren Sie einen Zustandsautomaten:

1. Bearbeiten Sie die ASL-Datei mit Ihrer Zustandsautomatendefinition.

2. Wählen Sie Publish to Step Functions (Zu Schrittfunktionen veröffentlichen).

   

3. Wählen Sie Quick Update (Schnellaktualisierung) aus, und wählen Sie dann den Zustandsautomaten aus, den Sie aktualisieren möchten.

   
   

Führen Sie eine Zustandsmaschine aus

Um eine Zustandsmaschine auszuführen:

1. Klicken Sie im AWS Explorer mit der rechten Maustaste auf den Zustandsmaschine, den Sie ausführen möchten.

2. Geben Sie Eingaben für die Zustandsmaschine ein. Sie können sowohl die Eingabe aus einer Datei als auch die Eingabe in ein Textfeld versuchen.

3. Starten Sie den Zustandsmaschine und stellen Sie sicher, dass er erfolgreich ausgeführt wird.

   
   

Vorlagen für Zustandsmaschinen

Wenn Sie einen Zustandsautomaten erstellen, haben Sie die Möglichkeit, ihn aus einer Vorlage zu erstellen. Die Vorlage enthält eine Beispieldefinition für einen Zustandsautomaten mit mehreren häufig verwendeten Zuständen und stellt Ihnen einen Startpunkt zur Verfügung. So verwenden Sie Vorlagen für Zustandsautomaten::

1. Öffnen Sie die Befehlspalette in VS Code.

2. Wählen Sie AWS Toolkit Create a new Step Functions State Machine aus.

3. Wählen Sie die gewünschte Vorlage aus.

   

4. Wählen Sie aus, ob Sie das JSON- oder das YAML-Vorlagenformat verwenden möchten.

   

Visualisierung von Zustandsmaschinen

Mit grafischen Visualisierungen können Sie sehen, wie Ihr Zustandsautomat im grafischen Format aussieht. Wenn Sie eine Graphvisualisierung erstellen, wird eine weitere Registerkarte geöffnet, auf der eine Visualisierung der Zustandsmaschine JSON oder YAML angezeigt wird. Sie können dann die Zustandsautomatendefinition, die Sie schreiben, gleichzeitig mit der Visualisierung vergleichen. Wenn Sie die Zustandsautomatendefinition ändern, wird die Visualisierung aktualisiert.

Anmerkung

Um eine Visualisierung einer Zustandsautomatendefinition zu erstellen, muss die Definition im aktiven Editor geöffnet sein. Wenn Sie die Definitionsdatei schließen oder umbenennen, wird die Visualisierung geschlossen.

So erstellen Sie eine Visualisierung eines Zustandsautomatendiagramms:

1. Definieren Sie Ihren Zustandsautomaten.

2. Öffnen Sie die Befehlspalette in VS Code.

3. Um eine Visualisierung zu erstellen, verwenden Sie die Visualisierungsschaltfläche in der oberen rechten Ecke oder wählen Sie Diagramm AWS rendern.

   

Codefragmente

Mit Codeausschnitten können Sie kurze Codeteile einfügen. So verwenden Sie Codeausschnitte:

1. Öffnen Sie eine Datei und speichern Sie sie mit der Erweiterung .asl.json für das JSON-Format oder .asl.yaml für das YAML-Format.

2. Erstellen Sie einen neuen Zustandsautomaten mit der Eigenschaft States (Zustände) .

3. Platzieren Sie den Cursor innerhalb von States (Zustände).

4. Verwenden Sie die Tastenkombination Control + Space, und wählen Sie Ihren bevorzugten Codeausschnitt aus.

5. Verwenden Sie Tab, um die Variable und Parameter in dem Codeausschnitt zu durchlaufen.

6. Testen Sie die Ausschnitte Retry und Catch, indem Sie den Cursor in den jeweiligen Zustand setzen.

   

Vervollständigung und Validierung des Codes

So sehen Sie, wie die Code-Vervollständigung funktioniert:

1. Erstellen Sie mehrere Zustände.

2. Platzieren Sie den Cursor hinter einer Next StartAt- oder Default-Eigenschaft.

3. Verwenden Sie die Tastenkombination Control + Space, um verfügbare Vervollständigungen aufzulisten. Sie können erneut mit Control + Space auf zusätzliche Eigenschaften zugreifen, basierend auf der Type von State.

4. Während der Arbeit erfolgt die Code-Validierung für:

   • Fehlende Eigenschaften

   • Inkorrekte Werte

   • Fehlenden Beendigungsstatus

   • Nicht vorhandene Zustände, auf die verwiesen wird