Ajouter IronPDF à un conteneur Docker existant

Mis à jour:décembre 3, 2025

Translated

View the article in English

IronPDF pour .NET Standard prend désormais en charge Docker, y compris les conteneurs Docker Azure pour Linux et Windows.

Souhaitez-vous déployer IronPDF comme un conteneur Docker séparé à la place ? En savoir plus sur le guide des tutoriels IronPdfEngine.

Pourquoi utiliser Docker sur Azure ?

En plus d'une évolutivité d'entreprise exceptionnelle, les conteneurs Docker sur Azure bénéficient de plus de permissions que les applications Web régulières. Cela permet le rendu des polices SVG car l'accès au système aux graphiques GDI+ est activé.

IronPDF et le guide Linux

Si Docker avec .NET est nouveau pour vous, nous recommandons cet excellent article sur la configuration du débogage Docker et l'intégration avec des projets Visual Studio.

Nous vous recommandons également vivement de lire notre Guide de configuration et de compatibilité IronPDF Linux

Distributions Linux Docker Recommandées

Nous recommandons les derniers systèmes d'exploitation Linux 64 bits ci-dessous pour une "configuration facile" de IronPDF.

Ubuntu 22
Ubuntu 20
Ubuntu 18
Debian 11
Debian 10
CentOS 8
Amazon AWS Linux 2 Lisez le guide de configuration IronPDF AWS Lambda

Nous recommandons d'utiliser les images Docker officielles pour .NET de Microsoft. D'autres distributions Linux sont partiellement supportées, mais peuvent nécessiter une configuration manuelle. Voir notre guide "Configuration manuelle Linux".

Installation de IronPDF Linux Docker

Utiliser les packages NuGet optimisés pour Linux

Nous recommandons d'utiliser le package NuGet IronPDF.Linux au lieu du package IronPDF régulier pour économiser de l'espace disque et éviter le téléchargement d'assets lorsque vous démarrez votre instance Docker. Ne vous inquiétez pas, cela fonctionne toujours lors du développement sous Windows ou macOS - il est juste optimisé pour Linux.

Install-Package IronPdf.Linux

Une autre solution consiste à simplement ajouter IronPDF.Native.Chrome.Linux en plus du package NuGet IronPDF régulier.

Install-Package IronPdf.Native.Chrome.Linux

Éviter l'installation automatique des dépendances

De nombreux utilisateurs rapportent de meilleurs résultats avec Linux & Docker lorsque LinuxAndDockerDependenciesAutoConfig est défini sur false. C'est parce que les prérequis sont déjà installés par les gestionnaires de packages de style 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

$vbLabelText $csharpLabel

Désactiver l'accélération GPU

Les conteneurs Docker 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 fortement 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

$vbLabelText $csharpLabel

Fichiers Docker Ubuntu Linux

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

Fichiers Docker de Debian Linux

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

Fichiers Docker d'Alpine Linux

L'exécution d'IronPDF sur Alpine Linux n'est pas prise en charge. Nous aimerions pouvoir le faire, mais nous ne le pouvons pas. Franchement, nous aimons Alpine et nous espérons que ce projet se poursuivra et se développera. En 2023, Alpine utilise encore des bibliothèques de langage C "musl" périmées qui ne permettent pas aux développeurs de chrome de prendre pleinement en charge cet OS pour l'instant.

Utilisation de Docker Alpine avec IronPdfEngine dans .NET 6

IronPDF fournit une image de conteneur contenant toutes les fonctionnalités d'IronPDF. Cela permet aux projets fonctionnant sur Alpine d'accéder aux fonctionnalités d'IronPD en se connectant au conteneur IronPdfEngine.

Étape 1 : Tirer et exécuter l'image Docker du moteur IronPDF

Exécutez les commandes suivantes dans votre terminal pour tirer et exécuter l'image Docker du moteur IronPDF :

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

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

SHELL

# 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

SHELL

Étape 2 : configuration de l'application console

Créez une nouvelle application console ciblant .NET 6. Installez le package NuGet IronPDF.Slim à l'aide du NuGet Package Manager.

Fichier Docker Windows

Les conteneurs Windows Docker sont de plus en plus populaires sur Azure, car ils offrent des niveaux de performance et d'évolutivité plus élevés et donnent aux développeurs davantage d'autorisations pour configurer les instances.

IronPdf effectuera effectivement un rendu de texte plus attrayant au sein d'un conteneur Docker (Windows ou Linux) sur Azure en raison des niveaux d'accès plus élevés à la bibliothèque graphique et à la carte graphique virtuelle.

