如何在 Azure 函數上執行和部署 IronPDF .NET

安裝 IronPdf 套件

Azure 函數應用程式有三種不同的環境： Linux 、 Windows和容器。 本文介紹如何在所有三種環境中設定 IronPdf。 其中，建議使用 Azure 函數應用程式容器，因為它提供了一個隔離的環境。 首先，讓我們選擇要安裝的合適軟體包。

安裝 IronPdf.Linux 軟體包

Azure 函數應用程式（Windows）

若要使用標準的IronPDF包，請確保"從包檔案執行"選項未選取。 啟用此選項會將項目部署為 ZIP 文件，這會幹擾 IronPdf 的文件配置。 如果您希望啟用"從套件檔案執行"選項，請安裝IronPdf.Slim套件。

• IronPDF包

Install-Package IronPdf

安裝 IronPdf.Slim 包

選擇正確的 Azure 選項

選擇合適的託管級別

Azure Basic B1是滿足我們最終使用者渲染需求的最低託管等級。 如果您正在建置高吞吐量系統，則可能需要對其進行升級。

注意：如果未選擇應用程式服務計劃類型，IronPdf 可能無法渲染 PDF 文件。

<GenerateRuntimeConfigurationFiles>true</GenerateRuntimeConfigurationFiles>

<GenerateRuntimeConfigurationFiles>true</GenerateRuntimeConfigurationFiles>

{
  "configProperties": {
    "System.Drawing.EnableUnixSupport": true
  }
}

System.AppContext.SetSwitch("System.Drawing.EnableUnixSupport", true);

System.AppContext.SetSwitch("System.Drawing.EnableUnixSupport", true);

Azure 函數程式碼範例

此範例將 HTML 轉換為 PDF，並自動將日誌條目輸出到內建的 Azure 日誌記錄器（請參閱ILogger log ）。

[FunctionName("PrintPdf")]
public static async Task<IActionResult> Run(
    [HttpTrigger(AuthorizationLevel.Anonymous, "get", "post", Route = null)] HttpRequest req,
    ILogger log, ExecutionContext context)
{
    log.LogInformation("Entered PrintPdf API function...");

    // Apply license key
    IronPdf.License.LicenseKey = "IRONPDF-MYLICENSE-KEY-1EF01";

    // Enable logging
    IronPdf.Logging.Logger.LoggingMode = IronPdf.Logging.Logger.LoggingModes.Custom;
    IronPdf.Logging.Logger.CustomLogger = log;

    // Configure IronPdf settings
    IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = true;
    IronPdf.Installation.AutomaticallyDownloadNativeBinaries = true;
    IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;
    IronPdf.Installation.CustomDeploymentDirectory = "/tmp";

    try
    {
        log.LogInformation("About to render PDF...");
        ChromePdfRenderer renderer = new ChromePdfRenderer();
        // Render PDF from a URL
        var pdf = renderer.RenderUrlAsPdf("https://www.google.com/");
        log.LogInformation("Finished rendering PDF...");
        return new FileContentResult(pdf.BinaryData, "application/pdf") { FileDownloadName = "google.pdf" };
    }
    catch (Exception e)
    {
        log.LogError(e, "Error while rendering PDF");
        return new OkObjectResult($"Error while rendering PDF: {e}");
    }
}

[FunctionName("PrintPdf")]
public static async Task<IActionResult> Run(
    [HttpTrigger(AuthorizationLevel.Anonymous, "get", "post", Route = null)] HttpRequest req,
    ILogger log, ExecutionContext context)
{
    log.LogInformation("Entered PrintPdf API function...");

    // Apply license key
    IronPdf.License.LicenseKey = "IRONPDF-MYLICENSE-KEY-1EF01";

    // Enable logging
    IronPdf.Logging.Logger.LoggingMode = IronPdf.Logging.Logger.LoggingModes.Custom;
    IronPdf.Logging.Logger.CustomLogger = log;

    // Configure IronPdf settings
    IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = true;
    IronPdf.Installation.AutomaticallyDownloadNativeBinaries = true;
    IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;
    IronPdf.Installation.CustomDeploymentDirectory = "/tmp";

    try
    {
        log.LogInformation("About to render PDF...");
        ChromePdfRenderer renderer = new ChromePdfRenderer();
        // Render PDF from a URL
        var pdf = renderer.RenderUrlAsPdf("https://www.google.com/");
        log.LogInformation("Finished rendering PDF...");
        return new FileContentResult(pdf.BinaryData, "application/pdf") { FileDownloadName = "google.pdf" };
    }
    catch (Exception e)
    {
        log.LogError(e, "Error while rendering PDF");
        return new OkObjectResult($"Error while rendering PDF: {e}");
    }
}

在 Visual Studio 中使用 Azure 函數範本建立專案可能會產生略有不同的程式碼。 由於這些差異，即使安裝了相同的軟體包，一個專案可能可以運行，而另一個專案可能無法運行。 如果發生這種情況，請將CustomDeploymentDirectory屬性設為"/tmp" 。

已知問題