Erstellen eines Workflows mit Workflow Studio in Step Functions - AWS Step Functions

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.

Erstellen eines Workflows mit Workflow Studio in Step Functions

Erfahren Sie, wie Sie Workflows mit Step Functions Workflow Studio erstellen, bearbeiten und ausführen. Sobald Ihr Workflow fertig ist, können Sie ihn speichern, ausführen und exportieren.

Erstellen eines Zustandsautomaten

In Workflow Studio können Sie entweder eine Startvorlage oder eine leere Vorlage auswählen, um einen Workflow zu erstellen.

Eine Startvorlage ist ein ready-to-run Beispielprojekt, das automatisch den Workflow-Prototyp und die Workflow-Definition erstellt und alle zugehörigen AWS Ressourcen bereitstellt, die Ihr Projekt für Sie AWS-Konto benötigt. Sie können diese Startvorlagen verwenden, um sie unverändert bereitzustellen und auszuführen, oder die Workflow-Prototypen verwenden, um darauf aufzubauen. Weitere Informationen zu Starter-Vorlagen finden Sie unterStellen Sie eine Zustandsmaschine mithilfe einer Startvorlage für Step Functions bereit.

Bei einer leeren Vorlage verwenden Sie den Entwurfs - oder Codemodus, um Ihren benutzerdefinierten Workflow zu erstellen.

Erstellen Sie eine Zustandsmaschine mithilfe einer Startvorlage

  1. Öffnen Sie die Step Functions Functions-Konsole und wählen Sie Create State Machine.

  2. Führen Sie im Dialogfeld „Vorlage auswählen“ einen der folgenden Schritte aus, um ein Beispielprojekt auszuwählen:

    • Geben Sie Task Timer in das Feld Nach Schlüsselwort suchen einen Text ein, und wählen Sie dann in den Suchergebnissen die Option Task-Timer aus.

    • Durchsuchen Sie die Beispielprojekte, die im rechten Bereich unter Alle aufgeführt sind, und wählen Sie dann Task Timer aus.

  3. Wählen Sie Next (Weiter), um fortzufahren.

  4. Step Functions listet die Funktionen auf, die in dem von Ihnen ausgewählten Beispielprojekt AWS -Services verwendet wurden. Außerdem wird ein Workflow-Diagramm für das Beispielprojekt angezeigt. Stellen Sie dieses Projekt für Ihr Projekt bereit AWS-Konto oder verwenden Sie es als Ausgangspunkt für die Erstellung Ihrer eigenen Projekte. Je nachdem, wie Sie vorgehen möchten, wählen Sie „Demo ausführen“ oder „Darauf aufbauen“.

  5. Wählen Sie Vorlage verwenden, um mit Ihrer Auswahl fortzufahren.

  6. Führen Sie eine der folgenden Aktionen aus:

    • Wenn Sie „Darauf aufbauen“ ausgewählt haben, erstellt Step Functions den Workflow-Prototyp, stellt jedoch nicht die Ressourcen in der Workflow-Definition bereit, sodass Sie Ihren Workflow-Prototyp weiterentwickeln können.

      In Workflow Studio können Sie Ihrem Workflow-Prototyp zusätzliche Status hinzufügen. Entwurfsmodus Oder Sie können zu der wechseln, um den integrierten Code-Editor Codemodus zu verwenden, um die Amazon States Language (ASL) -Definition Ihrer Zustandsmaschine von der Step Functions Functions-Konsole aus zu bearbeiten.

      Wichtig

      Möglicherweise müssen Sie den Platzhalter Amazon Resource Name (ARN) für die im Beispielprojekt verwendeten Ressourcen aktualisieren, bevor Sie Ihren Workflow ausführen können.

    • Wenn Sie Eine Demo ausführen ausgewählt haben, erstellt Step Functions ein schreibgeschütztes Projekt, das eine AWS CloudFormation Vorlage verwendet, um die AWS Ressourcen in dieser Vorlage für Ihr Projekt bereitzustellen. AWS-Konto Sie können die State-Machine-Definition anzeigen, indem Sie den Codemodus wählen.

      Wählen Sie Bereitstellen und ausführen, um das Projekt bereitzustellen und die Ressourcen zu erstellen.

      Beachten Sie, dass die Bereitstellung bis zu 10 Minuten dauern kann, bis Ressourcen und IAM Berechtigungen erstellt sind. Während der Bereitstellung Ihrer Ressourcen können Sie den AWS CloudFormation Stack-ID-Link öffnen, um zu sehen, welche Ressourcen bereitgestellt werden.

      Nachdem alle Ressourcen erstellt wurden, sollte das Projekt auf der Seite State Machines in der Konsole angezeigt werden.

      Wichtig

      Für jeden in der CloudFormation Vorlage verwendeten Dienst können Standardgebühren anfallen.

