Implemente e invoque funções duráveis do Lambda com a AWS CLI

Use a AWS CLI para criar e implantar funções duráveis do Lambda com comandos imperativos. Essa abordagem oferece controle direto sobre cada etapa do processo de implantação.

Pré-requisitos

Criar a função de execução

Crie um perfil do IAM com permissões para operações básicas de execução e ponto de verificação do Lambda.

A política gerenciada AWSLambdaBasicDurableExecutionRolePolicy inclui as permissões necessárias para operações de ponto de verificação (lambda:CheckpointDurableExecution e lambda:GetDurableExecutionState) e execução básica do Lambda.

Criação da função durável

Crie sua função durável com o parâmetro --durable-config.

Publicação de uma versão

Embora as funções duráveis possam ser invocadas usando o qualificador de versão $LATEST, você sempre deve usar um ARN qualificado apontando para uma versão estável a fim de garantir a execução determinística do seu código.

aws lambda publish-version \
  --function-name myDurableFunction \
  --description "Initial version"

O comando retorna o ARN da versão. Anote o número da versão (por exemplo, :1) no final do ARN.

Opcionalmente, crie um alias que aponte para a versão.

aws lambda create-alias \
  --function-name myDurableFunction \
  --name prod \
  --function-version 1

Invocação da função durável

Invoque sua função durável usando o ARN qualificado (versão ou alias).

Invocação síncrona

Para execuções concluídas dentro de 15 minutos, use a invocação síncrona:

aws lambda invoke \
  --function-name myDurableFunction:1 \
  --payload '{"orderId": "order-12345"}' \
  --cli-binary-format raw-in-base64-out \
  response.json

Ou usando um alias:

aws lambda invoke \
  --function-name myDurableFunction:prod \
  --payload '{"orderId": "order-12345"}' \
  --cli-binary-format raw-in-base64-out \
  response.json

Invocação assíncrona

Para execuções de longa duração, use a invocação assíncrona:

aws lambda invoke \
  --function-name myDurableFunction:prod \
  --invocation-type Event \
  --payload '{"orderId": "order-12345"}' \
  --cli-binary-format raw-in-base64-out \
  response.json

Com a invocação assíncrona, o Lambda retorna imediatamente. A função continua em execução em segundo plano.

Gerenciamento de execuções duráveis

Use os comandos a seguir para gerenciar e monitorar execuções de funções duráveis

Execuções de lista

Liste todas as execuções de uma função durável:

aws lambda list-durable-executions-by-function \
  --function-name myDurableFunction

Obtenção dos detalhes da execução

Obtenha detalhes sobre uma execução específica:

aws lambda get-durable-execution \
  --durable-execution-arn arn:aws:lambda:us-east-1:123456789012:function:myDurableFunction:my-function-version/durable-execution/my-execution-name/my-execution-id

Obtenção do histórico de execução

Visualize o histórico de pontos de verificação de uma execução:

aws lambda get-durable-execution-history \
  --durable-execution-arn arn:aws:lambda:us-east-1:123456789012:function:myDurableFunction:my-function-version/durable-execution/my-execution-name/my-execution-id

Interrupção de uma execução

Interrompa uma execução durável em andamento:

aws lambda stop-durable-execution \
  --durable-execution-arn arn:aws:lambda:us-east-1:123456789012:function:myDurableFunction:my-function-version/durable-execution/my-execution-name/my-execution-id

Atualizar um código de função

Atualize o código da sua função durável e publique uma nova versão:

Visualizar logs de função

Visualize os logs da sua função durável no CloudWatch Logs:

aws logs tail /aws/lambda/myDurableFunction --follow

Filtre logs para uma execução específica:

aws logs filter-log-events \
  --log-group-name /aws/lambda/myDurableFunction \
  --filter-pattern "exec-abc123"

Limpar os recursos

Exclua sua função durável e os recursos associados:

# Delete the function
aws lambda delete-function --function-name myDurableFunction

# Delete the IAM role policies
aws iam detach-role-policy \
  --role-name durable-function-role \
  --policy-arn arn:aws:iam::aws:policy/service-role/AWSLambdaBasicExecutionRole

aws iam detach-role-policy \
  --role-name durable-function-role \
  --policy-arn arn:aws:iam::aws:policy/service-role/AWSLambdaBasicDurableExecutionRolePolicy

# Delete the role
aws iam delete-role --role-name durable-function-role

Próximas etapas

Depois de implantar sua função durável com a AWS CLI:

Para obter mais informações sobre os comandos da AWS CLI para o Lambda, consulte a Referência de comandos da AWS CLI.