L'article "Visual Studio Container Tools for Docker" est un excellent guide de démarrage.

Voici un exemple de fichier Docker de conteneur Windows pour .NET Core 3.1

Windows Server 2019 .NET 6.0

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

Veuillez noterNotez que ces conteneurs ne sont pas destinés à CONSTRUIRE des applications .NET, mais plutôt à les EXÉCUTER.

Visitez le référentiel Docker pour découvrir d'autres images préconfigurées pour l'exécution d'IronPDF.

Questions Fréquemment Posées

Comment puis-je intégrer une bibliothèque .NET pour la génération de PDF dans un conteneur Docker ?

Vous pouvez intégrer IronPDF, une bibliothèque .NET pour la génération de PDF, dans un conteneur Docker en utilisant les images Docker officielles de Microsoft et le package IronPdf.Linux NuGet pour Linux, ou des conteneurs Docker Windows pré-configurés pour les environnements Windows.

Quels sont les avantages d'utiliser des conteneurs Docker pour la manipulation de PDF sur Azure ?

L'utilisation de conteneurs Docker pour la manipulation de PDF sur Azure offre une évolutivité améliorée pour les entreprises et plus de permissions que les WebApps ordinaires. Cette configuration est idéale pour activer des fonctionnalités avancées telles que le rendu de polices SVG via l'accès aux graphiques GDI+.

Quelles distributions Linux sont les plus adaptées pour exécuter une bibliothèque PDF .NET dans Docker ?

Les distributions Linux les plus adaptées pour exécuter IronPDF dans Docker incluent Ubuntu 18/20/22, Debian 10/11, CentOS 8 et Amazon AWS Linux 2, car elles offrent une configuration et une compatibilité simples.

Comment puis-je optimiser les performances d'une bibliothèque PDF .NET dans des conteneurs Docker Linux ?

Pour optimiser les performances, utilisez le package IronPdf.Linux, désactivez l'installation automatique des dépendances et désactivez l'accélération GPU en configurant le IronPdf.Installation.ChromeGpuMode sur IronPdf.Engines.Chrome.ChromeGpuModes.Disabled.

IronPDF peut-il s'exécuter sur Alpine Linux dans un conteneur Docker ?

IronPDF ne prend pas en charge nativement Alpine Linux en raison des bibliothèques 'musl' incompatibles. Pour utiliser IronPDF sur Alpine Linux, envisagez de l'exécuter via un conteneur IronPdfEngine Docker.

Quel est le but d'utiliser des conteneurs Docker pré-configurés pour une bibliothèque .NET ?

Les conteneurs Docker pré-configurés fournissent toutes les dépendances nécessaires pour exécuter IronPDF efficacement, garantissant une haute performance et une évolutivité, particulièrement bénéfiques lors du déploiement sur des plateformes comme Azure.

Comment puis-je configurer une bibliothèque PDF .NET pour des applications .NET dans Docker ?

Vous pouvez configurer IronPDF pour des applications .NET dans Docker en l'intégrant à des conteneurs Docker Linux et Windows, permettant de robustes fonctionnalités PDF au sein d'une architecture de microservices.

Quelles sont les étapes d'installation recommandées pour déployer une bibliothèque .NET dans Docker ?

Les étapes recommandées incluent l'utilisation d'un package optimisé pour Linux comme IronPdf.Linux, la désactivation des installations automatiques de dépendances, et la pré-initialisation de IronPDF pour éviter les délais pendant l'exécution dans les environnements Docker.

Comment configurer une bibliothèque PDF .NET dans un conteneur Docker Windows Server 2019 exécutant .NET 6.0 ?

Configurez une bibliothèque PDF .NET dans un conteneur Docker Windows Server 2019 en utilisant un Dockerfile pré-configuré qui inclut toutes les dépendances et configurations nécessaires pour exécuter IronPDF avec .NET 6.0.

Pourquoi désactiver l'accélération GPU dans une configuration Docker pour une bibliothèque .NET ?

Désactiver l'accélération GPU pour IronPDF dans Docker peut conduire à un déploiement et à des performances plus fluides en évitant les problèmes potentiels liés aux graphiques dans des environnements où les ressources GPU sont limitées.

Curtis Chau

Discutez maintenant avec l'équipe d'ingénierie

Rédacteur technique

Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes ...

Prêt à commencer?

Nuget Téléchargements 16,685,821 | Version : 2025.12 vient de sortir

Voir Licences

Sur cette page