Exécuter IronPDF en tant que conteneur distant

Sans Docker Compose

Exécutez le conteneur docker en utilisant la version de l'étape précédente.

• Docker doit être installé.

Configuration

1. Allez sur https://hub.docker.com/r/ironsoftwareofficial/ironpdfengine
2. Téléchargez la dernière image ironsoftwareofficial/ironpdfengine

docker pull ironsoftwareofficial/ironpdfengine

docker pull ironsoftwareofficial/ironpdfengine

Ou téléchargez la version spécifique (recommandé)

docker pull ironsoftwareofficial/ironpdfengine:2025.3.6

docker pull ironsoftwareofficial/ironpdfengine:2025.3.6

3. Exécutez le conteneur ironsoftwareofficial/ironpdfengine.

Cette commande créera un conteneur et l'exécutera en arrière-plan avec le port 33350

docker run -d -p 33350:33350 -e IRONPDF_ENGINE_LICENSE_KEY=MY_LICENSE_KEY ironsoftwareofficial/ironpdfengine:2025.3.6

docker run -d -p 33350:33350 -e IRONPDF_ENGINE_LICENSE_KEY=MY_LICENSE_KEY ironsoftwareofficial/ironpdfengine:2025.3.6

Les paramètres d'exécution peuvent être transmis directement au conteneur sous forme de paires key=value après le nom de l'image. Ces éléments permettent de configurer le comportement du moteur sans reconstruire l'image.

docker run -d -p 33350:33350 ironsoftwareofficial/ironpdfengine:2025.3.6 \
  license_key="YOUR_LICENSE_KEY" \
  enable_debug=true \
  chrome_browser_limit=8

docker run -d -p 33350:33350 ironsoftwareofficial/ironpdfengine:2025.3.6 \
  license_key="YOUR_LICENSE_KEY" \
  enable_debug=true \
  chrome_browser_limit=8

Les paramètres suivants sont disponibles :

La variable d'environnement IRONPDF_ENGINE_LICENSE_KEY peut également être utilisée pour définir la clé de licence via -e ou environment: dans Docker Compose. Les paramètres de ligne de commande ont priorité sur les variables d'environnement lorsque les deux sont définis.

Exemple de traduction :

docker run -d --restart=unless-stopped \
  -p 33350:33350 \
  -e IRONPDF_ENGINE_LICENSE_KEY=MY_KEY \
  ironsoftwareofficial/ironpdfengine \
  chrome_browser_limit=8 skip_shutdown=true

docker run -d --restart=unless-stopped \
  -p 33350:33350 \
  -e IRONPDF_ENGINE_LICENSE_KEY=MY_KEY \
  ironsoftwareofficial/ironpdfengine \
  chrome_browser_limit=8 skip_shutdown=true

Exemple de débogage :

docker run -p 33350:33350 \
  ironsoftwareofficial/ironpdfengine \
  enable_debug=true log_path=/app/logs/engine.log

docker run -p 33350:33350 \
  ironsoftwareofficial/ironpdfengine \
  enable_debug=true log_path=/app/logs/engine.log

Avec Docker Compose

L'essentiel est de configurer un réseau Docker qui permet à IronPDFEngine et à votre application de se voir mutuellement. Définissez 'depends_on' pour vous assurer qu'IronPDFEngine est opérationnel avant le démarrage de votre application.

Configuration

1. Commencez par créer un fichier docker-compose.yml. Configurez votre fichier Docker Compose à l'aide du modèle suivant :

version: '3.6'
services:
  myironpdfengine:
    container_name: ironpdfengine
    image: ironsoftwareofficial/ironpdfengine:latest
    ports:
      - '33350:33350'
    networks:
      - ironpdf-network
  myconsoleapp:
    container_name: myconsoleapp
    build:
      # enter YOUR project directory path here
      context: ./MyConsoleApp/
      # enter YOUR dockerfile name here, relative to project directory
      dockerfile: Dockerfile
    networks:
      - ironpdf-network
    depends_on:
      myironpdfengine:
        condition: service_started
networks:
  ironpdf-network: 
    driver: 'bridge'

1. Définissez l'adresse d'IronPDFEngine dans votre application (myconsoleapp) à "myironpdfengine:33350"
2. Exécutez docker compose

docker compose up --detach --force-recreate --remove-orphans --timestamps

docker compose up --detach --force-recreate --remove-orphans --timestamps

Il existe plusieurs IronPdfConnectionType que vous pouvez attribuer en fonction du type de connexion que vous souhaitez établir.

Voici une liste des propriétés disponibles :

LocalExcutable: Pour se connecter à un "serveur" IronPDFEngine exécutant un exécutable sur votre machine locale, nous utilisons cette option. Un exemple rapide serait une application de facturation WinForm qui génère localement des PDF sans dépendre des services cloud.

Docker: Cette option doit être utilisée lors de la tentative de connexion à un conteneur Docker, soit localement, soit dans le cloud.

