IronPDF als Remote-Container ausführen

Vermeiden Sie Probleme bei der Bereitstellung

Es kann eine Herausforderung sein, die Umgebung/den Container so zu konfigurieren, dass alle Abhängigkeiten korrekt enthalten sind. Die Verwendung des IronPDF-Docker-Containers bedeutet, dass IronPDF vorinstalliert ist und garantiert funktioniert, wodurch alle Probleme bei der Bereitstellung und mit Abhängigkeiten vermieden werden.

IronPDF installieren

Fügen Sie das IronPdf.Slim-NuGet-Paket zu Ihrem Projekt hinzu.

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

Hinweis: Die Pakete IronPdf, IronPdf.Linux und IronPdf.MacOs enthalten alle IronPdf.Slim.

Um die Größe Ihrer Anwendung zu reduzieren, empfehlen wir, nur IronPdf.Slim zu installieren. Das Paket IronPdf.Native.Chrome.xxx wird nicht mehr verwendet, daher können Sie es aus Ihrem Projekt entfernen.

Ermitteln Sie die erforderliche Container-Version

Standardmäßig entspricht die IronPDF-Version für Docker der aktuellen Version von IronPDF auf NuGet. Sie können den folgenden Code verwenden, um die Version manuell zu überprüfen:

: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

Einrichtung von IronPDF für Docker-Container

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

Wie konfiguriere ich die Laufzeitparameter von IronPdfEngine?

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

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

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

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

Verbinden Sie sich mit IronPdfEngine

Führen Sie Ihren IronPDF-Code aus; Ihre App kommuniziert jetzt mit der IronPdfEngine in 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")

Verbindungstyp

: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()

: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()

Voraussetzungen

• Laden Sie das IronPdfEngine-Docker-Image herunter. Dies ist im obigen Abschnitt "Einrichten von IronPDF für Docker-Container" zu finden.
• Ein AWS-Konto mit Zugriff auf ECS.

Einrichtung

1. Erstellen Sie einen ECS-Cluster. Befolgen Sie diese Anleitung, um mithilfe der Konsole einen Cluster für die Starttypen "Fargate" und "Extern" zu erstellen.
2. Erstellen Sie eine Aufgabendefinition. Befolgen Sie diese Anleitung zum Erstellen einer Aufgabendefinition über die Konsole.

Empfohlene Einstellungen:

• AWS Fargate
• Es wird mindestens 1 vCPU mit 2 GB RAM empfohlen. Je nach Ihrem Arbeitsaufkommen: Wenn Sie mit PDF-Dateien arbeiten, die mehr als 10 Seiten umfassen, oder wenn Sie Anfragen mit hoher Auslastung haben, wählen Sie bitte ein höheres Kontingent.
• Netzwerkmodus: awsvpc
• Portzuordnungen:

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

• Bild-URI: Verweisen Sie auf eine beliebige IronPdfEngine von uns. Beispiel: "ironsoftwareofficial/IronPdfEngine:2024.1.20" (aus DockerHub)
• AWS-Berechtigungen und Netzwerke müssen Sie selbst organisieren
• Die Aktivierung von Amazon CloudWatch wird empfohlen. (Enable logging)
• Die Startreihenfolge der Container ist erforderlich, wenn Sie Ihren Anwendungscontainer in derselben Aufgabendefinition bereitstellen möchten.

3. Führen Sie eine Aufgabendefinition aus. Sie können eine Aufgabendefinition als Aufgabe oder Dienst ausführen. Befolgen Sie diese Anleitung zum Erstellen eines Dienstes über die Konsole.

Empfohlene Einstellungen:

• Launch-Typ: AWS Fargate
• Öffentliche IP: Für Testzwecke aktiviert und für die Produktion deaktiviert. Sicherheit und AWS-Netzwerke müssen Sie selbst übernehmen.

4. Viel Spaß! IronPdfEngine Docker ist in Ihrer AWS-Umgebung bereit und läuft!

Voraussetzungen

• Laden Sie das IronPdfEngine-Docker-Image herunter. Dies ist im obigen Abschnitt "Einrichten von IronPDF für Docker-Container" zu finden.
• Azure-Konto

Einrichtung

1. Erstellen Sie einen Azure-Container. Befolgen Sie diese Schnellstartanleitung zum Bereitstellen einer Containerinstanz in Azure über das Azure-Portal.

Empfohlene Einstellungen:

• Bildquelle: Andere Registrierungsstelle
• Bild: ironsoftwareofficial/IronPdfEngine:2024.1.20 (von Docker Hub)
• Betriebssystemtyp: Linux
• Größe: Mindestens 1 vCPU und 2 GiB Arbeitsspeicher oder mehr
• Port: TCP-Port 33350

2. Viel Spaß! IronPdfEngine Docker ist in Ihren Azure Container Instances bereit und läuft!

Voraussetzung

• Docker muss installiert sein.

Einrichtung

