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.
Umsetzen AWS Lambda Aufgaben
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 Ihrem AWS Flow Framework für Java-Workflows
Für die Verwendung von Lambda-Aufgaben in Ihrem AWS Flow Framework für Java-Workflows:
-
Eine Lambda-Funktion zur Ausführung. Sie können jede Lambda-Funktion verwenden, die Sie definiert haben. Weitere Informationen zum Erstellen von Lambda-Funktionen finden Sie in der AWS Lambda Leitfaden für Entwickler.
-
Eine IAM-Rolle, die Zugriff auf die Ausführung von Lambda-Funktionen aus Ihren Amazon SWF-Workflows bietet.
-
Code zum Planen der Lambda-Aufgabe in Ihrem Workflow.
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.
Planen Sie die Ausführung einer Lambda-Aufgabe
Sobald Sie eine IAM-Rolle definiert haben, mit der Sie Lambda-Funktionen aufrufen können, können Sie deren Ausführung als Teil Ihres Workflows planen.
Dieser Prozess wird vollständig demonstriert durch HelloLambda Probe in der AWS SDK für Java.
Um eine Lambda-Task für die Ausführung zu planen
-
Rufen Sie in Ihrer Workflow-Implementierung eine Instance des
LambdaFunctionClientab, indem SiegetLambdaFunctionClient()für eineDecisionContext-Instance aufrufen.// Get a LambdaFunctionClient instance DecisionContextProvider decisionProvider = new DecisionContextProviderImpl(); DecisionContext decisionContext = decisionProvider.getDecisionContext(); LambdaFunctionClient lambdaClient = decisionContext.getLambdaFunctionClient(); -
Planen Sie die Aufgabe mithilfe der
scheduleLambdaFunction()Methode auf derLambdaFunctionClientund übergibt ihr den Namen der Lambda-Funktion, die Sie erstellt haben, sowie alle Eingabedaten für die Lambda-Task.// Schedule the Lambda function for execution, using your IAM role for access. String lambda_function_name = "The name of your Lambda function."; String lambda_function_input = "Input data for your Lambda task."; lambdaClient.scheduleLambdaFunction(lambda_function_name, lambda_function_input); -
Fügen Sie in Ihrem Workflow-Ausführungsstarter die IAM-Lambda-Rolle zu Ihren Standard-Workflow-Optionen hinzu, indem Sie
StartWorkflowOptions.withLambdaRole(), und übergeben Sie dann die Optionen, wenn Sie den Workflow starten.// Workflow client classes are generated for you when you use the @Workflow // annotation on your workflow interface declaration. MyWorkflowClientExternalFactory clientFactory = new MyWorkflowClientExternalFactoryImpl(sdk_swf_client, swf_domain); MyWorkflowClientExternal workflow_client = clientFactory.getClient(); // Give the ARN of an IAM role that allows SWF to invoke Lambda functions on // your behalf. String lambda_iam_role = "arn:aws:iam::111111000000:role/swf_lambda_role"; StartWorkflowOptions workflow_options = new StartWorkflowOptions().withLambdaRole(lambda_iam_role); // Start the workflow execution workflow_client.helloWorld("User", workflow_options);
Sehen Sie sich das an HelloLambda Probe
Ein Beispiel für die Implementierung eines Workflows, der eine Lambda-Task verwendet, finden Sie im AWS SDK für Java. Zum Ansehen and/or starte es, lade die Quelle herunter
Eine vollständige Beschreibung, wie man das baut und ausführt HelloLambda Ein Beispiel finden Sie in der README-Datei, die mit dem geliefert wird AWS Flow Framework für Java-Beispiele.