Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Mise en œuvre AWS Lambda Tâches
Rubriques
À propos AWS Lambda
AWS Lambda est un service de calcul entièrement géré qui exécute votre code en réponse à des événements générés par du code personnalisé ou provenant de divers AWS des services tels qu'Amazon S3, DynamoDB, Amazon Kinesis, Amazon SNS et Amazon Cognito. Pour plus d'informations sur Lambda, consultez le guide du développeur AWS Lambda.
Amazon Simple Workflow Service propose une tâche Lambda qui vous permet d'exécuter des fonctions Lambda à la place ou parallèlement aux activités Amazon SWF traditionnelles.
Votre AWS votre compte sera débité pour les exécutions (requêtes) Lambda exécutées par Amazon SWF en votre nom. Pour en savoir plus sur la tarification de Lambda, consultez https://aws.amazon.com/lambda/pricing/
Avantages et limites de l'utilisation des tâches Lambda
L'utilisation de tâches Lambda à la place d'une activité Amazon SWF traditionnelle présente de nombreux avantages :
-
Les tâches Lambda n'ont pas besoin d'être enregistrées ou versionnées comme les types d'activité Amazon SWF.
-
Vous pouvez utiliser toutes les fonctions Lambda existantes que vous avez déjà définies dans vos flux de travail.
-
Les fonctions Lambda sont appelées directement par Amazon SWF ; il n'est pas nécessaire d'implémenter un programme de travail pour les exécuter, comme c'est le cas pour les activités traditionnelles.
-
Lambda vous fournit des métriques et des journaux pour suivre et analyser les exécutions de vos fonctions.
Vous devez également connaître les quelques limites qui s'appliquent aux tâches Lambda :
-
Les tâches Lambda ne peuvent être exécutées que dans AWS régions qui fournissent un support pour Lambda. Voir Régions et points de terminaison Lambda dans le Référence générale d'Amazon Web Services pour plus de détails sur les régions actuellement prises en charge pour Lambda.
-
Les tâches Lambda ne sont actuellement prises en charge que par l'API HTTP SWF de base et dans AWS Flow Framework pour Java. Les tâches Lambda ne sont actuellement pas prises en charge dans AWS Flow Framework pour Ruby.
Utilisation des tâches Lambda dans votre AWS Flow Framework pour les flux de travail Java
Trois conditions sont requises pour utiliser les tâches Lambda dans votre AWS Flow Framework pour les flux de travail Java :
-
Une fonction Lambda à exécuter. Vous pouvez utiliser n'importe quelle fonction Lambda que vous avez définie. Pour plus d'informations sur la création de fonctions Lambda, consultez AWS Lambda Guide du développeur.
-
Un rôle IAM qui permet d'exécuter des fonctions Lambda à partir de vos flux de travail Amazon SWF.
-
Code permettant de planifier la tâche Lambda depuis votre flux de travail.
Configuration d'un rôle IAM
Avant de pouvoir invoquer des fonctions Lambda depuis Amazon SWF, vous devez fournir un rôle IAM qui permet d'accéder à Lambda depuis Amazon SWF. Vous avez le choix entre les options suivantes :
-
choisissez un rôle prédéfini, AWSLambdaRole, pour autoriser vos flux de travail à invoquer n'importe quelle fonction Lambda associée à votre compte.
-
définissez votre propre politique et le rôle associé pour autoriser les flux de travail à invoquer des fonctions Lambda particulières, spécifiées par leurs Amazon Resource Names (ARN).
Limiter les autorisations sur un rôle IAM
Vous pouvez limiter les autorisations sur un rôle IAM que vous fournissez à Amazon SWF à l'aide du SourceArn et SourceAccount les clés contextuelles de votre politique de confiance en matière de ressources. Ces clés limitent l'utilisation d'une politique IAM afin qu'elle soit utilisée uniquement à partir des exécutions d'Amazon Simple Workflow Service qui appartiennent à l'ARN de domaine spécifié. Si vous utilisez les deux clés de contexte de condition globale, le aws:SourceAccount valeur et le compte référencé dans aws:SourceArn value doit utiliser le même identifiant de compte lorsqu'il est utilisé dans la même déclaration de politique.
Dans l'exemple suivant, SourceArn la clé de contexte limite le rôle de service IAM à utiliser uniquement dans les exécutions d'Amazon Simple Workflow Service qui appartiennent à someDomain dans le compte, 123456789012.
-
Déclaration 1
Directeur :
"Service": "swf.amazonaws.com"Action :
sts:AssumeRole
"Condition": { "ArnLike": { "aws:SourceArn": "arn:aws:swf:*:123456789012:/domain/someDomain" } }
Dans l'exemple suivant, SourceAccount la clé contextuelle limite le rôle de service IAM à n'être utilisé que dans les exécutions d'Amazon Simple Workflow Service sur le compte, 123456789012.
"Condition": { "StringLike": { "aws:SourceAccount": "123456789012" } }
Fournir à Amazon SWF un accès permettant d'invoquer n'importe quel rôle Lambda
Vous pouvez utiliser le rôle prédéfini, AWSLambdaRole, pour permettre à vos flux de travail Amazon SWF d'invoquer n'importe quelle fonction Lambda associée à votre compte.
À utiliser AWSLambdaRole pour autoriser Amazon SWF à invoquer des fonctions Lambda
-
Ouvrez la console IAM
. -
Choisissez Rôles, puis Créer un rôle.
-
Attribuez un nom à votre rôle, tel que
swf-lambda, puis choisissez Étape suivante. -
En dessous AWS Rôles de service, choisissez Amazon SWF, et choisissez Étape suivante.
-
Sur le Politique relative aux pièces jointes écran, choisissez AWSLambdaRole de la liste.
-
Choisissez Étape suivante, puis Créer un rôle une fois que vous avez vérifié le rôle.
Définition d'un rôle IAM pour fournir un accès permettant d'invoquer une fonction Lambda spécifique
Si vous souhaitez fournir un accès permettant d'invoquer une fonction Lambda spécifique à partir de votre flux de travail, vous devez définir votre propre politique IAM.
Pour créer une politique IAM permettant d'accéder à une fonction Lambda particulière
-
Ouvrez la console IAM
. -
Choisissez Stratégies, puis Créer une stratégie.
-
Choisissez Copiez un AWS Politique gérée et sélectionnez AWSLambdaRole de la liste. Une stratégie sera générée pour vous. Au besoin, modifiez son nom et sa description.
-
Dans le Ressource domaine du Document de politique, ajoutez l'ARN de vos fonctions Lambda. Par exemple :
-
Ressource :
arn:aws:lambda:us-east-1:111122223333:function:hello_lambda_function
NotePour une description complète de la manière de spécifier les ressources dans un rôle IAM, consultez Présentation des politiques IAM dans Utilisation d'IAM.
-
-
Choisissez Créer une stratégie afin de finaliser la création de la stratégie.
Vous pouvez ensuite sélectionner cette politique lors de la création d'un nouveau rôle IAM et utiliser ce rôle pour donner accès à Invoke à vos flux de travail Amazon SWF. Cette procédure est très similaire à la création d'un rôle avec AWSLambdaRole politique. Choisissez plutôt votre propre politique lors de la création du rôle.
Pour créer un rôle Amazon SWF à l'aide de votre politique Lambda
-
Ouvrez la console IAM
. -
Choisissez Rôles, puis Créer un rôle.
-
Attribuez un nom à votre rôle, tel que
swf-lambda-function, puis choisissez Étape suivante. -
En dessous AWS Rôles de service, choisissez Amazon SWF, et choisissez Étape suivante.
-
Sur le Politique relative aux pièces jointes écran, choisissez votre politique spécifique à la fonction Lambda dans la liste.
-
Choisissez Étape suivante, puis Créer un rôle une fois que vous avez vérifié le rôle.
Planifier l'exécution d'une tâche Lambda
Une fois que vous avez défini un rôle IAM qui vous permet d'invoquer des fonctions Lambda, vous pouvez planifier leur exécution dans le cadre de votre flux de travail.
Ce processus est pleinement démontré par HelloLambda échantillon dans le AWS SDK pour Java.
Pour planifier l'exécution d'une tâche Lambda
-
Dans l'implémentation de votre flux de travail, obtenez une instance de
LambdaFunctionClienten appelantgetLambdaFunctionClient()sur une instanceDecisionContext.// Get a LambdaFunctionClient instance DecisionContextProvider decisionProvider = new DecisionContextProviderImpl(); DecisionContext decisionContext = decisionProvider.getDecisionContext(); LambdaFunctionClient lambdaClient = decisionContext.getLambdaFunctionClient(); -
Planifiez la tâche à l'aide du
scheduleLambdaFunction()méthode sur leLambdaFunctionClient, en lui transmettant le nom de la fonction Lambda que vous avez créée et toutes les données d'entrée pour la tâche Lambda.// 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); -
Dans le démarreur d'exécution de votre flux de travail, ajoutez le rôle IAM lambda à vos options de flux de travail par défaut en utilisant
StartWorkflowOptions.withLambdaRole(), puis transmettez les options lors du démarrage du flux de travail.// 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);
Consultez le HelloLambda échantillon
Un exemple fournissant une implémentation d'un flux de travail utilisant une tâche Lambda est fourni dans le AWS SDK pour Java. Pour visionner and/or lancez-le, télécharger la source
Une description complète de la façon de créer et d'exécuter le HelloLambda un exemple est fourni dans le fichier README fourni avec AWS Flow Framework pour les exemples Java.