View a markdown version of this page

AWS Lambda tâches dans Amazon SWF - Amazon Simple Workflow Service

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.

AWS Lambda tâches dans Amazon SWF

À 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.

Important

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 vos flux de travail

Pour utiliser les tâches Lambda dans vos flux de travail Amazon SWF, vous devez :

  1. Configurez des rôles IAM pour autoriser Amazon SWF à invoquer des fonctions Lambda.

  2. Attachez les rôles IAM à vos flux de travail.

  3. Appelez la fonction Lambda pendant une exécution de 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
  1. Ouvrez la console IAM.

  2. Choisissez Rôles, puis Créer un rôle.

  3. Attribuez un nom à votre rôle, tel que swf-lambda, puis choisissez Étape suivante.

  4. En dessous AWS Rôles de service, choisissez Amazon SWF, et choisissez Étape suivante.

  5. Sur le Politique relative aux pièces jointes écran, choisissez AWSLambdaRole de la liste.

  6. 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
  1. Ouvrez la console IAM.

  2. Choisissez Stratégies, puis Créer une stratégie.

  3. 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.

  4. 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

    Note

    Pour 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.

  5. 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
  1. Ouvrez la console IAM.

  2. Choisissez Rôles, puis Créer un rôle.

  3. Attribuez un nom à votre rôle, tel que swf-lambda-function, puis choisissez Étape suivante.

  4. En dessous AWS Rôles de service, choisissez Amazon SWF, et choisissez Étape suivante.

  5. Sur le Politique relative aux pièces jointes écran, choisissez votre politique spécifique à la fonction Lambda dans la liste.

  6. Choisissez Étape suivante, puis Créer un rôle une fois que vous avez vérifié le rôle.

Attacher le rôle IAM à votre flux de travail

Une fois que vous avez défini votre rôle IAM, vous devez l'associer au flux de travail qui l'utilisera pour appeler les fonctions Lambda auxquelles vous avez autorisé Amazon SWF à accéder.

Vous pouvez attacher le rôle au flux de travail à deux niveaux :

  • Lors de l'enregistrement de type de flux de travail. Ce rôle pourra ensuite être utilisé comme rôle Lambda par défaut pour chaque exécution de ce type de flux de travail.

  • Lors du lancement d'une exécution de flux de travail. Ce rôle sera utilisé uniquement au cours de l'exécution de ce flux de travail (et tout au long de l'exécution).

Pour fournir un rôle Lambda par défaut pour un type de flux de travail
  • Lorsque vous appelez RegisterWorkflowType, définissez la valeur par défautLambdaRole champ de l'ARN du rôle que vous avez défini.

Pour fournir un rôle Lambda à utiliser pendant une exécution de flux de travail
  • Lorsque vous appelez StartWorkflowExecution, définissez le champ LambdaRole sur l'ARN du rôle que vous avez défini.

Note

si le compte appelle RegisterWorkflowType ou StartWorkflowExecution n'est pas autorisé à utiliser le rôle donné, alors l'appel échouera avec un OperationNotPermittedFault.

Appelez votre fonction Lambda depuis un flux de travail Amazon SWF

Vous pouvez utiliser ScheduleLambdaFunctionDecisionAttributes type de données pour identifier la fonction Lambda à appeler lors de l'exécution d'un flux de travail.

Lors d'un appel à RespondDecisionTaskCompleted, fournissez un ScheduleLambdaFunctionDecisionAttributes à votre liste de décisions. Par exemple :

{ "decisions": [{ "ScheduleLambdaFunctionDecisionAttributes": { "id": "lambdaTaskId", "name": "myLambdaFunctionName", "input": "inputToLambdaFunction", "startToCloseTimeout": "30" }, }], }

Définissez les paramètres suivants :

  • ID avec un identifiant pour la tâche Lambda. Il doit s'agir d'une chaîne qui contient entre 1 et 256 caractères, sans les caractères : (deux points), / (barre oblique), | (barre verticale) ni les caractères de contrôle (\u0000 - \u001f et \u007f - \u009f), ni la chaîne littérale arn.

  • nom avec le nom de votre fonction Lambda. Votre flux de travail Amazon SWF doit être doté d'un rôle IAM lui permettant d'appeler la fonction Lambda. Le nom fourni doit respecter les contraintes du FunctionName paramètre comme dans l'action Lambda Invoke.

  • input avec les données d'entrée facultatives de la fonction. S'il est défini, il doit respecter les contraintes du ClientContext paramètre comme dans l'action Lambda Invoke.

  • démarrerToCloseTimeout avec une période maximale facultative, en secondes, que la fonction peut prendre pour s'exécuter avant que la tâche n'échoue avec une exception de délai d'attente. La valeur NONE peut être utilisée pour spécifier une durée illimitée.

Pour plus d'informations, voir Mise en œuvre AWS Lambda Tâches