1. IronPDF
  2. Los geht's
  3. Hosten und Verwenden von IronPdfEngine in Docker

Führen Sie IronPDF als Remote-Container aus

This article was translated from English: Does it need improvement?
Translated
View the article in English

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 auszuführen(v2023.2.x und höher). 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 zum Betrieb sowohl Chrome- als auch Pdfium-Binärdateien, die eine enorme Dateigröße aufweisen(hunderte von MBs). Außerdem müssen mehrere Abhängigkeiten auf dem Rechner installiert sein.

Mit dieser Methode benötigt Ihr Client nur einen Bruchteil der Größe(in MB).

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 ist IronPdfEngine Version 2023.2.1 erforderlich. Sie können keine falsch abgestimmten IronPdfEngine- und IronPDF-Versionen verwenden.

So verwenden Sie IronPDF Docker

Schritt 1 - IronPDF installieren

Fügen Sie das Nuget-Paket IronPDF.Slim zu Ihrem Projekt hinzu.

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

Mehr Informationen:https://ironpdf.com/docs/

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, Sie können es also aus Ihrem Projekt entfernen.

Schritt 2 - Erforderliche Container-Version bestimmen

Standardmäßig entspricht die Version von IronPDF für Docker der aktuellen Version von IronPDF in NuGet.

Zusätzlich können Sie die Version manuell ü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
VB   C#

Schritt 3 - IronPDF für Docker-Container einrichten

Schritt 3.i - Ohne Docker Compose

Starten Sie den Docker-Container mit der Version aus dem vorherigen Schritt

Zum Beispiel für IronPDF für Docker Version z.B. 2023.2.1:


docker network create -d bridge --attachable --subnet=172.19.0.0/16 --gateway=172.19.0.1 ironpdf-network

docker run -d -e IRONPDF_ENGINE_LICENSE_KEY=MY_LICENSE_KEY --network=ironpdf-network --ip=172.19.0.2 --name=ironpdfengine --hostname=ironpdfengine -p 33350:33350 ironsoftwareofficial/ironpdfengine:2023.2.1

Port 33350 ist der standardmäßige interne Port von IronPdfEngine

IronPDF für Docker ist jetzt einsatzbereit und läuft!

Schritt 3.ii - Mit Docker Compose

Richten Sie Ihre Docker Compose-Datei nach der folgenden Vorlage ein:

version: "3.3"

services:
  ironpdfengine:
    container_name: ironpdfengine
    image: ironsoftwareofficial/ironpdfengine:latest
    networks:
      ironpdf-network:
        ipv4_address: 172.19.0.2
  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:
        ipv4_address: 172.19.0.3
    depends_on:
      ironpdfengine:
        condition: service_started

networks:
  ironpdf-network:
    driver: bridge
    ipam:
      config:
        - subnet: 172.19.0.0/16
          gateway: 172.19.0.1
YAML

Führen Sie dann den Befehl docker compose wie folgt aus:

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

Schritt 4 - Konfigurieren Sie Ihren IronPDF-Client

Fügen Sie diese Zeile hinzu:

:path=/static-assets/pdf/content-code-examples/how-to/ironpdfengine-docker-configure.cs
using IronPdf.GrpcLayer;

var config = new IronPdfConnectionConfiguration();
config.ConnectionType = IronPdfConnectionType.Docker;
IronPdf.Installation.ConnectToIronPdfHost(config);
Imports IronPdf.GrpcLayer

Private config = New IronPdfConnectionConfiguration()
config.ConnectionType = IronPdfConnectionType.Docker
IronPdf.Installation.ConnectToIronPdfHost(config)
VB   C#

Schritt 5 - Genießen

Führen Sie Ihren IronPDF-Code aus. Ihre Anwendung spricht nun mit der IronPdfEngine in Docker!

Client Test Code

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

var config = new IronPdfConnectionConfiguration();
config.ConnectionType = IronPdfConnectionType.Docker;
IronPdf.Installation.ConnectToIronPdfHost(config);

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

Private config = New IronPdfConnectionConfiguration()
config.ConnectionType = IronPdfConnectionType.Docker
IronPdf.Installation.ConnectToIronPdfHost(config)

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