View a markdown version of this page

AWS Lambda attività in Amazon SWF - Amazon Simple Workflow Service

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

AWS Lambda attività in Amazon SWF

Informazioni AWS Lambda

AWS Lambda è un servizio di elaborazione completamente gestito che esegue il codice in risposta a eventi generati da codice personalizzato o da vari AWS servizi come Amazon S3, DynamoDB, Amazon Kinesis, Amazon SNS e Amazon Cognito. Per ulteriori informazioni su Lambda, consulta la Guida per gli sviluppatori di AWS Lambda.

Amazon Simple Workflow Service fornisce un'attività Lambda che consente di eseguire funzioni Lambda al posto o insieme alle attività tradizionali di Amazon SWF.

Importante

Il tuo AWS all'account verranno addebitate le esecuzioni (richieste) Lambda eseguite da Amazon SWF per tuo conto. Per informazioni dettagliate sui prezzi di Lambda, consulta https://aws.amazon.com/lambda/pricing/.

Vantaggi e limiti dell'utilizzo delle attività Lambda

L'utilizzo delle attività Lambda al posto di un'attività Amazon SWF tradizionale offre numerosi vantaggi:

  • Le attività Lambda non devono essere registrate o sottoposte a versioni come i tipi di attività Amazon SWF.

  • Puoi utilizzare qualsiasi funzione Lambda esistente che hai già definito nei tuoi flussi di lavoro.

  • Le funzioni Lambda vengono richiamate direttamente da Amazon SWF; non è necessario implementare un programma di lavoro per eseguirle, come invece avviene con le attività tradizionali.

  • Lambda fornisce metriche e log per tracciare e analizzare le esecuzioni delle funzioni.

L'utilizzo di task Lambda comporta anche alcuni limiti che è necessario conoscere:

  • Le attività Lambda possono essere eseguite solo in AWS regioni che forniscono supporto per Lambda. Vedi Regioni ed endpoint Lambda nel Riferimento generale di Amazon Web Services per informazioni dettagliate sulle regioni attualmente supportate per Lambda.

  • Le attività Lambda sono attualmente supportate solo dall'API HTTP SWF di base e nel AWS Flow Framework per Java. Al momento non è disponibile alcun supporto per le attività Lambda in AWS Flow Framework per Ruby.

Utilizzo delle attività Lambda nei flussi di lavoro

Per utilizzare le attività Lambda nei flussi di lavoro Amazon SWF, dovrai:

  1. Configura i ruoli IAM per fornire ad Amazon SWF il permesso di richiamare le funzioni Lambda.

  2. Collegare i ruoli IAM ai tuoi flussi di lavoro.

  3. Chiamare la funzione Lambda durante un'esecuzione di flusso di lavoro.

Configurazione di un ruolo IAM

Prima di poter richiamare le funzioni Lambda da Amazon SWF, devi fornire un ruolo IAM che fornisca l'accesso a Lambda da Amazon SWF. Puoi eseguire una delle seguenti operazioni:

  • scegli un ruolo predefinito, AWSLambdaRole, per autorizzare i tuoi flussi di lavoro a richiamare qualsiasi funzione Lambda associata al tuo account.

  • definisci la tua policy e il ruolo associato per autorizzare i flussi di lavoro a richiamare particolari funzioni Lambda, specificate dai relativi Amazon Resource Names (ARN).

Limita le autorizzazioni su un ruolo IAM

Puoi limitare le autorizzazioni su un ruolo IAM che fornisci ad Amazon SWF utilizzando SourceArn e SourceAccount chiavi di contesto nella tua politica di fiducia delle risorse. Queste chiavi limitano l'utilizzo di una policy IAM in modo che venga utilizzata solo dalle esecuzioni di Amazon Simple Workflow Service che appartengono al dominio ARN specificato. Se utilizzi entrambe le chiavi di contesto delle condizioni globali, aws:SourceAccount valore e l'account a cui si fa riferimento in aws:SourceArn value deve utilizzare lo stesso ID account se utilizzato nella stessa dichiarazione politica.

Nel seguente esempio, SourceArn la chiave di contesto limita il ruolo del servizio IAM a essere utilizzato solo nelle esecuzioni di Amazon Simple Workflow Service che appartengono a someDomain nell'account, 123456789012.

  • Dichiarazione 1

    Preside : "Service": "swf.amazonaws.com"

    Operazione: sts:AssumeRole

"Condition": { "ArnLike": { "aws:SourceArn": "arn:aws:swf:*:123456789012:/domain/someDomain" } }

Nel seguente esempio, SourceAccount la chiave di contesto limita il ruolo del servizio IAM a essere utilizzato solo nelle esecuzioni di Amazon Simple Workflow Service nell'account, 123456789012.

"Condition": { "StringLike": { "aws:SourceAccount": "123456789012" } }

Fornire ad Amazon SWF l'accesso per richiamare qualsiasi ruolo Lambda

Puoi usare il ruolo predefinito, AWSLambdaRole, per dare ai tuoi flussi di lavoro Amazon SWF la possibilità di richiamare qualsiasi funzione Lambda associata al tuo account.

