IronPDF en Contenedores Windows Server Core

This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPDF necesita fuentes del sistema para renderizar el contenido correctamente. Windows Server Core 2019 y 2022 se envían con casi nada, principalmente solo Lucon, lo cual no es suficiente para una salida PDF adecuada. La solución es instalar las fuentes que necesite, como Arial, directamente en la imagen del contenedor.

Solución

Agregue la fuente al directorio de fuentes del sistema y regístrela para que el renderizador pueda encontrarla. El Dockerfile a continuación copia arial.ttf en su lugar y escribe la entrada de registro correspondiente:

FROM mcr.microsoft.com/dotnet/sdk:8.0-windowsservercore-ltsc2022 as base
USER ContainerAdministrator
WORKDIR C:/

COPY arial.ttf c:/windows/fonts/arial.ttf
RUN powershell.exe -NoProfile -Command New-ItemProperty -Path 'HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Fonts' -Name 'Arial (TrueType)' -PropertyType String -Value arial.ttf

Cada línea gana su lugar:

  • USER ContainerAdministrator: concede el permiso necesario para modificar el registro del sistema e instalar fuentes.
  • COPY arial.ttf c:/windows/fonts/arial.ttf: coloca el archivo de fuente Arial en el directorio de fuentes del sistema.
  • New-ItemProperty: registra Arial para que el sistema lo reconozca y lo pueda usar durante la renderización de PDF.

Repita el par COPY y RUN para cualquier otro tipo de letra del que dependan sus documentos.

PrecauciónEsto no funciona con contenedores Windows Server Nano. Nano Server es una imagen reducida que carece de bibliotecas clave para el renderizado de fuentes y no admite la instalación de fuentes, por lo que IronPDF no puede ejecutarse en él.)}

Curtis Chau
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 ...

Leer más
¿Listo para empezar?
Nuget Descargas 20,296,129 | Versión: 2026.7 recién publicada
Still Scrolling Icon

¿Aún desplazándote?

¿Quieres una prueba rápida? PM > Install-Package IronPdf
ejecutar una muestra Mira cómo tu HTML se convierte en PDF.