RemoteServer: Cette option est utilisée pour IronPDFEngine dans le cloud. Cela se connecte à une instance IronPDFEngine hébergée dans le cloud (par exemple, Docker) via le protocole HTTP ou HTTPS. Notez que, comme cette connexion se fait avec un serveur distant, l'URL complète est requise (y compris le protocole HTTP ou HTTPS).

Custom: Pour un contrôle total et une personnalisation de la connexion, vous pouvez utiliser cette option. Cette option utilise votre Grpc.Core.ChannelBase personnalisé défini plutôt que les autres options définies ci-dessus. Les développeurs peuvent créer un nouveau canal soit en créant un objet Grpc.Core.Channel ou en utilisant Grpc.Net.Client.GrpcChannel.ForAddress(System.String) pour un contrôle complet personnalisé sur le canal gRPC.

.NET Framework avec NetFrameworkChannel

Pour .NET Framework, nous nécessitons une configuration différente car gRPC fonctionne différemment dans les projets .NET Framework. Pour que cette méthode fonctionne, veuillez vous assurer que le paquet NuGet Grpc.Core est installé. Nous utiliserons un canal gRPC personnalisé dérivé de Grpc.Core.ChannelBase pour cette configuration spécifique.

Examinons cet exemple, où nous mettrons en œuvre le canal de connexion pour créer et enregistrer un PDF à l'aide d'IronPDFEngine.

:path=/static-assets/pdf/content-code-examples/how-to/ironpdfengine-docker-use-grpc.cs

using IronPdf;

// This code demonstrates how to use IronPdf with gRPC in a .NET Framework application.

// 1. Configure connection to use local IronPdfEngine executable
var config = IronPdf.GrpcLayer.IronPdfConnectionConfiguration.Executable;

// 2. Connect to the IronPDF host with the executable configuration
IronPdf.Installation.ConnectToIronPdfHost(config);

// 3. Create a PDF renderer instance
ChromePdfRenderer renderer = new ChromePdfRenderer();

// 4. Render HTML string as PDF document
PdfDocument pdf = renderer.RenderHtmlAsPdf("Hello world");

// 5. Save the PDF to disk
pdf.SaveAs("output.pdf");

// 6. Clean up , this is needed to work
pdf.Dispose();

Imports IronPdf

' This code demonstrates how to use IronPdf with gRPC in a .NET Framework application.

' 1. Configure connection to use local IronPdfEngine executable
Dim config = IronPdf.GrpcLayer.IronPdfConnectionConfiguration.Executable

' 2. Connect to the IronPDF host with the executable configuration
IronPdf.Installation.ConnectToIronPdfHost(config)

' 3. Create a PDF renderer instance
Dim renderer As New ChromePdfRenderer()

' 4. Render HTML string as PDF document
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("Hello world")

' 5. Save the PDF to disk
pdf.SaveAs("output.pdf")

' 6. Clean up, this is needed to work
pdf.Dispose()

Méthode alternative avec WithCustomChannel

Une autre méthode consisterait à utiliser la méthode WithCustomChannel fournie par IronPdf.GrpcLayer.

La fonction WithCustomChannel prend deux paramètres : customChannel, qui est votre canal gRPC personnalisé, et metadata. Le paramètre metadata est facultatif et est défini par défaut sur null.

:path=/static-assets/pdf/content-code-examples/how-to/ironpdfengine-docker-use-grpc-alt.cs

using IronPdf;
using IronPdf.GrpcLayer;
using Grpc.Core;

// 1. Create custom gRPC channel (.NET Framework style)
var channel = new Channel("123.456.7.8:80", ChannelCredentials.SecureSsl);

// 2. (Optional) Add metadata headers if needed
var metadata = new Metadata
{
    { "Authorization", "Bearer your_token_here" }
};

// 3. Configure IronPDF with custom channel
var config = IronPdfConnectionConfiguration.WithCustomChannel(channel, metadata);
IronPdf.Installation.ConnectToIronPdfHost(config);

// 4. Generate PDF
var renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("Hello world");

// 5. Save the PDF to disk
pdf.SaveAs("output.pdf");

// 6. Clean up , this is needed to work
pdf.Dispose();

Imports IronPdf
Imports IronPdf.GrpcLayer
Imports Grpc.Core

' 1. Create custom gRPC channel (.NET Framework style)
Dim channel As New Channel("123.456.7.8:80", ChannelCredentials.SecureSsl)

' 2. (Optional) Add metadata headers if needed
Dim metadata As New Metadata From {
    {"Authorization", "Bearer your_token_here"}
}

' 3. Configure IronPDF with custom channel
Dim config As IronPdfConnectionConfiguration = IronPdfConnectionConfiguration.WithCustomChannel(channel, metadata)
IronPdf.Installation.ConnectToIronPdfHost(config)

' 4. Generate PDF
Dim renderer As New ChromePdfRenderer()
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("Hello world")

' 5. Save the PDF to disk
pdf.SaveAs("output.pdf")

' 6. Clean up, this is needed to work
pdf.Dispose()