Da usare AWSLambdaRole per consentire ad Amazon SWF di accedere alle funzioni Lambda
  1. Apri la console IAM.

  2. Scegli Roles (Ruoli), quindi Create New Role (Crea nuovo ruolo).

  3. Assegna un nome al ruolo, come swf-lambda, quindi scegli Next Step (Fase successiva).

  4. Sotto AWS Ruoli di servizio, scegli Amazon SWFe scegli Passaggio successivo.

  5. Sul Allega politica schermo, scegli AWSLambdaRole dall'elenco.

  6. Scegli Next Step (Fase successiva), quindi Create Role (Crea ruolo) dopo aver esaminato il ruolo.

Definizione di un ruolo IAM per fornire l'accesso per invocare una funzione Lambda specifica

Se desideri fornire l'accesso per richiamare una funzione Lambda specifica dal tuo flusso di lavoro, dovrai definire la tua policy IAM.

Per creare una policy IAM per fornire l'accesso a una particolare funzione Lambda
  1. Apri la console IAM.

  2. Scegli Policies (Policy), quindi Create Policy (Crea policy).

  3. Scegli Copia un AWS Politica gestita e seleziona AWSLambdaRole dall'elenco. Viene generata una policy. Se necessario, modificane il nome e la descrizione.

  4. Nel Risorsa campo del Documento politico, aggiungi l'ARN delle tue funzioni Lambda. Ad esempio:

    • Risorsa: arn:aws:lambda:us-east-1:111122223333:function:hello_lambda_function

    Nota

    Per una descrizione completa di come specificare le risorse in un ruolo IAM, consulta Panoramica delle politiche IAM nel Usare IAM.

  5. Scegli Create Policy (Crea policy) per completare la creazione della policy.

Puoi quindi selezionare questa policy quando crei un nuovo ruolo IAM e utilizzarlo per consentire a invoke di accedere ai tuoi flussi di lavoro Amazon SWF. Questa procedura è molto simile alla creazione di un ruolo con AWSLambdaRole policy. invece, scegli la tua politica quando crei il ruolo.

Per creare un ruolo Amazon SWF utilizzando la tua policy Lambda
  1. Apri la console IAM.

  2. Scegli Roles (Ruoli), quindi Create New Role (Crea nuovo ruolo).

  3. Assegna un nome al ruolo, come swf-lambda-function, quindi scegli Next Step (Fase successiva).

  4. Sotto AWS Ruoli di servizio, scegli Amazon SWFe scegli Passaggio successivo.

  5. Sul Allega politica schermata, scegli la tua policy specifica per la funzione Lambda dall'elenco.

  6. Scegli Next Step (Fase successiva), quindi Create Role (Crea ruolo) dopo aver esaminato il ruolo.

Collegamento del ruolo IAM al flusso di lavoro

Una volta definito il tuo ruolo IAM, dovrai collegarlo al flusso di lavoro che lo utilizzerà per richiamare le funzioni Lambda a cui hai fornito l'accesso ad Amazon SWF.

È possibile effettuare il collegamento del ruolo al flusso di lavoro:

  • Durante la registrazione del tipo di flusso di lavoro. Questo ruolo può quindi essere utilizzato come ruolo Lambda di default per ogni esecuzione di quel tipo di flusso di lavoro.

  • All'avvio di un'esecuzione di flusso di lavoro. Questo ruolo sarà utilizzato esclusivamente durante l'esecuzione di quel flusso di lavoro (e nel corso dell'intera esecuzione).

Per impostare un ruolo Lambda di default per un tipo di flusso di lavoro
  • Quando chiami RegisterWorkflowType, imposta l'impostazione predefinitaLambdaRole campo relativo all'ARN del ruolo che hai definito.

Per impostare un ruolo Lambda da utilizzare durante un'esecuzione di flusso di lavoro
  • Quando si chiama StartWorkflowExecution, imposta il campo LambdaRole sull'ARN del ruolo che hai definito.

Nota

se l'account chiama RegisterWorkflowType o StartWorkflowExecution non è autorizzato a utilizzare il ruolo specificato, quindi la chiamata avrà esito negativo con un OperationNotPermittedFault.

Richiama la tua funzione Lambda da un flusso di lavoro Amazon SWF

Puoi usare ScheduleLambdaFunctionDecisionAttributes tipo di dati per identificare la funzione Lambda da chiamare durante l'esecuzione di un flusso di lavoro.

Durante una chiamata a RespondDecisionTaskCompleted, fornire un ScheduleLambdaFunctionDecisionAttributes alla tua lista delle decisioni. Ad esempio:

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

Imposta i seguenti parametri:

  • id con un identificatore per il task Lambda. Deve essere una stringa che contiene da 1 a 256 caratteri ma non i caratteri : (due punti), / (barra obliqua), | (barra verticale), i caratteri di controllo (\u0000 - \u001f e \u007f - \u009f) e la stringa letterale arn.

  • name con il nome della funzione Lambda. Il tuo flusso di lavoro Amazon SWF deve essere dotato di un ruolo IAM che gli consenta di chiamare la funzione Lambda. Il nome fornito deve rispettare i vincoli per FunctionName parametro come nell'azione Lambda Invoke.

  • input con dati di input facoltativi per la funzione. Se impostato, questo deve seguire i vincoli per ClientContext parametro come nell'azione Lambda Invoke.

  • inizioToCloseTimeout con un periodo massimo opzionale, in secondi, che la funzione può impiegare per essere eseguita prima che l'operazione abbia esito negativo con un'eccezione di timeout. Il valore NONE può essere utilizzato per specificare una durata illimitata.

Per ulteriori informazioni, vedere Attuazione AWS Lambda Compiti