Ajouter IronPDF à un conteneur Docker existant

Utilisez les paquets NuGet optimisés pour Linux

Nous recommandons d'utiliser le package NuGet IronPdf.Linux plutôt que le package IronPDF standard afin d'économiser de l'espace disque et d'éviter le téléchargement de ressources au démarrage de votre instance Docker. Ne vous inquiétez pas, cela fonctionne toujours lors du développement sous Windows ou macOS — c'est simplement optimisé pour Linux.

Install-Package IronPdf.Linux

Une autre solution consiste simplement à ajouter IronPdf.Native.Chrome.Linux au package NuGet IronPDF standard.

Install-Package IronPdf.Native.Chrome.Linux

Éviter l'installation automatique des dépendances

De nombreux utilisateurs signalent de meilleurs résultats avec Linux et Docker lorsque LinuxAndDockerDependenciesAutoConfig est défini sur false. En effet, les prérequis sont déjà installés par des gestionnaires de paquets de type apt-get dans vos fichiers 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

Désactiver l'accélération GPU

Les conteneurs Docker sous Linux n'ont souvent pas accès à un GPU. L'accélération GPU est désactivée par défaut. Si vous avez activé ChromeGpuModes.Enabled, nous vous recommandons vivement de le désactiver pour les déploiements 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 avec .NET 10

Ubuntu 24.04 (Noble) utilise des paquets de transition time_t 64 bits, de sorte que certains noms de bibliothèques diffèrent des versions antérieures d'Ubuntu (par exemple, libasound2t64 au lieu 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 avec .NET 8

.NET 8 LTS associé à Ubuntu 24.04 LTS est une combinaison courante en production. Les mêmes noms de bibliothèques de transition vers le 64 bits s'appliquent.

# 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 avec .NET 8

Ubuntu 22 avec .NET 7

Ubuntu 20 avec .NET 6

Ubuntu 20 avec .NET 5

Ubuntu 20 avec .NET 3.1 LTS

Ubuntu 18 avec .NET 3.1 LTS

Debian 12 avec .NET 8

Debian 11 avec .NET 7

Debian 11 avec .NET 6

Debian 11 avec .NET 5

Debian 11 avec .NET 3.1 LTS

Debian 10 avec .NET 5

Debian 10 avec .NET 3.1 LTS

Utilisation d'Alpine Docker avec IronPdfEngine dans .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

Windows Server 2019 .NET 6.0

Les conteneurs Windows préconfigurés incluent toutes les dépendances nécessaires à l'exécution d'IronPDF.

Rendez-vous sur le référentiel Docker pour découvrir d'autres images préconfigurées permettant d'exécuter IronPDF.