Funciones Serverless en C#: AWS Lambda de la A a la Z — Guía completa

Introducción: Por qué Serverless y C# son la pareja ideal

La arquitectura serverless (o computación sin servidor) es un modelo en el que escribes código sin preocuparte por la gestión de servidores. AWS Lambda es uno de los servicios más populares para ejecutar dicho código. En combinación con C# (.NET), obtienes una herramienta potente, con seguridad de tipos y de alto rendimiento para crear microservicios, manejadores de API y tareas en segundo plano.

En este artículo, recorreremos todo el camino: desde la configuración del entorno hasta el despliegue y monitoreo de tu primera función en C# en AWS Lambda. El material es adecuado tanto para principiantes como para desarrolladores experimentados que deseen sistematizar sus conocimientos.

1. Preparación del entorno y creación del proyecto

1.1 Instalación de herramientas

Para trabajar con C# y AWS Lambda necesitarás:

\n
• .NET SDK (8.0 o 6.0) — descárgalo desde dotnet.microsoft.com;
\n
• AWS CLI — para gestionar recursos desde la terminal;
\n
• Amazon.Lambda.Tools — herramienta global de .NET para el despliegue.
\n

Instala Lambda Tools con un solo comando:

dotnet tool install -g Amazon.Lambda.Tools

1.2 Creación de la plantilla de función

Usa la plantilla integrada para un inicio rápido:

dotnet new lambda.EmptyFunction --name MyFirstLambda --profile default --region us-east-1

Este comando creará un proyecto con el archivo Function.cs y aws-lambda-tools-defaults.json para la configuración del despliegue.

2. Escritura del código de la función Serverless en C#

2.1 Estructura básica de una función Lambda

Cada función Lambda es un método que recibe un objeto de evento y un contexto de ejecución. Veamos un ejemplo sencillo:

using Amazon.Lambda.Core;\nusing Amazon.Lambda.SQSEvents;\n\n[assembly: LambdaSerializer(typeof(Amazon.Lambda.Serialization.SystemTextJson.DefaultLambdaJsonSerializer))]\n\npublic class Function\n{\n    public async Task<string> FunctionHandler(SQSEvent evnt, ILambdaContext context)\n    {\n        context.Logger.LogInformation("Mensajes recibidos: " + evnt.Records.Count);\n        \n        foreach (var record in evnt.Records)\n        {\n            await ProcessMessageAsync(record.Body, context);\n        }\n        \n        return "Procesados " + evnt.Records.Count + " mensajes";\n    }\n\n    private async Task ProcessMessageAsync(string messageBody, ILambdaContext context)\n    {\n        context.Logger.LogInformation("Procesando: " + messageBody);\n        await Task.Delay(100); // Simulación de trabajo\n    }\n}

Observa el atributo LambdaSerializer — indica cómo serializar/deserializar JSON. Para C# se recomienda SystemTextJson.

2.2 Trabajo con diferentes disparadores

AWS Lambda admite múltiples fuentes de eventos. Aquí tienes un ejemplo para una solicitud HTTP a través de API Gateway:

public async Task<APIGatewayProxyResponse> FunctionHandler(APIGatewayProxyRequest request, ILambdaContext context)\n{\n    var name = request.QueryStringParameters?.ContainsKey("name") == true \n        ? request.QueryStringParameters["name"] \n        : "mundo";\n    \n    var responseBody = $"¡Hola, {name}!";\n    \n    return new APIGatewayProxyResponse\n    {\n        StatusCode = 200,\n        Body = responseBody,\n        Headers = new Dictionary<string, string> { { "Content-Type", "text/plain" } }\n    };\n}

Para trabajar con HTTP, necesitarás instalar el paquete Amazon.Lambda.APIGatewayEvents.

3. Despliegue y prueba de la función

3.1 Prueba local

Antes del despliegue, verifica el código localmente con dotnet lambda invoke:

dotnet lambda invoke --payload "{\\"Records\