Creación de funciones duraderas de Lambda
Para iniciarte en las funciones duraderas de Lambda, utiliza la consola de Lambda para crear una función duradera. En unos minutos, puede crear e implementar una función duradera que utilice pasos y esperas para demostrar la ejecución basada en puntos de control.
A medida que realice el tutorial, aprenderá conceptos fundamentales sobre funciones duraderas, por ejemplo, cómo usar el objeto DurableContext, crear puntos de control mediante pasos y pausar la ejecución mediante esperas. También obtendrá información sobre cómo funciona la reproducción cuando la función se reanuda tras una espera.
Para simplificar, cree su función mediante el tiempo de ejecución de Python o Node.js. Con estos lenguajes interpretados, puede editar el código de función directamente en el editor de código integrado en la consola.
sugerencia
Para obtener información sobre cómo crear soluciones sin servidor, consulte la Guía para desarrolladores sin servidor.
Requisitos previos
Si no dispone de una Cuenta de AWS, siga estos pasos para crear una.
Procedimiento para registrarse en Cuenta de AWS
Abra https://portal.aws.amazon.com/billing/signup
. Siga las instrucciones que se le indiquen.
Parte del procedimiento de registro consiste en recibir una llamada telefónica o mensaje de texto e indicar un código de verificación en el teclado del teléfono.
Al registrarse en una Cuenta de AWS, se crea un Usuario raíz de la cuenta de AWS. El usuario raíz tendrá acceso a todos los Servicios de AWS y recursos de esa cuenta. Como práctica recomendada de seguridad, asigne acceso administrativo a un usuario y utilice únicamente el usuario raíz para realizar tareas que requieren acceso de usuario raíz.
AWS le enviará un correo electrónico de confirmación cuando complete el proceso de registro. Se puede ver la actividad de la cuenta y administrarla en cualquier momento entrando en https://aws.amazon.com/
Después de registrarse para obtener una Cuenta de AWS, proteja su Usuario raíz de la cuenta de AWS, habilite AWS IAM Identity Center y cree un usuario administrativo para no usar el usuario raíz en las tareas cotidianas.
Protección de Usuario raíz de la cuenta de AWS
-
Inicie sesión en Consola de administración de AWS
como propietario de la cuenta; para ello, elija Usuario raíz e introduzca el correo electrónico de su Cuenta de AWS. En la siguiente página, escriba su contraseña. Para obtener ayuda para iniciar sesión con el usuario raíz, consulte Iniciar sesión como usuario raíz en la Guía del usuario de AWS Sign-In.
-
Active la autenticación multifactor (MFA) para el usuario raíz.
Para obtener instrucciones, consulte Habilitación de un dispositivo MFA virtual para su usuario raíz de la Cuenta de AWS (consola) en la Guía del usuario de IAM.
Creación de un usuario con acceso administrativo
-
Activar IAM Identity Center.
Consulte las instrucciones en Activar AWS IAM Identity Center en la Guía del usuario de AWS IAM Identity Center.
-
En IAM Identity Center, conceda acceso administrativo a un usuario.
Para ver un tutorial sobre cómo usar Directorio de IAM Identity Center como origen de identidad, consulte Configuración del acceso de los usuarios con el Directorio de IAM Identity Center predeterminado en la Guía del usuario de AWS IAM Identity Center.
Inicio de sesión como usuario con acceso de administrador
-
Para iniciar sesión con el usuario de IAM Identity Center, use la URL de inicio de sesión que se envió a la dirección de correo electrónico cuando creó el usuario de IAM Identity Center.
Para obtener ayuda para iniciar sesión con un usuario de IAM Identity Center, consulte Inicio de sesión en el portal de acceso de AWS en la Guía del usuario de AWS Sign-In.
Concesión de acceso a usuarios adicionales
-
En IAM Identity Center, cree un conjunto de permisos que siga la práctica recomendada de aplicar permisos de privilegios mínimos.
Para conocer las instrucciones, consulte Create a permission set en la Guía del usuario de AWS IAM Identity Center.
-
Asigne usuarios a un grupo y, a continuación, asigne el acceso de inicio de sesión único al grupo.
Para conocer las instrucciones, consulte Add groups en la Guía del usuario de AWS IAM Identity Center.
Creación de una función duradera de Lambda con la consola
En este ejemplo, la función duradera procesa un pedido en varios pasos con creación automática de puntos de control. La función toma un objeto de JSON que contiene un identificador de pedido, lo valida, procesa el pago y lo confirma. Cada paso atraviesa automáticamente por un punto de control, por lo que, si la función se interrumpe, se reanudará desde el último paso completado.
La función también muestra una operación de espera, en la que se pausa la ejecución durante un breve período para simular la espera de una confirmación externa.
Cómo crear una función duradera con la consola
Abra la página de Functions
(Funciones) en la consola de Lambda. -
Seleccione Creación de función.
-
Seleccione Crear desde cero.
-
En el panel de Información básica, ingrese
para el Nombre de la función.myDurableFunction -
En Tiempo de ejecución, elija Node.js 24 o Python 3.14.
-
Seleccione Habilitar la ejecución duradera.
Lambda crea la función duradera con un rol de ejecución que incluye permisos para las operaciones de puntos de control (lambda:CheckpointDurableExecutions y lambda:GetDurableExecutionState).
nota
Los tiempos de ejecución de Lambda incluyen el SDK de ejecución duradera, por lo que puede probar funciones duraderas sin empaquetar dependencias. Sin embargo, le recomendamos incluir el SDK en su paquete de implementación para producción. Esto garantiza la coherencia de las versiones y evita posibles actualizaciones del tiempo de ejecución que podrían afectar su función.
Para añadir el código de la función duradera, utilice el editor de código integrado en la consola.
Invocación de la función de Lambda mediante la consola de editor de código
Las funciones duraderas requieren un ARN calificado para su invocación. Antes de poder invocar la función duradera, publique una versión.
Cómo publicar una versión de la función:
-
Elija la pestaña Versiones.
-
Elija Publicar nueva versión.
-
En Descripción de la versión, introduzca
Initial version(opcional). -
Elija Publicar.
-
Lambda crea la versión 1 de la función. Tenga en cuenta que el ARN de la función ahora incluye
:1al final, lo que indica que se trata de la versión 1.
Ahora cree un evento de prueba a fin de enviarlo a su función. El evento es un documento con formato JSON que contiene un identificador de pedido.
Para crear el evento de prueba, realice lo siguiente:
-
En la sección EVENTOS DE PRUEBA del editor de código de la consola, elija Crear evento de prueba.
-
Para Event name (Nombre de evento), escriba
myTestEvent. -
En la sección Evento JSON, sustituya el JSON predeterminado por el siguiente:
{ "orderId": "order-12345" } -
Seleccione Save.
Cómo probar la función duradera y ver la ejecución
En la sección EVENTOS DE PRUEBA del editor de código de la consola, seleccione el ícono de ejecución junto a su evento de prueba:
Su función duradera comienza a ejecutarse. Dado que incluye una espera de 10 segundos, la invocación inicial se completa rápidamente, y la función se reanuda tras el período de espera. Puede ver el progreso de la ejecución en la pestaña Ejecuciones duraderas.
Cómo ver la ejecución de función duradera
-
Seleccione la pestaña Ejecuciones duraderas.
-
Busque la ejecución en la lista. La ejecución muestra el estado actual (En ejecución, satisfactoria o fallida).
-
Seleccione el identificador de ejecución para ver los detalles, entre otros los siguientes:
El cronograma de ejecución que muestra cuándo se completó cada paso.
El historial de los puntos de control.
Los períodos de espera.
Los resultados de la prueba.
También puede ver los registros de la función en Registros de CloudWatch para ver el resultado de la consola de cada paso.
Visualización de los registros de invocación de la función en Registros de CloudWatch
-
En la consola de CloudWatch, abra la página Log groups (grupos de registro)
. -
Elija el grupo de registro para la función (
/aws/lambda/myDurableFunction). -
Desplácese hacia abajo y seleccione el flujo de registro para las invocaciones de la función que desee consultar.
Debería ver las entradas de registro de cada invocación de la función, incluidas la ejecución inicial y la reproducción tras la espera.
Limpieza
Cuando haya terminado de trabajar con la función duradera de ejemplo, elimínela. También puede eliminar el rol de ejecución creado por la consola y el grupo de registro que almacena los registros de la función.
Cómo eliminar la función de Lambda
-
Abra la página de Funciones
en la consola de Lambda. -
Seleccione la función que ha creado.
-
Elija Acciones, Eliminar.
-
Escriba
confirmen el campo de entrada de texto y elija Delete(Eliminar).
Para eliminar el grupo de registros
-
En la consola de CloudWatch, abra la página Log groups (Grupos de registro)
. -
Seleccione el grupo de registros de la función (
/aws/lambda/myDurableFunction). -
Elija Acciones, Eliminar grupo(s) de registro(s).
-
En el cuadro de diálogo Eliminar grupos de registros, elija Eliminar.
Cómo eliminar el rol de ejecución
-
Abra la página de Roles
de la consola de AWS Identity and Access Management (IAM). -
Seleccione el rol de ejecución de la función, por ejemplo, .,
myDurableFunction-role-).31exxmpl -
Elija Eliminar.
-
En el cuadro de diálogo Eliminar rol, escriba el nombre del rol y, a continuación, elija Eliminar.
Recursos adicionales y próximos pasos
Ahora que ha creado y probado una función duradera simple de Lambda con la consola, siga los pasos a continuación:
-
Obtenga información sobre los casos de uso más comunes de las funciones duraderas, como las transacciones distribuidas, el procesamiento de pedidos y los flujos de trabajo de revisión humana. Consulte Ejemplos.
-
Descubra cómo supervisar las ejecuciones de funciones duraderas con las métricas y el historial de ejecución de CloudWatch. Consulte Supervisión y depuración.
-
Obtenga información sobre cómo invocar funciones duraderas de forma sincrónica y asíncrona y cómo administrar las ejecuciones de larga duración. Consulte Invocación de funciones duraderas.
-
Siga las prácticas recomendadas para escribir código determinista, administrar el tamaño de los puntos de control y optimizar los costos. Consulte Prácticas recomendadas.
-
Obtenga información sobre cómo probar las funciones duraderas a nivel local y en la nube. Consulte Prueba de funciones duraderas.