Run IronPDF as a Remote Container

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

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 en utilisant le 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 selon le 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();

IRON VB CONVERTER ERROR developers@ironsoftware.com

Méthode alternative avec WithCustomChannel

Une méthode alternative serait d'utiliser la méthode WithCustomChannel fournie par IronPdf.GrpcLayer.

Le WithCustomChannel prend deux paramètres, le 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();

IRON VB CONVERTER ERROR developers@ironsoftware.com