Erstellen Sie einen Workflow mit einer leeren Vorlage

Wenn Sie von einer leeren Arbeitsfläche aus beginnen möchten, erstellen Sie einen Workflow aus der leeren Vorlage.

  1. Öffnen Sie die Step Functions Functions-Konsole.

  2. Wählen Sie Create State Machine (Zustandsautomaten erstellen).

  3. Wählen Sie im Dialogfeld Vorlage auswählen die Option Leer aus.

  4. Wählen Sie „Auswählen“, um Workflow Studio in zu öffnenEntwurfsmodus.

    Sie können jetzt mit dem Entwerfen Ihres Workflows beginnen Entwurfsmodus oder Ihre Workflow-Definition in schreibenCodemodus.

  5. Wählen Sie Config, um die Konfiguration Ihres Workflows in der zu verwaltenKonfigurationsmodus. Geben Sie beispielsweise einen Namen für Ihren Workflow ein und wählen Sie dessen Typ aus.

Entwerfen Sie einen Workflow

Wenn Sie den Namen des Bundesstaates kennen, den Sie hinzufügen möchten, verwenden Sie das Suchfeld oben in derBrowser für Staaten, um ihn zu finden. Suchen Sie andernfalls im Browser nach dem gewünschten Status und fügen Sie ihn der Arbeitsfläche hinzu.

Sie können Status in Ihrem Workflow neu anordnen, indem Sie sie an eine andere Stelle in Ihrem Workflow ziehen. Wenn Sie einen Status auf die Arbeitsfläche ziehen, wird eine Linie angezeigt, die angibt, wo der Status in Ihren Workflow eingefügt wird, wie im folgenden Screenshot gezeigt:

Illustrativer Screenshot, der die blaue Linie zeigt, die das Ziel für einen Status angibt.

Nachdem ein Status auf der Arbeitsfläche abgelegt wurde, wird sein Code automatisch generiert und der Workflow-Definition hinzugefügt. Um die Definition zu sehen, aktivieren Sie den Schalter Definition im Inspektorfenster. Sie können wählenCodemodus, ob Sie die Definition mit dem integrierten Code-Editor bearbeiten möchten.

Nachdem Sie einen Status auf der Arbeitsfläche abgelegt haben, können Sie ihn im Inspektor-Panel Bereich auf der rechten Seite konfigurieren. Dieser Bereich enthält die Registerkarten Konfiguration, Eingabe, Ausgabe und Fehlerbehandlung für jeden Status oder jede API Aktion, die Sie auf der Arbeitsfläche platzieren. Sie konfigurieren die Status, die Sie in Ihre Workflows aufnehmen, auf der Registerkarte Konfiguration.