1. Gehen Sie zu https://gallery.ecr.aws/v1m9w8y1/ironpdfengine
2. Das Image "v1m9w8y1/IronPdfEngine" herunterladen

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

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

Oder die spezifische Version herunterladen (empfohlen)

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

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

3. Starten Sie den IronPdfEngine-Container.

Dieser Befehl erstellt einen Container und führt ihn im Hintergrund auf Port 33350 aus

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

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

Erfahren Sie, wie Sie den IronPDF-Client für die Verwendung von IronPdfEngine konfigurieren, indem Sie zum Abschnitt "Code für die Verwendung von IronPdfEngine aktualisieren" navigieren.

Azure Marketplace

Einrichtung

1. Gehen Sie zu "IronPDF Docker Container" im Azure Marketplace. Klicken Sie auf "Jetzt herunterladen" und "Weiter".
2. Füllen Sie die Felder "Basics", "Cluster Details" und "Application Details" aus, um den Kubernetes-Dienst zu erstellen.
3. Sobald die Bereitstellung abgeschlossen ist, navigieren Sie zur linken Seitenleiste und wählen Sie "Kubernetes-Ressourcen" > "Befehl ausführen". Führen Sie den folgenden Befehl aus:

kubectl get services

kubectl get services

Mit den Informationen zu EXTERNAL-IP und PORT(S) können Sie die IronPdfEngine-Verbindung entsprechend konfigurieren.

:path=/static-assets/pdf/content-code-examples/how-to/pull-run-ironpdfengine-azure-marketplace.cs

using IronPdf;
using IronPdf.GrpcLayer;

IronPdf.License.LicenseKey = "IRONPDF-MYLICENSE-KEY-1EF01";

IronPdfConnectionConfiguration configuration = new IronPdfConnectionConfiguration();
configuration.ConnectionType = IronPdfConnectionType.RemoteServer;
configuration.Host = "http://48.216.143.233";
configuration.Port = 80;
IronPdf.Installation.ConnectToIronPdfHost(configuration);

ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>testing</h1>");
pdf.SaveAs("output.pdf");

Imports IronPdf
Imports IronPdf.GrpcLayer

IronPdf.License.LicenseKey = "IRONPDF-MYLICENSE-KEY-1EF01"

Dim configuration As New IronPdfConnectionConfiguration()
configuration.ConnectionType = IronPdfConnectionType.RemoteServer
configuration.Host = "http://48.216.143.233"
configuration.Port = 80
IronPdf.Installation.ConnectToIronPdfHost(configuration)

Dim renderer As New ChromePdfRenderer()
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>testing</h1>")
pdf.SaveAs("output.pdf")

AWS Marketplace

Voraussetzungen

• Docker muss installiert sein.
• AWS CLI muss installiert und angemeldet sein.

Einrichtung

1. Gehen Sie zu IronPdfEngine auf dem AWS Marketplace. Klicken Sie auf "Weiter zum Abonnieren".

2. Akzeptieren Sie die Bedingungen.

4. Weiter zu "Konfiguration".

5. Laden Sie das Image "IronPdfEngine" herunter. In diesem Schritt wird Ihnen ein Befehl zum Abrufen des IronPdfEngine-Images gezeigt.

Zum Beispiel:

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

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

6. Starten Sie den IronPdfEngine-Container. Dieser Befehl erstellt einen Container und führt ihn im Hintergrund auf Port 33350 aus.

docker run -d -p 33350:33350 000000000000.dkr.ecr.us-east-1.amazonaws.com/iron-software/ironpdfengine:2024.1.15

docker run -d -p 33350:33350 000000000000.dkr.ecr.us-east-1.amazonaws.com/iron-software/ironpdfengine:2024.1.15

Health Check mit gRPC

IronPdfEngine hält sich an das Standard-gRPC-Health-Check-Muster und nutzt dabei die folgende Protokollstruktur.

message HealthCheckRequest {
 string service = 1; // Name of the service to check (e.g., "IronPdfEngine")
}

Da wir nach IronPdfEngine suchen, ersetzen wir den Servicenamen durch IronPdfEngine.

Hier ist ein Beispiel für die Verwendung von JavaScript mit Postman, um eine gRPC-Anfrage an den lokalen IronPdfEngine-Dienst mit der Standardnummer 33350 zu senden.

Wie Sie der Antwort entnehmen können, lautet die Statusantwort SERVING, was darauf hinweist, dass der Dienst verfügbar und in Betrieb ist. Wenn der Container nicht fehlerfrei ist, lautet die Statusantwort NOT_SERVING.

Zustandsprüfung mit Kubernetes-Einrichtung

Bei Kubernetes-Setups können wir Folgendes verwenden, um zu überprüfen, ob der Dienst funktionsfähig ist oder nicht.

 livenessProbe:
          exec:
            command:
            - /bin/grpc_health_probe
            - -addr=:33350
            - -rpc-timeout=5s

 livenessProbe:
          exec:
            command:
            - /bin/grpc_health_probe
            - -addr=:33350
            - -rpc-timeout=5s