Führen Sie IronPDF als Remote-Container aus
Der IronPdfEngine ist ein eigenständiger Dienst, der das Erstellen, Schreiben, Bearbeiten und Lesen von PDFs verwalten kann. IronPDF Docker ist bereit, Docker-Dienste mit kompatiblen Versionen von IronPDF (v2023.2.x und höher) auszuführen. Dies wird Entwicklern helfen, Probleme bei der Bereitstellung von IronPDF zu beseitigen.
Warum es eine gute Idee ist, IronPDF als eigenen Container auszuführen
IronPDF benötigt sowohl Chrome als auch Pdfium-Binärdateien, um zu funktionieren, die sehr groß im Dateiumfang sind (hunderte von MBs). Außerdem müssen mehrere Abhängigkeiten auf dem Rechner installiert sein.
Durch die Verwendung dieser Methode wird Ihr Client nur einen Bruchteil der Größe (in MB) einnehmen.
Vermeiden Sie Probleme bei der Bereitstellung
Es kann schwierig sein, die Umgebung bzw. den Container so zu konfigurieren, dass alle Abhängigkeiten korrekt berücksichtigt werden. Die Verwendung des IronPDF-Docker-Containers bedeutet, dass IronPDF vorinstalliert ist und garantiert funktioniert, so dass alle Probleme mit der Bereitstellung und den Abhängigkeiten vermieden werden.
Versionen
Das IronPDF Docker-Tag basiert auf der Version der IronPdfEngine selbst. Es handelt sich nicht um die gleiche Version wie das IronPDF-Produkt.
Jeder IronPDF-Version ist eine eigene IronPdfEngine-Version zugeordnet. Die Versionsnummer muss mit der IronPDF Docker-Version übereinstimmen.
Zum Beispiel: Für IronPDF for Java Version 2023.2.1 wird IronPdfEngine Version 2023.2.1 benötigt. Sie können keine nicht übereinstimmenden Versionen von IronPdfEngine und IronPDF verwenden.
So verwenden Sie IronPDF Docker
IronPDF installieren
Fügen Sie das Nuget-Paket IronPDF.Slim 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. Paket IronPdf.Native.Chrome.xxx wird nicht mehr verwendet, daher können Sie es aus Ihrem Projekt entfernen.
Erforderliche Container-Version bestimmen
Standardmäßig entspricht die Version von IronPDF für Docker der aktuellen Version von IronPDF in NuGet. Sie können den untenstehenden Code verwenden, um die Version manuell zu überprüfen:
:path=/static-assets/pdf/content-code-examples/how-to/ironpdfengine-docker-version.csstring ironPdfEngineVersion = IronPdf.Installation.IronPdfEngineVersion;Einrichten von IronPDF für Docker-Container
Ohne Docker Compose
Führen Sie den Docker-Container mit der Version aus dem vorherigen Schritt aus.
Docker muss installiert sein.
Einrichtung
Weiter zu https://hub.docker.com/r/ironsoftwareofficial/ironpdfengine
- Das neueste ironsoftwareofficial/ironpdfengine-Image abrufen
docker pull ironsoftwareofficial/ironpdfengineOder laden Sie die spezifische Version herunter (empfohlen)
docker pull ironsoftwareofficial/ironpdfengine:2025.3.6Führen Sie den Container ironsoftwareofficial/ironpdfengine aus.
Mit diesem Befehl wird ein Container erstellt und im Hintergrund mit Port 33350 ausgeführt
docker run -d -p 33350:33350 -e IRONPDF_ENGINE_LICENSE_KEY=MY_LICENSE_KEY ironsoftwareofficial/ironpdfengine:2025.3.6Mit Docker Compose
Der Schlüssel dazu ist die Einrichtung eines Docker-Netzwerks, das es IronPdfEngine und Ihrer Anwendung ermöglicht, sich gegenseitig zu sehen. Setzen Sie 'depends_on', um sicherzustellen, dass IronPdfEngine läuft, bevor Ihre Anwendung startet.
Einrichtung
- Beginnen Sie mit der Erstellung einer
docker-compose.yml-Datei. Richten Sie Ihre Docker Compose-Datei mit der folgenden Vorlage ein:
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"Stellen Sie die Adresse von IronPdfEngine innerhalb Ihrer Anwendung (myconsoleapp) auf "myironpdfengine:33350" ein.
- Docker Compose ausführen
docker compose up --detach --force-recreate --remove-orphans --timestampsMit IronPdfEngine verbinden
Führen Sie Ihren IronPDF-Code aus, Ihre App kommuniziert jetzt mit dem IronPdfEngine in Docker!
:path=/static-assets/pdf/content-code-examples/how-to/ironpdfengine-docker-use.csusing IronPdf;
using IronPdf.GrpcLayer;
// Configure for Docker container
var config = new IronPdfConnectionConfiguration();
config.ConnectionType = IronPdfConnectionType.Docker;
IronPdf.Installation.ConnectToIronPdfHost(config);
// Use IronPDF
ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Hello IronPDF Docker!<h1>");
pdf.SaveAs("ironpdf.pdf");Bereitstellen von IronPdfEngine auf AWS ECS
Voraussetzungen
- Ziehen Sie das IronPdfEngine Docker-Image. Dies befindet sich im Setup IronPDF für Docker Container oben.
- Ein AWS-Konto mit Zugriff auf ECS.
Einrichtung
Erstellen Sie einen ECS-Cluster. Folgen Sie dieser Anleitung zum Erstellen eines Clusters für den Fargate- und externen Starttyp über die Konsole.
Erstellen Sie eine Aufgabendefinition. Folgen Sie dieser Anleitung zum Erstellen einer Task-Definition über die Konsole.
Empfohlene Einstellungen:
- AWS Fargate
- Es wird mindestens 1 vCPU mit 2 GB RAM empfohlen. Wenn Sie mit PDFs arbeiten, die mehr als 10 Seiten enthalten, oder wenn Sie eine hohe Last zu bewältigen haben, wählen Sie bitte eine höhere Stufe aus, je nach Arbeitsbelastung.
- Netzwerkmodus: awsvpc
- Portzuordnungen:
"containerPort": 33350,
"hostPort": 33350,
"protocol": "tcp",
"appProtocol": "grpc"- Bild-URI: auf ein beliebiges IronPdfEngine von uns verweisen. Zum Beispiel, "ironsoftwareofficial/ironpdfengine:2024.1.20" (von DockerHub)
- AWS-Berechtigungen & Netzwerke liegen in Ihrer Verantwortung
- Amazon CloudWatch aktivieren wird empfohlen. (Protokollierung aktivieren)
- Startreihenfolge der Container ist notwendig, wenn Sie Ihren Anwendungskontainer in derselben Aufgabendefinition bereitstellen möchten.
Führen Sie eine Aufgabendefinition aus. Sie können eine Aufgabenbeschreibung als Task oder Service ausführen. Folgen Sie dieser Anleitung zum Erstellen eines Dienstes über die Konsole.
Empfohlene Einstellungen:
- Starttyp: AWS Fargate
- Öffentliche IP: Eingeschaltet für Tests und Ausgeschaltet für die Produktion. Für Sicherheit und AWS-Netzwerke sind Sie selbst verantwortlich.
Viel Spaß! IronPdfEngine Docker läuft und ist in Ihrem AWS aktiv!
Horizontales Skalieren wird nicht unterstützt. Bitte beachten Sie die IronPdfEngine-Beschränkungen für weitere Informationen.)}]
Bereitstellung von IronPdfEngine auf Azure Container-Instanzen
Voraussetzungen
- Ziehen Sie das IronPdfEngine Docker-Image. Dies befindet sich im Setup IronPDF für Docker Container oben.
- Azure-Konto
Einrichtung
Erstellen Sie einen Azure-Container. Folgen Sie dieser Schnellstartanleitung zum Bereitstellen einer Containerinstanz in Azure über das Azure-Portal.
Empfohlene Einstellungen:
- Bildquelle: Andere Registrierung
- Image: ironsoftwareofficial/ironpdfengine:2024.1.20 (von Docker Hub)
- Betriebssystemtyp: Linux
- Größe: Mindestens 1 vCPU und 2 GiB Speicher oder höher
- Port: TCP-Port 33350
Viel Spaß! Der IronPdfEngine Docker läuft und ist in Ihren Azure Container Instances in Betrieb!
Horizontales Skalieren wird nicht unterstützt. Bitte beachten Sie die IronPdfEngine-Beschränkungen für weitere Informationen.)}]
IronPdfEngine in der AWS ECR Public Gallery aufrufen
Voraussetzung
- Docker muss installiert sein.
Einrichtung
- Ziehen Sie das Bild v1m9w8y1/ironpdfengine
docker pull https://gallery.ecr.aws/v1m9w8y1/ironpdfengineOder laden Sie die spezifische Version herunter (empfohlen)
docker pull https://gallery.ecr.aws/v1m9w8y1/ironpdfengine:2023.12.6Führen Sie den Container ironpdfengine aus.
Mit diesem Befehl wird ein Container erstellt und im Hintergrund mit Port 33350 ausgeführt
docker run -d -p 33350:33350 ironsoftwareofficial/ironpdfengineErfahren Sie, wie Sie den IronPdf-Client konfigurieren, um den IronPdfEngine zu nutzen, indem Sie zum Abschnitt "Code aktualisieren, um IronPdfEngine zu verwenden" navigieren.
Holen Sie sich IronPdfEngine aus dem Marketplace
Um Ihnen den Einstieg zu erleichtern, haben wir IronPdfEngine sowohl auf dem Azure- als auch auf dem AWS-Marktplatz eingerichtet.
Azure-Marktplatz
Einrichtung
Gehe zu IronPDF Docker Container im Azure Marketplace. Klicken Sie auf "Get It Now" und "Continue"
Füllen Sie die Felder "Grundlagen", "Cluster-Details" und "Anwendungsdetails" aus, um den Kubernetes-Dienst zu erstellen.
- Sobald die Bereitstellung abgeschlossen ist, gehen Sie in der linken Seitenleiste zu Kubernetes-Ressourcen -> Befehl ausführen. Führen Sie den folgenden Befehl aus:
kubectl get services
Mit den Informationen von 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.csusing 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");AWS Marketplace
Voraussetzungen
- Docker muss installiert sein.
AWS CLI muss installiert und eingeloggt sein.
Einrichtung
Gehen Sie zu IronPdfEngine im AWS-Marktplatz. Klicken Sie auf die Schaltfläche "Weiter zum Abonnieren"
Akzeptieren Sie die Bedingungen.
Weiter zu Confiuguration.
Ziehen Sie das ironpdfengine-Image. Dieser Schritt zeigt Ihnen einen Befehl, um das ironpdfengine-Image zu ziehen.
For Example:
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- Starten Sie den Container ironpdfengine. Mit diesem Befehl wird ein Container erstellt und im Hintergrund mit Port 33350 ausgeführt.
docker run -d -p 33350:33350 000000000000.dkr.ecr.us-east-1.amazonaws.com/iron-software/ironpdfengine:2024.1.15