Die Registerkarte „Konfiguration“ für die API Lambda-Aktion „Aufrufen“ bietet beispielsweise die folgenden Optionen:

  • Name des Bundesstaates: Sie können den Status mit einem benutzerdefinierten Namen identifizieren oder den generierten Standardnamen akzeptieren.

  • APIzeigt, welche API Aktion vom Staat verwendet wird.

  • Integrationstyp: Sie können den Serviceintegrationstyp auswählen, der zum Aufrufen von API Aktionen für andere Dienste verwendet wird.

  • Der Funktionsname bietet Optionen für:

    • Geben Sie einen Funktionsnamen ein: Sie können Ihren Funktionsnamen oder seinen Namen eingebenARN.

    • Funktionsnamen zur Laufzeit aus der Statuseingabe abrufen: Sie können diese Option verwenden, um den Funktionsnamen dynamisch aus der Statuseingabe abzurufen, basierend auf dem von Ihnen angegebenen Pfad.

    • Funktionsnamen wählen: Sie können direkt aus den Funktionen auswählen, die in Ihrem Konto und Ihrer Region verfügbar sind.

  • Nutzlast: Sie können wählen, ob Sie die Statuseingabe, ein JSON Objekt oder keine Nutzlast verwenden möchten, um sie als Nutzlast an Ihre Lambda-Funktion zu übergeben. Wenn Sie möchtenJSON, können Sie sowohl statische Werte als auch Werte einbeziehen, die aus der Statuseingabe ausgewählt wurden.

  • (Optional) In einigen Bundesstaaten gibt es die Option „Auf Abschluss der Aufgabe warten“ oder „Auf Rückruf warten“. Sofern verfügbar, können Sie eines der folgenden Serviceintegrationsmuster wählen:

    • Keine Option ausgewählt: Step Functions verwendet das Request Response (Antwort anfordern) Integrationsmuster. Step Functions wartet HTTP auf eine Antwort und wechselt dann zum nächsten Status. Step Functions wartet nicht darauf, dass ein Job abgeschlossen ist. Wenn keine Optionen verfügbar sind, verwendet der Staat dieses Muster.

    • Warten Sie, bis die Aufgabe abgeschlossen ist: Step Functions verwendet das Ausführen einer Aufgabe (.sync) Integrationsmuster.

    • Auf Rückruf warten: Step Functions verwendet das Warten auf einen Callback mit dem Aufgabentoken Integrationsmuster.

  • (Optional) Um auf Ressourcen zuzugreifen, die AWS-Konten in Ihren Workflows unterschiedlich konfiguriert sind, bietet Step Functions kontenübergreifenden Zugriff. IAMDie Rolle für den kontoübergreifenden Zugriff bietet Optionen für:

    • IAMRolle bereitstellen ARN: Geben Sie die IAM Rolle an, die die entsprechenden Ressourcenzugriffsberechtigungen enthält. Diese Ressourcen sind in einem Zielkonto verfügbar, AWS-Konto auf das Sie kontenübergreifende Anrufe tätigen.

    • IAMRolle zur ARN Laufzeit aus Statuseingabe abrufen: Geben Sie einen Referenzpfad zu einem vorhandenen Schlüssel-Wert-Paar in der JSON Statuseingabe an, die die Rolle enthält. IAM

  • Im nächsten Status können Sie den Status auswählen, in den Sie als Nächstes wechseln möchten.

  • (Optional) Das Kommentarfeld hat keinen Einfluss auf den Workflow, aber Sie können es verwenden, um Ihren Workflow mit Anmerkungen zu versehen.

In einigen Bundesstaaten werden zusätzliche generische Konfigurationsoptionen verfügbar sein. Die ECS RunTask Amazon-State-Konfiguration enthält beispielsweise ein API Parameters Feld, das mit Platzhalterwerten gefüllt ist. Für diese Bundesstaaten können Sie die Platzhalterwerte durch Konfigurationen ersetzen, die Ihren Anforderungen entsprechen.

Um einen Status zu löschen

Sie können die Rücktaste drücken, mit der rechten Maustaste klicken und Status löschen wählen oder in der Entwurfs-Werkzeugleiste Löschen wählen.

Führen Sie Ihren Workflow aus

Wenn Ihr Workflow einsatzbereit ist, können Sie ihn ausführen und seine Ausführung von der Step Functions Functions-Konsole aus verfolgen.

