Exécuter IronPDF en tant que conteneur distant

Éviter les problèmes de déploiement

Il peut être difficile de configurer correctement l'environnement/conteneur pour inclure toutes les dépendances. Utiliser le conteneur Docker IronPDF signifie que IronPDF est pré-installé et garanti pour fonctionner, évitant ainsi tous les tracas de déploiement et de dépendance.

Installer IronPDF

Ajoutez le paquet Nuget IronPdf.Slim à votre projet.

https://www.nuget.org/packages/IronPdf.Slim/

Remarque: les paquets IronPdf, IronPdf.Linux et IronPdf.MacOs contiennent tous IronPdf.Slim.

Pour réduire la taille de votre application, nous vous recommandons d'installer uniquement IronPdf.Slim. Le paquet IronPdf.Native.Chrome.xxx n'est plus utilisé, vous pouvez donc le supprimer de votre projet.

Déterminer la version requise du conteneur

Par défaut, la version d'IronPDF pour le Docker correspondra à la version actuelle d'IronPDF sur NuGet. Vous pouvez utiliser le code ci-dessous pour vérifier la version manuellement :

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

string ironPdfEngineVersion = IronPdf.Installation.IronPdfEngineVersion;

Dim ironPdfEngineVersion As String = IronPdf.Installation.IronPdfEngineVersion

Configurer IronPDF pour le conteneur Docker

docker pull ironsoftwareofficial/ironpdfengine

docker pull ironsoftwareofficial/ironpdfengine

docker pull ironsoftwareofficial/ironpdfengine:2025.3.6

docker pull ironsoftwareofficial/ironpdfengine:2025.3.6

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

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'

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

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

Connecter à IronPdfEngine

Exécutez votre code IronPDF; votre application communique maintenant avec IronPdfEngine dans Docker!

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

using IronPdf;
using IronPdf.GrpcLayer;

// Configure for Docker container
var config = IronPdfConnectionConfiguration.Docker;
config.Host = "localhost";
IronPdf.Installation.ConnectToIronPdfHost(config);

// Use IronPDF
ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Hello IronPDF Docker!<h1>");
pdf.SaveAs("ironpdf.pdf");

Imports IronPdf
Imports IronPdf.GrpcLayer

' Configure for Docker container
Private config = IronPdfConnectionConfiguration.Docker
config.Host = "localhost"
IronPdf.Installation.ConnectToIronPdfHost(config)

' Use IronPDF
Dim renderer As New ChromePdfRenderer()
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Hello IronPDF Docker!<h1>")
pdf.SaveAs("ironpdf.pdf")

Type de connexion

: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

: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

Prérequis

• Téléchargez l'image Docker IronPdfEngine. Cela se trouve dans la section Configuration d'IronPDF pour le conteneur Docker ci-dessus.
• Un compte AWS avec accès à ECS.

Configuration

1. Créez un cluster ECS. Suivez ce guide pour créer un cluster pour les types de lancement Fargate et Externe en utilisant la console.
2. Créez une définition de tâche. Suivez ce guide pour créer une définition de tâche en utilisant la console.

Paramètres recommandés :

• AWS Fargate
• Un minimum de 1 vCPU avec 2 Go de RAM est recommandé. Selon votre charge de travail, si vous travaillez avec des PDF contenant plus de 10 pages ou si vous rencontrez des demandes de charge importantes, sélectionnez un niveau supérieur.
• Mode réseau : awsvpc
• Mappages de ports:

  {
    "containerPort": 33350,
    "hostPort": 33350,
    "protocol": "tcp",
    "appProtocol": "grpc"
  }

• URI de l'image: pointez vers n'importe quel IronPdfEngine de chez nous. Par exemple, " ironsoftwareofficial/ironpdfengine:2024.1.20 " (de DockerHub)
• Autorisation AWS et Réseautage sont à votre charge
• Activer Amazon CloudWatch est recommandé. (Enable logging)
• Ordre de démarrage des conteneurs est nécessaire si vous souhaitez déployer votre conteneur d'application dans la même définition de tâche.

3. Exécutez une définition de tâche. Vous pouvez exécuter une définition de tâche en tant que Tâche ou Service. Suivez ce guide sur la création d'un service en utilisant la console.

Paramètres recommandés :

• Type de lancement : AWS Fargate
• IP publique : Activée pour les tests et Désactivée pour la production. La sécurité et le réseau AWS sont à votre charge.

4. Profitez-en ! IronPdfEngine docker est opérationnel dans votre AWS !

Prérequis

• Téléchargez l'image Docker IronPdfEngine. Cela se trouve dans la section Configuration d'IronPDF pour le conteneur Docker ci-dessus.
• Compte Azure

Configuration

1. Créez un conteneur Azure. Suivez ce guide de démarrage rapide sur le déploiement d'une instance de conteneur dans Azure à l'aide du portail Azure.

Paramètres recommandés :

• Image : ironsoftwareofficial/ironpdfengine:2024.1.20 (de Docker Hub)
• Type de système d'exploitation : Linux
• OS type : Linux
• Taille: Minimum de 1 vCPU et 2 GiB de mémoire, ou plus
  2. Profitez-en!

Le docker IronPdfEngine est opérationnel dans vos instances de conteneurs Azure! IronPdfEngine docker est en marche dans vos instances de conteneurs Azure !

