Proyecto básico de AWS Lambda - AWS Kit de herramientas con Amazon Q
Creación de un proyecto de Lambda con .NET Core en Visual Studio Revisión de los archivos del proyectoPublicación en LambdaEliminación

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Proyecto básico de AWS Lambda

Puede crear una función de Lambda usando plantillas Microsoft .NET Core, en AWS Toolkit for Visual Studio.

Creación de un proyecto de Lambda con .NET Core en Visual Studio

Puede usar plantillas y esquemas de Lambda Visual Studio para acelerar la inicialización del proyecto. Los esquemas de Lambda contienen funciones escritas previamente que simplifican la creación de una base de proyecto flexible.

nota

El servicio Lambda tiene límites de datos en diferentes tipos de paquetes. Para obtener información detallada sobre los límites de datos, consulte el tema Cuotas de Lambda en la Guía del usuario de Lambda de AWS.

Para crear un proyecto de Lambda en Visual Studio

  1. Desde Visual Studio, expanda el menú Archivo, expanda Nuevo y, a continuación, elija Proyecto.

  2. Desde el cuadro de diálogo Nuevo proyecto, configure los cuadros desplegables Idioma, Plataforma y Tipo de proyecto en "Todo…" e introduzca aws lambda en el campo Buscar. Elija la plantilla Lambda Project (.NET Core - C#) de AWS.

  3. En el campo Nombre, introduzca AWSLambdaSample, especifique la ubicación del archivo y, a continuación, seleccione Crear para proceder.

  4. Desde la página Seleccionar esquema, seleccione el esquema Función vacía, a continuación, elija Finalizar para crear el proyecto de Visual Studio.

Revisión de los archivos del proyecto

Hay dos archivos de proyecto que revisar: aws-lambda-tools-defaults.json y Function.cs.

El siguiente ejemplo muestra el archivo aws-lambda-tools-defaults.json, que se crea automáticamente como parte del proyecto. Puede establecer las opciones de compilación con los campos de este archivo.

nota

Las plantillas de proyecto en Visual Studio contienen muchos campos diferentes. Tenga en cuenta lo siguiente:

  • function-handler: especifica el método que se ejecuta al poner en marcha la función de Lambda

  • Al especificar un valor en el campo del controlador de funciones, ese valor se completa previamente en el asistente de publicación.

  • Pero si cambia el nombre de la función, la clase o el conjunto, también tendrá que actualizar el campo correspondiente en el archivo aws-lambda-tools-defaults.json.

{
  "Information": [
    "This file provides default values for the deployment wizard inside Visual Studio and the AWS Lambda commands added to the .NET Core CLI.",
    "To learn more about the Lambda commands with the .NET Core CLI execute the following command at the command line in the project root directory.",
    "dotnet lambda help",
    "All the command line options for the Lambda command can be specified in this file."
  ],
  "profile": "default",
  "region": "us-west-2",
  "configuration": "Release",
  "function-architecture": "x86_64",
  "function-runtime": "dotnet8",
  "function-memory-size": 512,
  "function-timeout": 30,
  "function-handler": "AWSLambdaSample::AWSLambdaSample.Function::FunctionHandler"
}

Examine el archivo Function.cs. Function.cs define las funciones de C# que se expondrán como funciones de Lambda. Este FunctionHandler es la funcionalidad de Lambda que tiene lugar cuando se ejecuta la función de Lambda. En este proyecto, hay una función definida: FunctionHandler, que llama a ToUpper() en el texto de entrada.

Ahora, el proyecto ya está listo para la publicación en Lambda.

Publicación en Lambda

El procedimiento y la imagen siguientes muestran cómo cargar la función en Lambda mediante AWS Toolkit for Visual Studio.

Página para invocar la función de prueba
Publicar su función en Lambda

  1. Navegue hasta el Explorador de AWS expandiendo Ver y seleccionando Explorador de AWS.

  2. En el Explorador de soluciones, abra el menú contextual del proyecto que desee publicar (haga clic con el botón derecho) y, a continuación, seleccione Publicar en AWS Lambda de para abrir la ventana Cargar función de Lambda.

  3. Desde la ventana Cargar función de Lambda, complete los siguientes campos:

    1. Tipo de paquete: elija Zip. Se creará un archivo ZIP como resultado del proceso de compilación y se cargará en Lambda. Como alternativa, puede elegir Tipo de paquete Image. El tutorial: Creación de imágenes de Docker en un proyecto Lambda básico describe cómo publicar mediante Tipo de paquete Image.

    2. Tiempo de ejecución de Lambda: elija su tiempo de ejecución de Lambda en el menú desplegable.

    3. Arquitectura: seleccione el radial para su arquitectura preferida.

    4. Nombre de la función: seleccione el radial para Crear nueva función y, a continuación, introduzca un nombre para mostrar para la instancia de Lambda. Tanto el Explorador de AWS como las pantallas de Consola de administración de AWS hacen referencia a este nombre.

    5. Controlador: utilice este campo para especificar un controlador de funciones. Por ejemplo: AWSLambdaSample::AWSLambdaSample.Function::FunctionHandler.

    6. (Opcional) Descripción: escriba el texto descriptivo que se mostrará con la instancia, desde la Consola de administración de AWS.

    7. Configuración: elija la configuración que prefiera en el menú desplegable.

    8. Marco: elija el marco que prefiera en el menú desplegable.

    9. Guardar configuración: seleccione esta casilla para guardar la configuración actual aws-lambda-tools-defaults.json como predeterminada para futuras implementaciones.

    10. Seleccione Siguiente para pasar a la ventana de Detalles de funciones avanzadas.

  4. En la ventana Advanced Function Details, complete los siguientes campos:

    1. Nombre del rol: elija un rol asociado a su cuenta. El rol proporciona credenciales temporales para las llamadas a los servicios de AWS realizadas por el código en la función. Si no tiene ningún rol, desplácese hasta encontrar el selector desplegable Nuevo rol basado en la política administrada de AWS y, a continuación, elija AWSLambdaBasicExecutionRole. Este rol tiene permisos de acceso mínimos.

      nota

      Su cuenta debe tener permiso para ejecutar la acción ListPolicies de IAM o, de lo contrario, la lista Role Name (Nombre del rol) estará vacía y no podrá continuar.

    2. (Opcional) Si su función de Lambda obtiene acceso a los recursos de una Amazon VPC, seleccione las subredes y los grupos de seguridad.

    3. (Opcional) Defina las variables de entorno que su función de Lambda necesita. Las claves se cifran automáticamente con la clave de servicio predeterminada gratuita. Si lo prefiere, puede especificar una clave de AWS KMS, aunque tiene un coste asociado. KMS es un servicio administrado que se puede usar para crear y controlar las claves de cifrado que se utilizan para cifrar los datos. Si dispone de una clave de AWS KMS, puede seleccionarla en la lista.

  5. Seleccione Cargar para abrir la ventana de la Función de carga y comenzar el proceso de carga.

    nota

    Se mostrará la página Cargando función mientras la función se carga en AWS. Para mantener abierto el asistente tras la carga y poder ver el informe, desactive Cerrar automáticamente el asistente una vez completado correctamente en la parte inferior del formulario antes de que se complete el proceso de carga.

    Una vez cargada la función, la función de Lambda estará activa. Se abre la página de visualización Función: y aparece la configuración de la nueva función de Lambda.

  6. Desde la pestaña Probar función, introduzca hello lambda! en el campo de entrada de texto y, a continuación, seleccione Invocar para invocar manualmente la función de Lambda. El texto, aparecerá en la pestaña Respuesta, convertido a mayúsculas.

    nota

    Puede volver a abrir Función: acceda en cualquier momento haciendo doble clic en la instancia implementada ubicada en el Explorador de AWS, debajo del nodo AWS Lambda.

    Página para invocar la función de prueba

  7. (Opcional) Para confirmar que ha publicado correctamente la función de Lambda, inicie sesión en la Consola de administración de AWS y, a continuación, seleccione Lambda. La consola muestra todas las funciones de Lambda publicadas, incluida la que acaba de crear.

Eliminación

Si no va a seguir desarrollando con este ejemplo, elimine la función que ha implementado para que no se le facturen los recursos no utilizados de la cuenta.

nota

Lambda monitoriza automáticamente las funciones de Lambda en su nombre, e informa sobre las métricas a través de Amazon CloudWatch. Para monitorizar la función, consulte el tema Solución de problemas y supervisión de funciones de AWS Lambda con Amazon CloudWatch en la Guía de desarrolladores de AWS Lambda.

Para eliminar la función

  1. Desde el Explorador de AWS, expanda el nodo AWS Lambda.

  2. Haga clic con el botón derecho en la instancia implementada y, a continuación, seleccione Eliminar.