Criação de funções duráveis do Lambda
Para começar a usar as funções duráveis do Lambda, use o console do Lambda para criar uma função durável. Em alguns minutos, é possível criar e implantar uma função durável que use etapas e esperas para demonstrar a execução baseada em pontos de verificação.
Ao prosseguir no tutorial, você aprenderá conceitos fundamentais de funções duráveis, como usar o objeto DurableContext, criar pontos de verificação com etapas e pausar a execução com esperas. Você também aprenderá como a reprodução funciona quando sua função é retomada após uma espera.
Para simplificar, você cria sua função usando o runtime do Python ou do Node.js. Com essas linguagens interpretadas, você pode editar o código da função diretamente no editor de código integrado do console.
dica
Para saber como construir soluções com tecnologia sem servidor, confira o Guia do desenvolvedor com tecnologia sem servidor.
Pré-requisitos
Se você ainda não tem uma Conta da AWS, siga as etapas abaixo para criar uma.
Como cadastrar uma Conta da AWS
Abra https://portal.aws.amazon.com/billing/signup
. Siga as instruções online.
Parte do procedimento de inscrição envolve receber uma chamada telefônica ou uma mensagem de texto e inserir um código de verificação pelo teclado do telefone.
Quando você se inscreve para uma Conta da AWS, um Usuário raiz da conta da AWS é criado. O usuário-raiz tem acesso a todos os Serviços da AWS e recursos na conta. Como prática recomendada de segurança, atribua o acesso administrativo a um usuário e use somente o usuário-raiz para executar tarefas que exigem acesso de usuário-raiz.
A AWS envia um e-mail de confirmação depois que o processo de inscrição é concluído. A qualquer momento, é possível exibir as atividades da conta atual e gerenciar sua conta acessando https://aws.amazon.com/
Depois de se cadastrar em uma Conta da AWS, proteja seu Usuário raiz da conta da AWS, habilite o Centro de Identidade do AWS IAM e crie um usuário administrativo para não usar o usuário-raiz em tarefas cotidianas.
Proteger o Usuário raiz da conta da AWS
-
Faça login no Console de gerenciamento da AWS
como o proprietário da conta ao escolher a opção Usuário-raiz e inserir o endereço de e-mail da Conta da AWS. Na próxima página, insira a senha. Para obter ajuda ao fazer login usando o usuário-raiz, consulte Fazer login como usuário-raiz no Guia do usuário do Início de Sessão da AWS.
-
Habilite a autenticação multifator (MFA) para o usuário-raiz.
Para obter instruções, consulte Habilitar um dispositivo MFA virtual para sua Conta da AWS de usuário-raiz (console) no Guia do usuário do IAM.
Criar um usuário com acesso administrativo
-
Habilita o Centro de Identidade do IAM.
Para obter instruções, consulte Habilitar o Centro de Identidade do AWS IAM no Guia do usuário do Centro de Identidade do AWS IAM.
-
No Centro de Identidade do IAM, conceda o acesso administrativo a um usuário.
Para obter um tutorial sobre como usar o Diretório do Centro de Identidade do IAM como a fonte de identidade, consulte Configurar o acesso dos usuários com o Diretório do Centro de Identidade do IAM padrão no Guia do usuário do Centro de Identidade do AWS IAM.
Iniciar sessão como o usuário com acesso administrativo
-
Para fazer login com o seu usuário do Centro de Identidade do IAM, use o URL de login enviado ao seu endereço de e-mail quando o usuário do Centro de Identidade do IAM foi criado.
Para obter ajuda para fazer login usando um usuário do Centro de Identidade do IAM, consulte Fazer login no portal de acesso da AWS, no Guia do usuário do Início de Sessão da AWS.
Atribuir acesso a usuários adicionais
-
No Centro de Identidade do IAM, crie um conjunto de permissões que siga as práticas recomendadas de aplicação de permissões com privilégio mínimo.
Para obter instruções, consulte Criar um conjunto de permissões no Guia do usuário do Centro de Identidade do AWS IAM.
-
Atribua usuários a um grupo e, em seguida, atribua o acesso de logon único ao grupo.
Para obter instruções, consulte Adicionar grupos no Guia do usuário do Centro de Identidade do AWS IAM.
Criação de uma função durável do Lambda com o console
Neste exemplo, sua função durável processa um pedido por meio de várias etapas com verificação automática. A função usa um objeto JSON contendo um ID do pedido, valida o pedido, processa o pagamento e confirma o pedido. Cada etapa é verificada automaticamente, portanto, se a função for interrompida, ela será retomada a partir da última etapa concluída.
Sua função também demonstra uma operação de espera, pausando a execução por um curto período para simular a espera pela confirmação externa.
Para criar uma função durável com o console
Abra a página Funções
do console do Lambda. -
Escolha a opção Criar função.
-
Selecione Criar do zero.
-
No painel Informações básicas, para Nome da função, insira
.myDurableFunction -
Em Runtime, escolha Node.js 24 ou Python 3.14.
-
Selecione Habilitar execução durável.
O Lambda cria sua função durável com um perfil de execução que inclui permissões para operações de ponto de verificação (lambda:CheckpointDurableExecutions e lambda:GetDurableExecutionState).
nota
Os runtimes do Lambda incluem o SDK de execução durável, para que seja possível testar funções duráveis sem dependências de empacotamento. No entanto, recomendamos incluir o SDK em seu pacote de implantação para produção. Isso garante a consistência da versão e evita possíveis atualizações de runtime que possam afetar sua função.
Use o editor de código embutido do console para adicionar o código da sua função durável.
Invocação da função durável usando o editor de códigos do console
As funções duráveis exigem um ARN qualificado para invocação. Antes de poder invocar sua função durável, publique uma versão.
Para publicar uma versão da sua função
-
Escolha a guia Versões.
-
Escolha Publicar nova versão.
-
Em Descrição da versão, insira
Initial version(opcional). -
Selecione Publish.
-
O Lambda criará a versão 1 da sua função. Observe que a função do ARN agora inclui
:1no final, indicando que esta é a versão 1.
Agora, crie um evento de teste para enviar à sua função. O evento é um documento em formato JSON contendo um ID de pedido.
Criar o evento de teste
-
Na seção TEST EVENTS do editor de código do console, escolha Criar evento de teste.
-
Em Event Name (Nome do evento), insira
myTestEvent. -
Na seção JSON do evento, substitua o JSON padrão pelo seguinte:
{ "orderId": "order-12345" } -
Escolha Salvar.
Para testar sua função durável e visualizar a execução
Na seção TEST EVENTS do editor de código do console, selecione o ícone de execução ao lado do evento de teste:
Sua função durável começará a ser executada. Como ela inclui uma espera de 10 segundos, a invocação inicial é concluída rapidamente e a função será retomada após o período de espera. É possível visualizar o andamento da execução na guia Execuções duráveis.
Para visualizar sua execução da sua função durável
-
Escolha a guia Execuções duráveis.
-
Encontre sua execução na lista. A execução mostra o status atual (Em execução, Com êxito ou Com falha).
-
Escolha o ID da execução para visualizar os detalhes, incluindo:
Cronograma de execução, mostrando quando cada etapa foi concluída
Histórico dos pontos de verificação
Períodos de espera
Resultados de etapas
Também é possível visualizar os logs da sua função no CloudWatch Logs para ver a saída do console de cada etapa.
Para visualizar os registros de invocação da sua função no CloudWatch Logs
-
Abra a página Log groups
(Grupos de log) do console do CloudWatch. -
Escolha o nome do grupo de logs para sua função (
/aws/lambda/myDurableFunction). -
Role para baixo e selecione o Fluxo de logs para as invocações da função que você deseja verificar.
Você verá as entradas de log para cada invocação de sua função, incluindo a execução inicial e a reprodução após a espera.
Limpeza
Quando você tiver terminado de trabalhar com a função durável de exemplo, exclua-a. Também é possível excluir o grupo de logs que armazena os logs da função e a função de execução que o console criou.
Como excluir a função do Lambda
-
Abra a página Functions
(Funções) no console do Lambda. -
Selecione a função que você criou.
-
Selecione Ações, Excluir.
-
Digite
confirmno campo de entrada de texto e escolha Delete (Excluir).
Para excluir o grupo de logs
-
Abra a página Log groups
(Grupos de log) do console do CloudWatch. -
Selecione o grupo de logs da função (
/aws/lambda/myDurableFunction). -
Selecione Actions (Ações), Delete log group(s) (Excluir grupo(s) de log).
-
Na caixa de diálogo Delete log group(s) (Excluir grupo(s) de logs), escolha Delete (Excluir).
Para excluir a função de execução
-
Abra a página Roles
(Funções) no console do AWS Identity and Access Management (IAM). -
Selecione o perfil de execução da função (por exemplo,
myDurableFunction-role-).31exxmpl -
Escolha Excluir.
-
Na caixa de diálogo Excluir perfil, insira o nome do perfil e, em seguida, escolha Excluir.
Recursos adicionais e próximas etapas
Agora que você criou e testou uma função durável simples usando o console, siga estes próximos passos:
-
Saiba mais sobre casos de uso comuns para funções duráveis, incluindo transações distribuídas, processamento de pedidos e fluxos de trabalho de revisão humana. Veja Exemplos.
-
Entenda como monitorar execuções de funções duráveis com as métricas e o histórico de execução do CloudWatch. Consulte Monitoramento e depuração.
-
Saiba mais sobre como invocar funções duráveis de forma síncrona e assíncrona e gerenciar execuções de longa duração. Consulte Invocação de funções duráveis.
-
Siga as práticas recomendadas para escrever código determinístico, gerenciar tamanhos de pontos de verificação e otimizar custos. Consulte as Práticas recomendadas.
-
Saiba mais sobre como testar as funções duráveis localmente e na nuvem Consulte Testes de funções duráveis.