Prérequis

1. Allez sur https://gallery.ecr.aws/v1m9w8y1/ironpdfengine

• Docker doit être installé.

Configuration

1. Allez sur https://gallery.ecr.aws/v1m9w8y1/ironpdfengine
2. Récupérez l'image v1m9w8y1/ironpdfengine

docker pull https://gallery.ecr.aws/v1m9w8y1/ironpdfengine

docker pull https://gallery.ecr.aws/v1m9w8y1/ironpdfengine

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

docker pull https://gallery.ecr.aws/v1m9w8y1/ironpdfengine:2023.12.6

docker pull https://gallery.ecr.aws/v1m9w8y1/ironpdfengine:2023.12.6

3. Exécutez le conteneur 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 ironsoftwareofficial/ironpdfengine

docker run -d -p 33350:33350 ironsoftwareofficial/ironpdfengine

D\u00e9couvrez comment configurer le client IronPDF pour utiliser IronPdfEngine en naviguant vers la section "Mettre \u00e0 jour le code pour utiliser IronPdfEngine."

Obtenez IronPdfEngine sur le Marketplace<\/h2> Pour vous aider \u00e0 d\u00e9marrer rapidement, nous avons install\u00e9 IronPdfEngine \u00e0 la fois sur les march\u00e9s Azure et AWS. ### Marché Azure

**Setup** 1. Allez sur [IronPDF Docker Container sur Azure Marketplace](https://azuremarketplace.microsoft.com/en-us/marketplace/apps/ironsoftwarecoltd1682560478296.ironpdf-docker-container-v1?tab=Overview). Cliquez sur "Obtenez-le maintenant" et "Continuer". 3. Une fois le déploiement terminé, naviguez dans la barre latérale gauche et sélectionnez Ressources Kubernetes > Exécuter la commande.

 Exécutez la commande suivante : ```shell kubectl get services ```

Avec les informations d'EXTERNAL-IP et de PORT(S), vous pouvez configurer la connexion IronPdfEngine en cons\u00e9quence. ```csharp :path=/static-assets/pdf/content-code-examples/how-to/pull-run-ironpdfengine-azure-marketplace.cs ```

Marketplace AWS<\/h3>

**Prérequis** * Docker doit être installé. * AWS CLI doit être installé et connecté. **Setup** 1. Allez sur [IronPdfEngine sur le marketplace AWS](https://aws.amazon.com/marketplace/pp/prodview-t66wmni5ri7ve?sr=0-1&ref_=beagle&applicationId=AWSMPContessa). Cliquez sur 'Continuer à s'abonner.' 3. Acceptez les Conditions.


5. Récupérez l'image ironpdfengine.


Par exemple : ```shell aws ecr get-login-password \ --region us-east-1 | docker login \ --username AWS \ --password-stdin 000000000000.dkr.ecr.us-east-1.amazonaws.com CONTAINER_IMAGES="000000000000.dkr.ecr.us-east-1.amazonaws.com/iron-software/ironpdfengine:2024.1.15" for i in $(echo $CONTAINER_IMAGES | sed "s/,/ /g"); do docker pull $i; done ``` Cette commande créera un conteneur et l'exécutera en arrière-plan avec le port 33350. ## Vérification de l'état de santé pour IronPdfEngine ```shell docker run -d -p 33350:33350 000000000000.dkr.ecr.us-east-1.amazonaws.com/iron-software/ironpdfengine:2024.1.15 ``` Vérifier l'état de santé de votre conteneur Docker est crucial pour garantir la fiabilité et la disponibilité dans un environnement de production. La possibilité de vérifier le conteneur Docker de IronPdfEngine permet aux développeurs de redémarrer le service s'il échoue, ainsi que de dimensionner les ressources si la demande augmente, tout en surveillant une application continue. La capacité de vérifier le conteneur Docker IronPdfEngine permet aux développeurs de redémarrer le service s'il échoue, ainsi que de faire évoluer les ressources si la demande augmente, tout en surveillant une application continue. Pour vérifier la santé de votre IronPdfEngine, nous pouvons envoyer une requête gRPC au même port IronPdfEngine (par défaut, il serait 33350) pour vérifier si nous recevons une réponse. ### Vérification de l'état avec gRPC IronPdfEngine respecte le mod\u00e8le de v\u00e9rification de sant\u00e9 gRPC standard, en utilisant la structure de protocole suivante. ```protobuf message HealthCheckRequest { string service = 1; // Name of the service to check (e.g., "IronPdfEngine") } ``` Voici un exemple utilisant JavaScript avec [Postman](https://www.postman.com) pour envoyer une requête gRPC au service local IronPdfEngine avec le nombre par défaut de 33350. Voici un exemple utilisant JavaScript avec [Postman](https://www.postman.com) pour envoyer une requête gRPC au service IronPdfEngine local avec le numéro par défaut de 33350.

Comme vous pouvez le voir dans la réponse, la réponse de statut est `SERVING`, indiquant que le service est opérationnel. Si le conteneur n'est pas sain, la réponse de statut serait `NOT_SERVING`. Pour les configurations Kubernetes, nous pouvons utiliser ce qui suit pour vérifier si le service est sain ou non. ``` yaml ```yaml livenessProbe: exec: command: - /bin/grpc_health_probe - -addr=:33350 - -rpc-timeout=5s ```