Erstellen Sie eine Step Functions Functions-Zustandsmaschine mit AWS SAM

In diesem Handbuch laden Sie eine AWS SAM Beispielanwendung herunter, erstellen und implementieren sie, die eine AWS Step Functions Zustandsmaschine 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:

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 in der Installation von AWS SAM CLI für Ihr Betriebssystem abgeschlossen haben. Es wird davon ausgegangen, dass Sie Folgendes getan haben:

1. Hat ein AWS Konto erstellt.

2. Konfigurierte IAM Berechtigungen.

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

4. Installierte das AWS SAM CLI. 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: AWS Schnellstart-Vorlagen

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

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

4. Schnellstart-Anwendung: Mehrstufiger Arbeitsablauf

Was AWS SAM macht:

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 die AWS SAM Vorlage, die die AWS Ressourcen Ihrer Anwendung definiert.

• statemachine/stockTrader.asl.json: Enthält die Zustandsautomaten-Definition der Anwendung, die in Verwendung von Amazon States Language zur Definition von Step Functions Functions-Workflows 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 AWS SAM Vorlage einzubetten. Beispielsweise ist es einfacher, Änderungen an der Zustandsmaschinen-Definition nachzuverfolgen, wenn Sie die Definition nicht in die Vorlage aufnehmen. Sie können Workflow Studio verwenden, um die State-Machine-Definition zu erstellen und zu verwalten und die Definition aus 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
       

Was AWS SAM macht:

Das AWS SAM CLI 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: Stellen Sie Ihre Anwendung in der Cloud bereit AWS

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.

Was AWS SAM macht:

Dieser Befehl stellt Ihre Anwendung in der AWS Cloud bereit. Es nimmt die Bereitstellungsartefakte, die Sie mit dem sam build Befehl erstellen, packt sie und lädt sie in einen Amazon S3 S3-Bucket hoch, der von erstellt wurde AWS SAM CLI, und stellt die Anwendung mithilfe von bereit. AWS 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 bei der an AWS Management Console und öffnen Sie die Step Functions Functions-Konsole unter https://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. Sie wird den Namen tragen 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

SAMCLIFehler: „keine solche Option: --guided“

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

 
Error: no such option: --guided
            

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

SAMCLIFehler: „Verwaltete Ressourcen konnten nicht erstellt werden: 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
            

Dies bedeutet, dass Sie keine AWS Anmeldeinformationen eingerichtet haben, um AWS Serviceanrufe tätigen AWS SAM CLI zu können. Um dieses Problem zu beheben, müssen Sie AWS Anmeldeinformationen einrichten. Weitere Informationen finden Sie unter AWS Anmeldeinformationen einrichten im AWS Serverless Application Model Entwicklerhandbuch.

Bereinigen

Wenn Sie die AWS Ressourcen, die Sie in diesem Tutorial erstellt haben, nicht mehr benötigen, können Sie sie entfernen, indem Sie den bereitgestellten AWS CloudFormation Stack löschen.

Gehen Sie folgendermaßen vor, um den mit diesem Tutorial erstellten AWS CloudFormation Stack mithilfe von zu löschen: AWS Management Console

1. Melden Sie sich bei der an AWS Management Console 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 auf 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

Bei beiden Methoden zum Löschen des AWS CloudFormation Stacks können Sie überprüfen, ob er gelöscht wurde, indem Sie zu https://console.aws.amazon.com/cloudformation gehen, im linken Navigationsbereich Stacks auswählen und in der Dropdownliste rechts neben dem Suchtextfeld die Option Gelöscht auswählen. Sie sollten Ihren Stacknamen sam-app (oder den Namen des Stacks, den Sie erstellt haben) in der Liste der gelöschten Stacks sehen.