Cómo ejecutar IronPDF for Java en una función de Azure

Curtis Chau

Actualizado:25 de enero de 2026

Translated

View the article in English

IronPDF para Java solo admite la implementación de Docker.
No se admite la implementación Zip, ya que IronPDF requiere la ejecución de binarios en tiempo de ejecución.

Sigue la Guía Oficial de Microsoft para Crear Funciones en Linux Usando Imágenes Personalizadas
- Para Choose a programming language -> seleccione Java
- Sigue la guía hasta que tu aplicación esté funcionando.

Añade la dependencia de IronPDF

Agrega esto a tu pom con el último <version>:

<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>

<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>

XML

Nota: ironpdf-engine-linux-x64 es necesario para ejecutar IronPDF en Docker.

Agregue una función RenderPdf

Agregar una nueva función en Function.java
Esta función recibirá una URL y devolverá un PDF renderizado.

import com.microsoft.azure.functions.*;
import com.ironsoftware.ironpdf.PdfDocument;
import java.util.Optional;

public class Function {

    /**
     * Azure function to render a URL as a PDF and return it.
     * Triggered by an HTTP request with a URL query string parameter.
     */
    @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 for the URL
        final String url = request.getQueryParameters().get("url");

        // Check if the URL parameter is provided
        if (url == null) {
            return request.createResponseBuilder(HttpStatus.BAD_REQUEST)
                    .body("Please pass a url on the query string")
                    .build();
        } else {
            try {
                context.getLogger().info("IronPDF is attempting to render the URL: " + url);

                // Render the given URL as a PDF
                PdfDocument pdfDocument = PdfDocument.renderUrlAsPdf(url);

                // Convert the PDF document to binary data
                byte[] content = pdfDocument.getBinaryData();

                // Return the PDF as an attachment in the response
                return request.createResponseBuilder(HttpStatus.OK)
                        .body(content)
                        .header("Content-Disposition", "attachment; filename=ironpdf_result.pdf")
                        .build();
            } catch (Exception e) {
                context.getLogger().severe("Failed to render PDF: " + e.getMessage());
                return request.createResponseBuilder(HttpStatus.INTERNAL_SERVER_ERROR)
                        .body("An error occurred while rendering the PDF.")
                        .build();
            }
        }
    }
}

import com.microsoft.azure.functions.*;
import com.ironsoftware.ironpdf.PdfDocument;
import java.util.Optional;

public class Function {

    /**
     * Azure function to render a URL as a PDF and return it.
     * Triggered by an HTTP request with a URL query string parameter.
     */
    @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 for the URL
        final String url = request.getQueryParameters().get("url");

        // Check if the URL parameter is provided
        if (url == null) {
            return request.createResponseBuilder(HttpStatus.BAD_REQUEST)
                    .body("Please pass a url on the query string")
                    .build();
        } else {
            try {
                context.getLogger().info("IronPDF is attempting to render the URL: " + url);

                // Render the given URL as a PDF
                PdfDocument pdfDocument = PdfDocument.renderUrlAsPdf(url);

                // Convert the PDF document to binary data
                byte[] content = pdfDocument.getBinaryData();

                // Return the PDF as an attachment in the response
                return request.createResponseBuilder(HttpStatus.OK)
                        .body(content)
                        .header("Content-Disposition", "attachment; filename=ironpdf_result.pdf")
                        .build();
            } catch (Exception e) {
                context.getLogger().severe("Failed to render PDF: " + e.getMessage());
                return request.createResponseBuilder(HttpStatus.INTERNAL_SERVER_ERROR)
                        .body("An error occurred while rendering the PDF.")
                        .build();
            }
        }
    }
}

JAVA

Actualiza Dockerfile
- Añade los paquetes requeridos de IronPDF para Linux. En el ejemplo, la imagen base de Docker es mcr.microsoft.com/azure-functions/java:4-java$JAVA_VERSION-build, que se basa en Debian 11. Por lo tanto, necesitamos agregar estos paquetes al Dockerfile.
```
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
```
- Para otras distribuciones de Linux, consulte Guía de instalación de Linux de IronPDF

Vuelve a desplegar tu función en Azure

Construir y empaquetar: mvn clean package
Construya la imagen de Docker: docker build --tag <DOCKER_ID>/azurefunctionsimage:v1.0.0 .
Insertar imagen de Docker: docker push <DOCKER_ID>/azurefunctionsimage:v1.0.0

Actualiza la función de 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

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

SHELL

Disfruta de IronPDF
- Función de activación en: https://<APP_NAME>.azurewebsites.net/api/RenderPdf?url=https://www.google.com
- Nota: La primera vez que se dispare la función puede ser lenta o fallar debido a la inicialización, pero después debería funcionar de manera consistente.

Preguntas Frecuentes

¿Cómo puedo crear un generador de PDF en Java usando Azure Functions?

Puedes crear un generador de PDF en Java usando Azure Functions desplegando IronPDF a través de Docker. Esto implica usar la librería IronPDF para manejar las tareas de generación de PDF dentro de un entorno de función de Azure.

¿Por qué es necesario el despliegue con Docker para IronPDF en Azure Functions?

El despliegue con Docker es necesario para IronPDF en Azure Functions porque requiere ejecutar binarios en tiempo de ejecución, lo cual no es soportado por los métodos de despliegue Zip.

¿Cuáles son los pasos para añadir dependencias de IronPDF a un proyecto Maven?

Para añadir dependencias de IronPDF a un proyecto Maven, incluye las bibliotecas de IronPDF y 'ironpdf-engine-linux-x64' en el archivo 'pom.xml'. Asegúrate de usar los números de versión más recientes para garantizar la compatibilidad.

¿Cómo funciona la función RenderPdf en una función de Azure?

La función RenderPdf en una función de Azure lee una URL de una solicitud HTTP, utiliza el método 'PdfDocument.renderUrlAsPdf' de IronPDF para renderizar la URL como un PDF, y devuelve el PDF como un adjunto en la respuesta.

¿Qué paquetes de Linux son necesarios en el Dockerfile para IronPDF?

El Dockerfile para IronPDF debe incluir paquetes de Linux como 'libgdiplus', 'libxkbcommon-x11-0', 'libc6' y 'libgtk2.0-0' para asegurar el funcionamiento correcto dentro de una imagen basada en Debian.

¿Qué puedo esperar la primera vez que active la función de generación de PDF?

La primera vez que actives la función de generación de PDF, puede ser lenta o fallar debido a los procesos de inicialización. Las ejecuciones posteriores deben ser más consistentes.

¿Cómo puedo desplegar una imagen Docker para una función de Azure?

Para desplegar una imagen Docker para una función de Azure, construye tu proyecto con 'mvn clean package', crea la imagen Docker, súbela a un registro Docker, y actualiza la función de Azure para usar esta nueva imagen.

¿Cuál es el formato de URL correcto para activar una función de generación de PDF en Azure?

Para activar la función de generación de PDF, usa el formato de URL: 'https://.azurewebsites.net/api/RenderPdf?url='.

¿Dónde puedo encontrar recursos para configurar una función de Azure con una imagen Docker personalizada?

Para configurar una función de Azure con una imagen Docker personalizada, puedes referirte a la Guía Oficial de Microsoft para Crear una Función de Azure en Linux Usando una Imagen Personalizada.

Curtis Chau

Chatea con el equipo de ingeniería ahora

Escritor Técnico

Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien ...

¿Listo para empezar?

Versión: 2026.4 recién lanzado