如何在 AWS Lambda 上執行和部署 IronPDF .NET

1. 使用容器範本 (.NET 5) 建立 AWS Lambda 函數

請參閱 AWS 官方文件的第一部分： .NET 5 AWS Lambda 對容器鏡像的支援。

2. 新增套件依賴項

這些相依性是 Chrome 在此 AWS 環境中運作所必需的。

請依照以下說明修改 Docker 檔案：

3. 新增 IronPDF (Linux) NuGet 包

安裝IronPdf.Linux

1. 在解決方案資源管理器中，以滑鼠右鍵按一下"參考"，然後選擇"管理 NuGet 套件"。
2. 選擇"瀏覽"並搜尋IronPdf.Linux 。
3. 選擇軟體包並安裝。

4. 修改 FunctionHandler 程式碼

本範例將從網頁建立 PDF 檔案。https://ironpdf.com/並將其儲存到/tmp目錄。 要查看此 PDF 文件，您必須將其上傳到其他服務，例如 S3。

在 AWS Lambda 上使用 IronPDF 時，需要設定臨時資料夾。 請使用TempFolderPath和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. 增加記憶體和超時時間

IronPDF 需要比 Lambda 的預設值更多的時間和記憶體。 您可以在aws-lambda-tools-defaults.json中進行配置。 請根據您的功能進行調整。 在這個範例中，我們將它設定為 512 (MB) 和 330 (秒)。

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

您也可以使用 Lambda 控制台更新此設定。 請參閱"配置 AWS Lambda 函數"一文以了解更多資訊。

6. 發布

請依照" .NET 5 AWS Lambda 容器鏡像支援"文件後半部的說明發佈和測試您的 Lambda 函數。

7. 試試看！

您可以使用Lambda 控制台或透過 Visual Studio 使用AWS Toolkit for Visual Studio來啟動 Lambda 函數。