Um einen Workflow in Workflow Studio auszuführen
  1. Wählen Sie im Design -, Code - oder Konfigurationsmodus die Option Ausführen.

    Das Dialogfeld „Ausführung starten“ wird auf einer neuen Registerkarte geöffnet.

  2. Gehen Sie im Dialogfeld Ausführung starten wie folgt vor:

    1. (Optional) Um Ihre Ausführung zu identifizieren, können Sie einen Namen angeben oder den generierten Standardnamen für die Ausführung verwenden.

      Anmerkung

      Step Functions akzeptiert Namen für Zustandsmaschinen, Ausführungen, Aktivitäten und Beschriftungen, die ASCII Nichtzeichen enthalten. Da Namen, die keine ASCII Zeichen enthalten, bei Amazon nicht funktionieren CloudWatch, empfehlen wir, nur ASCII Zeichen zu verwenden, damit Sie Kennzahlen verfolgen können. CloudWatch

    2. (Optional) Geben Sie im Eingabefeld Eingabewerte im JSON Format ein, um Ihren Workflow auszuführen.

    3. Wählen Sie Start execution (Ausführung starten) aus.

    4. Die Step Functions Functions-Konsole leitet Sie zu einer Seite weiter, die mit Ihrer Ausführungs-ID betitelt ist. Diese Seite wird als Seite mit den Ausführungsdetails bezeichnet. Auf dieser Seite können Sie die Ausführungsergebnisse im Verlauf der Ausführung oder nach deren Abschluss überprüfen.

      Um die Ausführungsergebnisse zu überprüfen, wählen Sie in der Diagrammansicht einzelne Status aus und wählen Sie dann die einzelnen Registerkarten im Einzelheiten zu den Schritten Bereich, um die Details der einzelnen Status, einschließlich Eingabe, Ausgabe und Definition, anzuzeigen. Einzelheiten zu den Ausführungsinformationen, die Sie auf der Seite mit den Ausführungsdetails einsehen können, finden Sie unterSeite mit den Ausführungsdetails — Übersicht über die Benutzeroberfläche.

Bearbeiten Sie Ihren Workflow

Sie können einen vorhandenen Workflow visuell im Entwurfsmodus Workflow Studio bearbeiten.

Wählen Sie in der Step Functions Functions-Konsole auf der Seite State Machines den Workflow aus, den Sie bearbeiten möchten. Der Workflow wird im Entwurfsmodus von Workflow Studio geöffnet.

Sie können die Workflow-Definition auch in bearbeitenCodemodus. Wählen Sie die Code-Schaltfläche, um die Workflow-Definition in Workflow Studio anzuzeigen oder zu bearbeiten.

Anmerkung

Wenn Sie Fehler in Ihrem Workflow sehen, müssen Sie diese im Entwurfsmodus beheben. Sie können nicht in den Code - oder Konfigurationsmodus wechseln, wenn in Ihrem Workflow Fehler auftreten.

Exportieren Sie Ihren Workflow

Sie können die Definition Ihres Workflows Amazon States Language (ASL) und Ihr Workflow-Diagramm exportieren:

  1. Wählen Sie Ihren Workflow in der Step Functions Functions-Konsole aus.

  2. Wählen Sie auf der Detailseite des State Machines die Option Bearbeiten aus.

  3. Wählen Sie die Dropdownschaltfläche „Aktionen“ und führen Sie dann eine oder beide der folgenden Aktionen aus:

    • Um das Workflow-Diagramm in eine SVG PNG OR-Datei zu exportieren, wählen Sie unter Diagramm exportieren das gewünschte Format aus.

    • Um die Workflow-Definition als JSON YAML OR-Datei zu exportieren, wählen Sie unter Definition exportieren das gewünschte Format aus.

Einen Workflow-Prototyp mit Platzhaltern erstellen

