如何在Azure Function中運行IronPDF for Java
- IronPDF for Java 僅支援 Docker 部署。
- 由於不支援 Zip 部署 IronPDF 在執行期間需要執行二進位文件。
請參考這個微軟官方指南
https://learn.microsoft.com/en-us/azure/azure-functions/functions-create-function-linux-custom-image
- 对于
Choose a programming language
-> 选择
Java```
- 按照指南进行操作,直到您的应用程序启动并运行。
- 添加 IronPDF 依赖项
- 将此添加到您的 pom 中,并使用最新的
```
<dependencies>
<dependency>
<groupId>com.ironsoftware</groupId>
<artifactId>ironpdf</artifactId>
<version>2022.xx.x</version>
</dependency>
<dependency>
<groupId>com.ironsoftware</groupId>
<artifactId>ironpdf-engine-linux-x64</artifactId>
<version>2022.xx.x</version>
</dependency>
</dependencies>
- 注意:運行
IronPDF
於Docker中需要ironpdf-engine-linux
。
添加一個
RenderPdf
函數在
Function.java
中添加一個新函數- 此函數將接收一個URL並返回一個渲染的PDF。
public class Function {
//...
@FunctionName("RenderPdf")
public HttpResponseMessage renderPdf(
@HttpTrigger(
name = "req",
methods = {HttpMethod.GET, HttpMethod.POST},
authLevel = AuthorizationLevel.ANONYMOUS)
HttpRequestMessage<Optional<String>> request,
final ExecutionContext context) {
context.getLogger().info("Java HTTP trigger processed a request. (RenderPdf)");
// Parse query parameter
final String url = request.getQueryParameters().get("url");
if (url == null) {
return request.createResponseBuilder(HttpStatus.BAD_REQUEST).body("Please pass a url on the query string").build();
} else {
context.getLogger().info("IronPDF try to render url: " + url);
PdfDocument pdfDocument = com.ironsoftware.ironpdf.PdfDocument.renderUrlAsPdf(url);
byte [] content = pdfDocument.getBinaryData();
return request.createResponseBuilder(HttpStatus.OK)
.body(content)
.header("Content-Disposition", "attachment; filename=ironpdf_result.pdf")
.build();
}
}
}
更新 Dockerfile
- 添加 IronPDF Linux 所需的軟體包。
例子中的基礎 Docker 映像是
mcr.microsoft.com/azure-functions/java:4-java$JAVA_VERSION-build
,它是Debian 11
因此我們需要將這些軟體包添加到 docker 文件中。
RUN apt update \
&& apt install -y libgdiplus libxkbcommon-x11-0 libc6 libc6-dev libgtk2.0-0 libnss3 libatk-bridge2.0-0 libx11-xcb1 libxcb-dri3-0 libdrm-common libgbm1 libasound2 libxrender1 libfontconfig1 libxshmfence1
RUN apt-get install -y xvfb libva-dev libgdiplus
- 對於其他 Linux 發行版,請參見 /how-to/linux/
重新部署您的功能到 Azure
構建並打包
mvn clean package
構建 Docker 映像,例如
docker build --tag <DOCKER_ID>/azurefunctionsimage:v1.0.0 .
推送 Docker 映像,例如
docker push <DOCKER_ID>/azurefunctionsimage:v1.0.0
- 更新 Azure 功能,例如
az functionapp create --name <APP_NAME> --storage-account <STORAGE_NAME> --resource-group AzureFunctionsContainers-rg --plan myPremiumPlan --deployment-container-image-name <DOCKER_ID>/azurefunctionsimage:v1.0.0
享受 IronPDF
觸發功能於:
https://<APP_NAME>.azurewebsites.net/api/RenderPdf?url=https://www.google.com
- 注意:第一次觸發功能時,由於初始化可能會較慢或失敗,但之後將會正常。