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.
AWS Lambda Aufgaben in Amazon SWF
Themen
Informationen AWS Lambda
AWS Lambda ist ein vollständig verwalteter Rechenservice, der Ihren Code als Reaktion auf Ereignisse ausführt, die durch benutzerdefinierten Code oder durch verschiedene AWS Dienste wie Amazon S3, DynamoDB, Amazon Kinesis, Amazon SNS und Amazon Cognito. Weitere Informationen zu Lambda finden Sie im AWS Lambda Entwicklerhandbuch.
Amazon Simple Workflow Service bietet eine Lambda-Aufgabe, sodass Sie Lambda-Funktionen anstelle von oder neben herkömmlichen Amazon SWF-Aktivitäten ausführen können.
Ihr AWS Ihrem Konto werden Lambda-Ausführungen (Anfragen) in Rechnung gestellt, die von Amazon SWF in Ihrem Namen ausgeführt werden. Einzelheiten zur Lambda-Preisgestaltung finden Sie unter https://aws.amazon.com/lambda/pricing/
Vorteile und Einschränkungen der Verwendung von Lambda-Tasks
Die Verwendung von Lambda-Aufgaben anstelle einer herkömmlichen Amazon SWF-Aktivität bietet eine Reihe von Vorteilen:
-
Lambda-Aufgaben müssen nicht wie Amazon SWF-Aktivitätstypen registriert oder versioniert werden.
-
Sie können alle vorhandenen Lambda-Funktionen verwenden, die Sie bereits in Ihren Workflows definiert haben.
-
Lambda-Funktionen werden direkt von Amazon SWF aufgerufen. Sie müssen kein Arbeitsprogramm implementieren, um sie auszuführen, wie Sie es bei herkömmlichen Aktivitäten tun müssen.
-
Lambda stellt Ihnen Metriken und Protokolle zur Verfügung, mit denen Sie Ihre Funktionsausführungen verfolgen und analysieren können.
Bei Lambda-Aufgaben sind jedoch einige Einschränkungen zu beachten:
-
Lambda-Aufgaben können nur in ausgeführt werden AWS Regionen, die Lambda unterstützen. Siehe Lambda-Regionen und -Endpunkte in der Allgemeine Referenz zu Amazon Web Services für Einzelheiten zu den derzeit unterstützten Regionen für Lambda.
-
Lambda-Aufgaben werden derzeit nur von der SWF-Basis-HTTP-API unterstützt und in AWS Flow Framework für Java. Derzeit gibt es keine Unterstützung für Lambda-Aufgaben in der AWS Flow Framework für Ruby.
Verwenden Sie Lambda-Aufgaben in Ihren Workflows
Um Lambda-Aufgaben in Ihren Amazon SWF-Workflows zu verwenden, müssen Sie:
-
Richten Sie IAM-Rollen ein, um Amazon SWF die Erlaubnis zum Aufrufen von Lambda-Funktionen zu erteilen.
-
die IAM-Rollen Ihren Workflows anfügen.
-
Ihre Lambda-Funktion während der Workflow-Ausführung aufrufen.
Einrichten einer IAM-Rolle
Bevor Sie Lambda-Funktionen von Amazon SWF aus aufrufen können, müssen Sie eine IAM-Rolle angeben, die den Zugriff auf Lambda von Amazon SWF aus ermöglicht. Führen Sie dazu einen der folgenden Schritte aus:
-
wählen Sie eine vordefinierte Rolle, AWSLambdaRole, um Ihren Workflows die Erlaubnis zu geben, alle mit Ihrem Konto verknüpften Lambda-Funktionen aufzurufen.
-
definieren Sie Ihre eigene Richtlinie und die zugehörige Rolle, um Workflows die Erlaubnis zu geben, bestimmte Lambda-Funktionen aufzurufen, die durch ihre Amazon-Ressourcennamen (ARNs) spezifiziert werden.
Beschränken Sie die Berechtigungen für eine IAM-Rolle
Sie können die Berechtigungen für eine IAM-Rolle, die Sie Amazon SWF zur Verfügung stellen, einschränken, indem Sie SourceArn und SourceAccount Kontextschlüssel in Ihrer Ressourcenvertrauensrichtlinie. Diese Schlüssel schränken die Verwendung einer IAM-Richtlinie ein, sodass sie nur für Amazon Simple Workflow Service-Ausführungen verwendet wird, die zum angegebenen Domain-ARN gehören. Wenn Sie beide globalen Bedingungskontextschlüssel verwenden, wird der aws:SourceAccount Wert und das Konto, auf das in der verwiesen wird aws:SourceArn Der Wert muss dieselbe Konto-ID verwenden, wenn er in derselben Grundsatzerklärung verwendet wird.
Im folgenden Beispiel SourceArn Der Kontextschlüssel schränkt die IAM-Servicerolle so ein, dass sie nur in Amazon Simple Workflow Service-Ausführungen verwendet wird, die zu someDomain im Konto, 123456789012.
-
Aussage 1
Schulleiter :
"Service": "swf.amazonaws.com"Aktion:
sts:AssumeRole
"Condition": { "ArnLike": { "aws:SourceArn": "arn:aws:swf:*:123456789012:/domain/someDomain" } }
Im folgenden Beispiel SourceAccount Der Kontextschlüssel schränkt die IAM-Servicerolle so ein, dass sie nur bei Amazon Simple Workflow Service-Ausführungen im Konto verwendet wird. 123456789012.
"Condition": { "StringLike": { "aws:SourceAccount": "123456789012" } }
Bereitstellung des Zugriffs für Amazon SWF zum Aufrufen einer beliebigen Lambda-Rolle
Sie können die vordefinierte Rolle verwenden AWSLambdaRole, um Ihren Amazon SWF-Workflows die Möglichkeit zu geben, jede Lambda-Funktion aufzurufen, die Ihrem Konto zugeordnet ist.
Zu verwenden AWSLambdaRole um Amazon SWF Zugriff zum Aufrufen von Lambda-Funktionen zu gewähren
-
Öffnen Sie die IAM-Konsole
. -
Wählen Sie Roles und anschließend Create New Role aus.
-
Geben Sie einen Namen für die Rolle ein, z. B.
swf-lambda, und klicken Sie auf Next Step. -
Unter AWS Rollen im Dienst, wählen Amazon SWF, und wähle Nächster Schritt.
-
Auf der Richtlinie anhängen Bildschirm, wählen Sie AWSLambdaRole aus der Liste.
-
Klicken Sie auf Next Step und auf Create Role, sobald Sie die Rolle überprüft haben.
Definition einer IAM-Rolle, um Zugriff auf das Aufrufen einer bestimmten Lambda-Funktion zu gewähren
Wenn Sie den Zugriff zum Aufrufen einer bestimmten Lambda-Funktion in Ihrem Workflow gewähren möchten, müssen Sie Ihre eigene IAM-Richtlinie definieren.
Um eine IAM-Richtlinie zu erstellen, die den Zugriff auf eine bestimmte Lambda-Funktion ermöglicht
-
Öffnen Sie die IAM-Konsole
. -
Wählen Sie Policies und dann Create Policy aus.
-
Wählen Sie Kopieren Sie eine AWS Verwaltete Richtlinie und wählen AWSLambdaRole aus der Liste. Es wird eine Richtlinie erstellt. Sie können ihren Namen und die Beschreibung nach Bedarf ändern.
-
In der Ressource Feld der Grundsatzdokument, fügen Sie den ARN Ihrer Lambda-Funktion (en) hinzu. Beispiel:
-
Ressource:
arn:aws:lambda:us-east-1:111122223333:function:hello_lambda_function
AnmerkungEine vollständige Beschreibung der Angabe von Ressourcen in einer IAM-Rolle finden Sie unter Überblick über die IAM-Richtlinien in IAM verwenden.
-
-
Wählen Sie Create policy aus, um Ihre Richtlinie zu erstellen.
Sie können diese Richtlinie dann auswählen, wenn Sie eine neue IAM-Rolle erstellen, und diese Rolle verwenden, um Invoke Zugriff auf Ihre Amazon SWF-Workflows zu gewähren. Dieses Verfahren ist dem Erstellen einer Rolle mit dem sehr ähnlich AWSLambdaRole Richtlinie. Wählen Sie stattdessen Ihre eigene Richtlinie aus, wenn Sie die Rolle erstellen.
Um eine Amazon SWF-Rolle mithilfe Ihrer Lambda-Richtlinie zu erstellen
-
Öffnen Sie die IAM-Konsole
. -
Wählen Sie Roles und anschließend Create New Role aus.
-
Geben Sie einen Namen für die Rolle ein, z. B.
swf-lambda-function, und klicken Sie auf Next Step. -
Unter AWS Rollen im Dienst, wählen Amazon SWF, und wähle Nächster Schritt.
-
Auf der Richtlinie anhängen Wählen Sie auf dem Bildschirm Ihre funktionsspezifische Lambda-Richtlinie aus der Liste aus.
-
Klicken Sie auf Next Step und auf Create Role, sobald Sie die Rolle überprüft haben.
Anfügen der IAM-Rolle an Ihren Workflow
Nachdem Sie Ihre IAM-Rolle definiert haben, müssen Sie sie an den Workflow anhängen, der sie zum Aufrufen der Lambda-Funktionen verwenden wird, auf die Sie Amazon SWF Zugriff gewährt haben.
Sie können die Rolle an zwei Stellen an Ihren Workflow anfügen.
-
Während der Workflow-Typ registriert wird. Diese Rolle kann als die Standard-Lambda-Rolle für jede Ausführung dieses Workflow-Typs verwendet werden.
-
Beim Start einer Workflow-Ausführung. Diese Rolle wird nur während der Ausführung dieses Workflows (und während der gesamten Ausführung) verwendet.
So stellen Sie eine Standard-Lambda-Rolle für einen Workflow-Typ bereit
-
Beim Anrufen RegisterWorkflowType, legen Sie die Standardeinstellung festLambdaRole Feld für den ARN der Rolle, die Sie definiert haben.
So stellen Sie eine Lambda-Rolle während der Workflow-Ausführung bereit
-
Beim Telefonieren StartWorkflowExecution, setzen Sie das Feld LambdaRole auf den ARN der Rolle, die Sie definiert haben.
wenn das Konto anruft RegisterWorkflowType oder StartWorkflowExecution hat keine Erlaubnis, die angegebene Rolle zu verwenden, dann schlägt der Aufruf mit einem fehl OperationNotPermittedFault.
Rufen Sie Ihre Lambda-Funktion von einem Amazon SWF-Workflow aus auf
Sie können das verwenden ScheduleLambdaFunctionDecisionAttributes Datentyp zur Identifizierung der Lambda-Funktion, die während einer Workflow-Ausführung aufgerufen werden soll.
Während eines Anrufs von RespondDecisionTaskCompleted, geben Sie eine ScheduleLambdaFunctionDecisionAttributes zu Ihrer Entscheidungsliste. Beispiel:
{ "decisions": [{ "ScheduleLambdaFunctionDecisionAttributes": { "id": "lambdaTaskId", "name": "myLambdaFunctionName", "input": "inputToLambdaFunction", "startToCloseTimeout": "30" }, }], }
Legen Sie die folgenden Parameter fest:
-
id mit einem Bezeichner für die Lambda-Aufgabe. Dies muss eine Zeichenfolge mit 1 bis 256 Zeichen sein und darf weder die Zeichen : (Doppelpunkt), / (Schrägstrich), | (senkrechter Strich), noch Steuerzeichen (\u0000 - \u001f und \u007f - \u009f) oder die Literalzeichenfolge
arnenthalten. -
name mit dem Namen Ihrer Lambda-Funktion. Ihr Amazon SWF-Workflow muss mit einer IAM-Rolle ausgestattet sein, die ihm Zugriff auf den Aufruf der Lambda-Funktion gewährt. Der angegebene Name muss den Einschränkungen für entsprechen FunctionName Parameter wie in der Lambda Invoke-Aktion.
-
input mit optionalen Eingabedaten für die Funktion. Falls gesetzt, muss dies den Einschränkungen für den entsprechen ClientContext Parameter wie in der Lambda Invoke-Aktion.
-
StartToCloseTimeout mit einer optionalen Höchstdauer in Sekunden, die die Ausführung der Funktion in Anspruch nehmen kann, bevor die Aufgabe mit einer Timeout-Ausnahme fehlschlägt. Der Wert NONE kann dafür verwendet werden, eine unbegrenzte Dauer festzulegen.
Weitere Informationen finden Sie unter Implementieren AWS Lambda Aufgaben