Erstellen einer Step Functions Functions-ZustandsmaschineAWS SAM - 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 einer Step Functions Functions-ZustandsmaschineAWS SAM

Diese Anleitung zeigt Ihnen, wie Sie eine AWS SAM-Beispielanwendung herunterladen, erstellen und bereitstellen, die einen AWS Step Functions-Zustandsautomaten enthält. Diese Anwendung erstellt einen Pseudo-Aktienhandel-Workflow, der nach einem vordefinierten Zeitplan ausgeführt wird (beachten Sie, dass der Zeitplan standardmäßig deaktiviert ist, um Gebühren zu vermeiden).

Das folgende Diagramm zeigt die Komponenten dieser Anwendung:


            Ein Diagramm, das eine Lambda-Funktion zeigt, die aufgerufen wird, wenn Sie eine GET-Anforderung an den API Gateway-Endpunkt senden

Im Folgenden finden Sie eine Vorschau der Befehle, die Sie zum Erstellen der Beispielanwendung ausführen. Weitere Informationen zu den einzelnen Befehlen finden Sie in den Abschnitten weiter unten auf dieser Seite.

# Step 1 - Download a sample application. For this tutorial you # will follow the prompts to select an AWS Quick Start Template # called 'Multi-step workflow' sam init # Step 2 - Build your application cd project-directory sam build # Step 3 - Deploy your application sam deploy --guided

Voraussetzungen

In diesem Handbuch wird davon ausgegangen, dass Sie die Schritte unter Installieren der AWS SAM-CLI für Ihr Betriebssystem ausgeführt haben. Es wird davon ausgegangen, dass Sie Folgendes getan haben:

  1. ErstelltAWSKonto.

  2. Konfigurierte IAM-Berechtigungen

  3. Homebrew wurde installiert. Hinweis: Homebrew ist nur eine Voraussetzung für Linux und macOS.

  4. Die AWS SAM-CLI wurde installiert. Hinweis: Stellen Sie sicher, dass Sie Version 0.52.0 oder höher besitzen. Sie können überprüfen, über welche Version Sie verfügen, indem Sie den Befehl sam --version ausführen.

Schritt 1: Herunterladen einer AWS SAM-Beispielanwendung

Befehl zum Ausführen:

sam init

Folgen Sie den Anweisungen auf dem Bildschirm, um Folgendes auszuwählen:

  1. Vorlage: AWSSchnellstart-Vorlagen

  2. Sprache: Python, Ruby, NodeJS, Go, Java oder .NET

  3. Projektname: (Name Ihrer Wahl – Standard ist sam-app)

  4. Schnellstart-Anwendung:Mehrstufiger Arbeitsablauf

WasAWS SAMmacht:

Mit diesem Befehl wird ein Verzeichnis mit dem Namen erstellt, den Sie für die Eingabeaufforderung „Projektname“ angegeben haben (Standardeinstellung ist sam-app). Der spezifische Inhalt des Verzeichnisses hängt von der gewählten Sprache ab.

Im Folgenden sind die Verzeichnisinhalte aufgeführt, wenn Sie eine der Python-Laufzeitumgebungen auswählen:

├── README.md
├── functions
│   ├── __init__.py
│   ├── stock_buyer
│   │   ├── __init__.py
│   │   ├── app.py
│   │   └── requirements.txt
│   ├── stock_checker
│   │   ├── __init__.py
│   │   ├── app.py
│   │   └── requirements.txt
│   └── stock_seller
│       ├── __init__.py
│       ├── app.py
│       └── requirements.txt
├── statemachine
│   └── stock_trader.asl.json
├── template.yaml
└── tests
    └── unit
        ├── __init__.py
        ├── test_buyer.py
        ├── test_checker.py
        └── test_seller.py

Es gibt zwei besonders interessante Dateien, die Sie sich ansehen können:

  • template.yaml: Enthält dieAWS SAMVorlage, die Ihre Anwendung definiertAWSRessourcen.

  • statemachine/stockTrader.asl.json: Enthält die Zustandsautomaten-Definition der Anwendung, die in Amazon States Language geschrieben ist.

Sie können den folgenden Eintrag in der template.yaml-Datei sehen, der auf die Definitionsdatei des Zustandsautomaten verweist:

Properties: DefinitionUri: statemachine/stock_trader.asl.json

Es kann hilfreich sein, die State-Machine-Definition als separate Datei beizubehalten, anstatt sie in die Datei einzubettenAWS SAMVorlage. Beispielsweise ist es einfacher, Änderungen an der State-Machine-Definition nachzuverfolgen, wenn Sie die Definition nicht in die Vorlage aufnehmen. Sie können Workflow Studio verwenden, um die Zustandsmaschinen-Definition zu erstellen und zu verwalten und die Definition von der Konsole direkt in die Sprachspezifikationsdatei von Amazon States zu exportieren, ohne sie mit der Vorlage zusammenzuführen.

Weitere Informationen zur Beispielanwendung finden Sie in der Datei README.md im Projektverzeichnis.

Schritt 2: Erstellen Ihrer Anwendung

Befehl zum Ausführen:

Wechseln Sie zuerst in das Projektverzeichnis (d. h. das Verzeichnis, in dem sich die template.yaml-Datei für die Beispielanwendung befindet; standardmäßig sam-app) und führen Sie dann folgenden Befehl aus:

sam build

