Añadir IronPDF a un contenedor Docker existente

Utilizar paquetes NuGet optimizados para Linux

Recomendamos usar el paquete IronPdf.Linux de NuGet en lugar del paquete regular IronPDF para ahorrar espacio en disco y evitar que se descarguen activos cuando inicies tu instancia de Docker. No se preocupe, aún funciona al desarrollar en Windows o macOS, solo que está optimizado para Linux.

Install-Package IronPdf.Linux

Otra solución es simplemente añadir IronPdf.Native.Chrome.Linux sobre el paquete regular IronPDF de NuGet.

Install-Package IronPdf.Native.Chrome.Linux

Evite la instalación automática de dependencias

Muchos usuarios informan mejores resultados con Linux y Docker cuando LinuxAndDockerDependenciesAutoConfig está configurado como falso. Esto se debe a que los prerrequisitos ya están instalados por los gestores de paquetes estilo apt-get en sus archivos Docker.

// Disable automatic configuration of Linux and Docker dependencies
IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = false;

// Disable automatic configuration of Linux and Docker dependencies
IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = false;

' Disable automatic configuration of Linux and Docker dependencies
IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = False

Desactivar la aceleración por GPU

A menudo, los contenedores Docker de Linux no tienen acceso a una GPU. La aceleración por GPU está desactivada por defecto. Si ha habilitado ChromeGpuModes.Enabled, le recomendamos encarecidamente que lo deshabilite para los despliegues de Docker:

// Disable GPU acceleration for Docker environments
IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;

// Disable GPU acceleration for Docker environments
IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;

' Disable GPU acceleration for Docker environments
IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled

Ubuntu 24 con .NET 10

Ubuntu 24.04 (Noble) utiliza paquetes de transición de tiempo_t de 64 bits, por lo que algunos nombres de bibliotecas difieren de versiones anteriores de Ubuntu (p. ej., libasound2t64 en lugar de libasound2).

# Build stage
FROM mcr.microsoft.com/dotnet/sdk:10.0-noble AS build
WORKDIR /app
COPY *.csproj .
RUN dotnet restore
COPY . .
RUN dotnet publish -c Release -o /app/publish

# Runtime stage
FROM mcr.microsoft.com/dotnet/aspnet:10.0-noble AS runtime

