Cómo ejecutar e implementar IronPDF .NET en AWS Lambda

1. Crear AWS Lambda con una plantilla de contenedor (.NET 5)

Por favor, consulte la primera parte de este documento oficial de AWS: .NET 5 AWS Lambda Support with Container Images.

2. Añadir dependencias de paquetes

Estas dependencias son necesarias para Chrome en este entorno de AWS.

Por favor, modifique el archivo Docker de acuerdo con estas instrucciones:

3. Añadir el paquete IronPDF (Linux) NuGet

Instalar IronPdf.Linux

1. En el Explorador de soluciones, haga clic con el botón derecho en Referencias, Administrar paquetes NuGet.
2. Seleccione Explorar y busque IronPdf.Linux.

4. Modificar el código de FunctionHandler

Este ejemplo creará un archivo PDF desde una página webhttps://ironpdf.com/ y guárdelo en /tmp. Para ver este PDF, debes subirlo a otro servicio como S3.

Es necesario configurar la carpeta temporal cuando se utiliza IronPDF en AWS Lambda. Para ello, utilice las propiedades TempFolderPath y CustomDeploymentDirectory.

public Casing FunctionHandler(string input, ILambdaContext context)
{
    try
    {
        context.Logger.LogLine($"START FunctionHandler RequestId: {context.AwsRequestId} Input: {input}");

        var awsTmpPath = @"/tmp/"; // AWS temporary storage location

        // [Optional] Enable logging for debugging
        // Uncomment these lines if you encounter issues
        // IronPdf.Logging.Logger.EnableDebugging = true;
        // IronPdf.Logging.Logger.LogFilePath = awsTmpPath;
        // IronPdf.Logging.Logger.LoggingMode = IronPdf.Logging.Logger.LoggingModes.All;

        // Set your IronPDF license key
        IronPdf.License.LicenseKey = "YOUR_LICENSE_KEY";

        // Disable GPU for Chrome rendering in headless environments
        IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;

        // Configure IronPDF to use the AWS temporary directory
        IronPdf.Installation.TempFolderPath = awsTmpPath;
        IronPdf.Installation.CustomDeploymentDirectory = awsTmpPath;

        // Automatically configure Linux and Docker dependencies
        IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = true;

        context.Logger.LogLine($"Creating IronPdf.ChromePdfRenderer");
        var Renderer = new IronPdf.ChromePdfRenderer();

        context.Logger.LogLine($"Rendering PDF");
        using var pdfDoc = Renderer.RenderUrlAsPdf("https://ironpdf.com/");

        var guid = Guid.NewGuid();
        var fileName = $"/tmp/{input}_{guid}.pdf"; // Save file to /tmp

        context.Logger.LogLine($"Saving PDF with name: {fileName}");
        pdfDoc.SaveAs(fileName);

        // Place for future code to upload the PDF file to a service like AWS S3.

        context.Logger.LogLine($"COMPLETE!");
    }
    catch (Exception e)
    {
        context.Logger.LogLine($"[ERROR] FunctionHandler : {e.Message}");
    }

    return new Casing(input?.ToLower(), input?.ToUpper());
}

public Casing FunctionHandler(string input, ILambdaContext context)
{
    try
    {
        context.Logger.LogLine($"START FunctionHandler RequestId: {context.AwsRequestId} Input: {input}");

        var awsTmpPath = @"/tmp/"; // AWS temporary storage location

        // [Optional] Enable logging for debugging
        // Uncomment these lines if you encounter issues
        // IronPdf.Logging.Logger.EnableDebugging = true;
        // IronPdf.Logging.Logger.LogFilePath = awsTmpPath;
        // IronPdf.Logging.Logger.LoggingMode = IronPdf.Logging.Logger.LoggingModes.All;

        // Set your IronPDF license key
        IronPdf.License.LicenseKey = "YOUR_LICENSE_KEY";

        // Disable GPU for Chrome rendering in headless environments
        IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;

        // Configure IronPDF to use the AWS temporary directory
        IronPdf.Installation.TempFolderPath = awsTmpPath;
        IronPdf.Installation.CustomDeploymentDirectory = awsTmpPath;

        // Automatically configure Linux and Docker dependencies
        IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = true;

        context.Logger.LogLine($"Creating IronPdf.ChromePdfRenderer");
        var Renderer = new IronPdf.ChromePdfRenderer();

        context.Logger.LogLine($"Rendering PDF");
        using var pdfDoc = Renderer.RenderUrlAsPdf("https://ironpdf.com/");

        var guid = Guid.NewGuid();
        var fileName = $"/tmp/{input}_{guid}.pdf"; // Save file to /tmp

        context.Logger.LogLine($"Saving PDF with name: {fileName}");
        pdfDoc.SaveAs(fileName);

        // Place for future code to upload the PDF file to a service like AWS S3.

        context.Logger.LogLine($"COMPLETE!");
    }
    catch (Exception e)
    {
        context.Logger.LogLine($"[ERROR] FunctionHandler : {e.Message}");
    }

    return new Casing(input?.ToLower(), input?.ToUpper());
}

5. Aumentar la memoria y el tiempo de espera

IronPDF requiere más tiempo y memoria que el valor predeterminado de Lambda. Puedes configurarlo en aws-lambda-tools-defaults.json. Por favor, ajústelo a su función. En este ejemplo, lo fijaremos en 512 (MB) y 330 (segundos).

{
    "function-memory-size": 512,
    "function-timeout": 330
}

También puede actualizar esta configuración mediante la consola de Lambda. Vaya al artículo Configuración de las funciones de AWS Lambda para obtener más información.

6. Publicar

Por favor, siga las instrucciones de la última parte del documento '.NET 5 AWS Lambda Support with Container Images' para publicar y probar su función Lambda.

7. ¡Pruébalo!

Puede activar la función Lambda utilizando la consola Lambda o a través de Visual Studio utilizando el AWS Toolkit for Visual Studio.