Creación de funciones de Lambda con Ruby - AWS Lambda

Creación de funciones de Lambda con Ruby

Puede ejecutar Ruby code en AWS Lambda. Lambda proporciona tiempos de ejecución para Ruby que ejecutan código para procesar eventos. El código se ejecuta en un entorno que incluye el AWS SDK parar Ruby, con credenciales de un rol de AWS Identity and Access Management (IAM) administrado por usted.

Lambda admite los siguientes entornos de ejecución de Ruby.

Tiempos de ejecución de Ruby
Nombre Identificador AWS SDK para Ruby Sistema operativo

Ruby 2.7

ruby2.7

3.0.1

Amazon Linux 2

Ruby 2.5

ruby2.5

3.0.1

Amazon Linux

Las funciones de Lambda utilizan un rol de ejecución para obtener permiso para escribir registros en Amazon CloudWatch Logs y para tener acceso a otros servicios y recursos. Si aún no tiene un rol de ejecución para el desarrollo de funciones, cree uno.

Para crear un rol de ejecución

  1. Abra la página Roles en la consola de IAM.

  2. Elija Create role (Crear rol).

  3. Cree un rol con las propiedades siguientes.

    • Trusted entity (Entidad de confianza)Lambda.

    • PermisosAWSLambdaVPCAccessExecutionRole..

    • Role name (Nombre de rol): lambda-role.

    La política AWSLambdaVPCAccessExecutionRole tiene permisos que la función necesita para escribir registros a CloudWatch Logs.

Puede agregar permisos al rol más tarde o cambiarlo por otro rol específico para una sola función.

Para crear una función de Ruby

  1. Abra la consola de Lambda.

  2. Elija Create function (Crear función).

  3. Configure los siguientes ajustes:

    • Name (Nombre): my-function.

    • Runtime (Tiempo de ejecución): Ruby 2.7.

    • Role (Rol): Choose an existing role (Elija un rol existente).

    • Existing role (Rol existente): lambda-role.

  4. Elija Create function (Crear función).

  5. Para configurar un evento de prueba, seleccione Test (Prueba).

  6. Para Event name (Nombre de evento), escriba test.

  7. Seleccione Create.

  8. Para ejecutar la función, seleccione Test (Prueba).

La consola crea una función de Lambda con un único archivo de origen denominado lambda_function.rb. Puede editar este archivo y agregar más archivos en el editor de código integrado. Para guardar los cambios, elija Save. A continuación, para ejecutar el código, elija Test (Probar).

nota

La consola de Lambda utiliza AWS Cloud9 para proporcionar un entorno de desarrollo integrado en el navegador. También puede utilizar AWS Cloud9 para desarrollar funciones Lambda en su propio entorno. Para más información, consulte Trabajar con funciones de AWS Lambda en la Guía del usuario de AWS Cloud9.

El archivo lambda_function.rb exporta una función denominada lambda_handler que toma un objeto de evento y un objeto context. Esta es la función de controlador a la que llama Lambda cuando se invoca la función. El tiempo de ejecución de la función de Ruby obtiene los eventos de invocación de Lambda y se los pasa al controlador. En la configuración de función, el valor de controlador es lambda_function.lambda_handler.

Cada vez que guarde el código de la función, la consola de Lambda crea un paquete de implementación, que es un archivo ZIP que contiene el código de su función. A medida que avanza su función de desarrollo, querrá almacenar su código de función en el control del código fuente, agregar bibliotecas y automatizar las implementaciones. Comience creando un paquete de implementación y actualizando el código en la línea de comandos.

nota

Para comenzar con el desarrollo de aplicaciones en su entorno local, implemente una de las aplicaciones de ejemplo disponibles en el repositorio de GitHub de esta guía.

Aplicaciones de Lambda de ejemplo en Ruby

  • blank-ruby: una función de Ruby que muestra el uso del registro, las variables de entorno, el seguimiento de AWS X-Ray, las pruebas de unidad y el SDK de AWS.

El tiempo de ejecución de la función pasa un objeto context al controlador, además del evento de invocación. El objeto context contiene información adicional acerca de la invocación, la función y el entorno de ejecución. Más información disponible en las variables de entorno.

La función de Lambda incluye un grupo de registros de CloudWatch Logs. El tiempo de ejecución de la función envía detalles sobre cada invocación a CloudWatch Logs. Retransmite cualquier registro que genere la función durante la invocación. Si la función devuelve un error, Lambda formatea el error y se lo devuelve al invocador.