# Install IronPDF dependencies for Ubuntu 24.04 Noble (64-bit transition libraries)
RUN apt-get update && apt-get install -y \
    libasound2t64 \
    libatk1.0-0t64 \
    libatk-bridge2.0-0t64 \
    libcairo2 \
    libcups2t64 \
    libdbus-1-3 \
    libdrm2 \
    libexpat1 \
    libfontconfig1 \
    libgbm1 \
    libglib2.0-0t64 \
    libgtk-3-0t64 \
    libnspr4 \
    libnss3 \
    libpango-1.0-0 \
    libpangocairo-1.0-0 \
    libx11-6 \
    libxcb1 \
    libxcomposite1 \
    libxdamage1 \
    libxext6 \
    libxfixes3 \
    libxkbcommon0 \
    libxrandr2 \
    fonts-liberation \
    wget \
    && rm -rf /var/lib/apt/lists/*

WORKDIR /app
COPY --from=build /app/publish .
ENTRYPOINT ["dotnet", "YourApp.dll"]

Ubuntu 24 con .NET 8

.NET 8 LTS combinados con Ubuntu 24.04 LTS es una combinación común en producción. Los mismos nombres de biblioteca de transición de 64 bits se aplican.

# Build stage
FROM mcr.microsoft.com/dotnet/sdk:8.0-noble AS build
WORKDIR /app
COPY *.csproj .
RUN dotnet restore
COPY . .
RUN dotnet publish -c Release -o /app/publish

# Runtime stage
FROM mcr.microsoft.com/dotnet/aspnet:8.0-noble AS runtime

# Install IronPDF dependencies for Ubuntu 24.04 Noble (64-bit transition libraries)
RUN apt-get update && apt-get install -y \
    libasound2t64 \
    libatk1.0-0t64 \
    libatk-bridge2.0-0t64 \
    libcairo2 \
    libcups2t64 \
    libdbus-1-3 \
    libdrm2 \
    libexpat1 \
    libfontconfig1 \
    libgbm1 \
    libglib2.0-0t64 \
    libgtk-3-0t64 \
    libnspr4 \
    libnss3 \
    libpango-1.0-0 \
    libpangocairo-1.0-0 \
    libx11-6 \
    libxcb1 \
    libxcomposite1 \
    libxdamage1 \
    libxext6 \
    libxfixes3 \
    libxkbcommon0 \
    libxrandr2 \
    fonts-liberation \
    wget \
    && rm -rf /var/lib/apt/lists/*

WORKDIR /app
COPY --from=build /app/publish .
ENTRYPOINT ["dotnet", "YourApp.dll"]

Ubuntu 22 con .NET 8

Ubuntu 22 con .NET 7

Ubuntu 20 con .NET 6

Ubuntu 20 con .NET 5

Ubuntu 20 con .NET 3.1 LTS

Ubuntu 18 con .NET 3.1 LTS

Debian 12 con .NET 8

Debian 11 con .NET 7

Debian 11 con .NET 6

Debian 11 con .NET 5

Debian 11 con .NET 3.1 LTS

Debian 10 con .NET 5

Debian 10 con .NET 3.1 LTS

Uso de Alpine Docker con IronPDFEngine en .NET 6

# Pull the IronPDF Engine Docker Image
docker pull ironsoftwareofficial/ironpdfengine

# Pull the IronPDF Engine Docker Image
docker pull ironsoftwareofficial/ironpdfengine

# Run the IronPDF Engine Docker container
docker run -d -p 33350:33350 ironsoftwareofficial/ironpdfengine

# Run the IronPDF Engine Docker container
docker run -d -p 33350:33350 ironsoftwareofficial/ironpdfengine

Servidor Windows 2019 .NET 6.0

Los contenedores Windows preconfigurados incluyen todas las dependencias necesarias para ejecutar IronPDF.

Visite el repositorio Docker para explorar otras imágenes preconfiguradas para ejecutar IronPDF.

Servicio Docker de firma de facturas VeriFactu

Los ISV que implementan VeriFactu pueden aislar la lógica de generación de PDF en un contenedor Docker separado alojado en un VPS español. Esta arquitectura ofrece ventajas prácticas:

• Aislamiento del proceso de firma: el contenedor que ejecuta IronPDF para la generación del PDF de factura puede separarse del servicio de firma AEAT, limitando la superficie de exposición.
• Residencia de datos: al desplegar en VPS español con Ubuntu 22 LTS o Debian 11, los datos de las facturas (que incluyen NIF/CIF y datos fiscales) permanecen dentro de España, conforme a la AEPD.
• Escalabilidad de temporada fiscal: Docker Compose permite escalar horizontalmente el servicio de generación de PDFs durante picos de emisión (cierres trimestrales de IVA del SII).

Nota: IronPDF actúa como componente de generación de PDF dentro del software de facturación. La certificación VeriFactu recae sobre el sistema completo, no sobre la biblioteca de PDF de forma aislada.

Consideraciones LOPDGDD para contenedores Docker

Cuando los contenedores procesan documentos PDF con datos personales:

• Configurar IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = false y declarar todas las dependencias en el Dockerfile evita descargas en tiempo de ejecución que podrían atravesar fronteras de datos.
• Usar volúmenes Docker efímeros para /tmp garantiza que los PDFs temporales no persisten tras el ciclo de vida del contenedor.
• Para flujos Facturae con archivos XML adjuntos, la imagen Ubuntu 22 con .NET 8 ofrece la combinación más estable para entornos de producción en VPS español.

Alternativa a iText AGPL en contenedores

Los equipos que evalúan iText para contenedores Docker deben considerar que su licencia AGPL obliga a liberar el código fuente al distribuir el servicio. En contenedores Docker expuestos como microservicios internos o APIs, esta obligación sigue aplicándose. IronPDF ofrece licencia comercial sin cláusula copyleft, simplificando el despliegue en entornos de software propietario de facturación.