Beispielausgabe:

  
 Build Succeeded

 Built Artifacts  : .aws-sam/build
 Built Template   : .aws-sam/build/template.yaml

 Commands you can use next
 =========================
 [*] Invoke Function: sam local invoke
 [*] Deploy: sam deploy --guided
       

WasAWS SAMmacht:

DasAWS SAMCLI enthält Abstraktionen für eine Reihe von Lambda-Laufzeiten zum Erstellen Ihrer Abhängigkeiten und kopiert alle Build-Artefakte in Staging-Ordner, sodass alles bereit ist, gepackt und bereitgestellt zu werden. Der sam build-Befehl erstellt alle Abhängigkeiten Ihrer Anwendung und kopiert die Build-Artefakte in Ordner unter .aws-sam/build.

Schritt 3: Bereitstellen derAWSCloud

Befehl zum Ausführen:

sam deploy --guided

Folgen Sie den Anweisungen auf dem Bildschirm. Sie können einfach mit Enter antworten, um die in der interaktiven Erfahrung bereitgestellten Standardoptionen zu akzeptieren.

WasAWS SAMmacht:

Mit diesem Befehl wird Ihre Anwendung inAWSWolke. Es benötigt die Bereitstellungsartefakte, die Sie mit dem erstellensam buildBefehl, Paket und lädt sie in einen Amazon S3 S3-BucketAWS SAMCLI und stellt die Anwendung bereit mitAWS CloudFormation. In der Ausgabe des Deploy-Befehls können Sie die Änderungen sehen, die an Ihrem AWS CloudFormation-Stack vorgenommen werden.

Sie können überprüfen, ob die Step Functions Functions-Beispiel-Zustandsmaschine erfolgreich bereitgestellt wurde, indem Sie die folgenden Schritte ausführen:

  1. Melden Sie sich anAWS Management Consoleund öffnen Sie die Step Functions Functions-Konsole unterhttps://console.aws.amazon.com/states/.

  2. Wählen Sie in der linken Navigation die Option Zustandsautomaten aus.

  3. Suchen Sie Ihren neuen Zustandsautomaten in der Liste und wählen Sie ihn aus. Es wird benannt StockTradingStateMachine-<unique-hash>.

  4. Wählen Sie die Registerkarte Definition.

Sie sollten nun eine visuelle Darstellung Ihres Zustandsautomaten sehen. Sie können überprüfen, ob die visuelle Darstellung mit der Zustandsautomatendefinition in der Datei statemachine/stockTrader.asl.json Ihres Projektverzeichnisses übereinstimmt.

Fehlerbehebung

SAM CLI-Fehler: „keine solche Option: --guided“

Bei der Ausführung von sam deploy wird der folgende Fehler angezeigt:

 
Error: no such option: --guided
            

Dies bedeutet, dass Sie eine ältere Version der AWS SAM-CLI verwenden, die den Parameter --guided nicht unterstützt. Um dies zu beheben, können Sie entweder Ihre Version von AWS SAM-CLI auf 0.33.0 oder höher aktualisieren oder den Parameter --guided aus im Befehl sam deploy weglassen.

SAM-CLI-Fehler: „Fehler beim Erstellen verwalteter Ressourcen: Anmeldeinformationen konnten nicht gefunden werden“

Bei der Ausführung von sam deploy wird der folgende Fehler angezeigt:

 
Error: Failed to create managed resources: Unable to locate credentials
            

Das bedeutet, dass Sie nicht eingerichtet habenAWSZugangsdaten zur Aktivierung desAWS SAMCLI zum ErstellenAWSServiceanrufe. Um dies zu beheben, müssen SieAWSReferenzen. Weitere Informationen finden Sie unterEinrichtenAWSReferenzenin derAWS Serverless Application ModelLeitfaden für Entwickler.

Bereinigen

Wenn Sie das nicht mehr benötigenAWSRessourcen, die Sie beim Ausführen dieses Tutorials erstellt haben, können Sie entfernen, indem Sie dieAWS CloudFormationStapel, den Sie bereitgestellt haben.

Gehen Sie folgendermaßen vor, um den AWS CloudFormation-Stack zu löschen, der mit diesem Tutorial über die AWS Management Console erstellt wurde:

  1. Melden Sie sich bei der AWS Management Console an und öffnen Sie die AWS CloudFormation-Konsole unter https://console.aws.amazon.com/cloudformation.

  2. Wählen Sie im linken Navigationsbereich Stack aus.

  3. Wählen Sie in der Liste der Stacks sam-app (oder den Namen des von Ihnen erstellten Stacks) aus.

  4. Wählen Sie Löschen.

Wenn Sie fertig sind, ändert sich der Status des Stacks in DELETE_COMPLETE.

Alternativ können Sie den AWS CloudFormation-Stack löschen, indem Sie den folgenden AWS CLI-Befehl ausführen:

aws cloudformation delete-stack --stack-name sam-app --region region

Gelöschten Stack überprüfen

Für beide Methoden zum Löschen vonAWS CloudFormationStapel, Sie können überprüfen, ob er gelöscht wurde, indem Sie zuhttps://console.aws.amazon.com/cloudformation, wählendStapelim linken Navigationsbereich und wählenGelöschtin der Drop-down-Liste rechts neben dem Such-Textfeld Sie sollten Ihren Stacknamen sam-app (oder den Namen des Stacks, den Sie erstellt haben) in der Liste der gelöschten Stacks sehen.