Sie können Workflow Studio oder Workflow Studio verwenden, um Prototypen neuer Workflows Application Composer zu erstellen, die Platzhalterressourcen enthalten, die als Ressourcen bezeichnet werden, die noch nicht existieren.

So erstellen Sie einen Workflow-Prototyp:

  1. Melden Sie sich bei der Step Functions Functions-Konsole an.

  2. Wählen Sie Create State Machine (Zustandsautomaten erstellen).

  3. Wählen Sie im Dialogfeld Vorlage auswählen die Option Leer aus.

  4. Wählen Sie „Auswählen“, um Workflow Studio in zu öffnenEntwurfsmodus.

  5. Der Entwurfsmodus von Workflow Studio wird geöffnet. Entwerfen Sie Ihren Workflow in Workflow Studio. Um Platzhalter-Ressourcen einzubeziehen:

    1. Wählen Sie den Bundesstaat aus, für den Sie eine Platzhalterressource hinzufügen möchten, und gehen Sie dann unter Konfiguration wie folgt vor:

      • Wählen Sie für Lambda Invoke-Status die Option Funktionsname und dann Funktionsname eingeben aus. Sie können auch einen benutzerdefinierten Namen für Ihre Funktion eingeben.

      • Wählen Sie für den Status von Amazon SQS Send Message die Option Warteschlange URL und dann Warteschlange eingeben ausURL. Geben Sie eine Platzhalter-Warteschlange URL ein.

      • Wählen Sie für Amazon SNS Publish-Staaten unter Thema ein Thema ausARN.

      • Für alle anderen Bundesstaaten, die unter Aktionen aufgeführt sind, können Sie die Standardkonfiguration verwenden.

      Anmerkung

      Wenn Sie Fehler in Ihrem Arbeitsablauf feststellen, müssen Sie diese im Entwurfsmodus beheben. Sie können nicht in den Code - oder Konfigurationsmodus wechseln, wenn in Ihrem Workflow Fehler auftreten.

    2. (Optional) Um die automatisch generierte ASL Definition Ihres Workflows anzuzeigen, wählen Sie Definition.

    3. (Optional) Um die Workflow-Definition in Workflow Studio zu aktualisieren, wählen Sie die Code-Schaltfläche.

      Anmerkung

      Wenn Sie Fehler in Ihrer Workflow-Definition sehen, müssen Sie diese im Codemodus beheben. Sie können nicht in den Entwurfs - oder Konfigurationsmodus wechseln, wenn in Ihrer Workflow-Definition Fehler auftreten.

  6. (Optional) Um den Namen des Zustandsmaschinen zu bearbeiten, wählen Sie das Bearbeitungssymbol neben dem Standardnamen des Zustandsmaschinen von MyStateMachineund geben Sie im Feld Name des Zustandsmaschinen einen Namen ein.

    Sie können auch zum wechseln, Konfigurationsmodus um den Standardnamen des Zustandsmaschinen zu bearbeiten.

  7. Geben Sie Ihre Workflow-Einstellungen an, z. B. den Zustandsmaschinentyp und seine Ausführungsrolle.

  8. Wählen Sie Create (Erstellen) aus.

Sie haben jetzt einen neuen Workflow mit Platzhalterressourcen erstellt, die für Prototypen verwendet werden können. Sie können Ihre Workflow-Definition und das Workflow-Diagramm exportieren.

  • Um Ihre Workflow-Definition als JSON YAML OR-Datei zu exportieren, wählen Sie im Entwurfs - oder Codemodus die Dropdownschaltfläche Aktionen. Wählen Sie dann unter Definition exportieren das Format aus, das Sie exportieren möchten. Sie können diese exportierte Definition als Ausgangspunkt für die lokale Entwicklung mit dem verwenden AWS Toolkit for Visual Studio Code.

  • Um Ihr Workflow-Diagramm in eine SVG PNG OR-Datei zu exportieren, wählen Sie im Entwurfs - oder Codemodus die Dropdownschaltfläche Aktionen. Wählen Sie dann unter Exportdefinition das gewünschte Format aus.