Wie man IronPdfEngine zieht und betreibt

Chaknith Bin
Chaknith Bin
18. Februar 2024
Aktualisiert 10. Dezember 2024
Teilen Sie:
This article was translated from English: Does it need improvement?
Translated
View the article in English

Das Ziehen und Ausführen eines IronPdfEngine-Images beinhaltet das Abrufen des vorgefertigten Container-Images von Dockerhub, AWS ECR Public Gallery oder AWS Marketplace und das anschließende Ausführen in einer Docker-Umgebung.

Ziehen: Dies bezieht sich auf das Abrufen des IronPdfEngine-Container-Images aus der angegebenen Registry(Dockerhub, AWS ECR Public Gallery oder AWS Marketplace) auf Ihr lokales System. Der Befehl docker pull wird in der Regel für diesen Zweck verwendet.

Ausführen: Sobald das Image gezogen wurde, verwenden Sie den Befehl docker run, um eine auf diesem Image basierende Container-Instanz zu starten. Dadurch wird die IronPdfEngine-Anwendung in einem Docker-Container gestartet, so dass Sie ihre Funktionen nutzen können.

Erste Schritte mit IronPDF

Beginnen Sie noch heute mit der Verwendung von IronPDF in Ihrem Projekt mit einer kostenlosen Testversion.

Erster Schritt:
green arrow pointer


IronPdfEngine in Dockerhub beziehen

Voraussetzung

  • Docker muss installiert sein.

Einrichtung

  1. Weiter zu https://hub.docker.com/r/ironsoftwareofficial/ironpdfengine

  2. Ziehen Sie das Bild ironsoftwareofficial/ironpdfengine
  docker pull ironsoftwareofficial/ironpdfengine

Oder ziehen Sie die spezifische Version(empfohlen)

  docker pull ironsoftwareofficial/ironpdfengine:2023.12.6
  1. Führen Sie den Container ironsoftwareofficial/ironpdfengine aus.

    Dieser Befehl wird einen Container erstellen und im Hintergrund mit Port 33350 ausführen.

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

Erfahren Sie, wie Sie den IronPDF-Client für die Nutzung von IronPdfEngine konfigurieren können, indem Sie zum Abschnitt "Aktualisieren des Codes zur Verwendung von IronPdfEngine."


IronPdfEngine innerhalb von 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

  1. Beginnen Sie mit der Erstellung einer Datei "docker-compose.yml". Richten Sie Ihre Docker-Compose-Datei nach 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"
  1. Legen Sie die Adresse der IronPdfEngine innerhalb Ihrer Anwendung fest(myconsoleapp) auf "myironpdfengine:33350"

  2. Docker Compose ausführen
docker compose up --detach --force-recreate --remove-orphans --timestamps

Voraussetzung

  • Docker muss installiert sein.

Einrichtung

  1. Weiter zu https://gallery.ecr.aws/v1m9w8y1/ironpdfengine

  2. Ziehen Sie das Bild v1m9w8y1/ironpdfengine
docker pull https://gallery.ecr.aws/v1m9w8y1/ironpdfengine

Oder ziehen Sie die spezifische Version(empfohlen)

docker pull https://gallery.ecr.aws/v1m9w8y1/ironpdfengine:2023.12.6
  1. Fü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/ironpdfengine

Erfahren Sie, wie Sie den IronPDF-Client für die Nutzung von IronPdfEngine konfigurieren können, indem Sie zum Abschnitt "Aktualisieren des Codes zur Verwendung von IronPdfEngine."


IronPdfEngine im AWS Marketplace beziehen

aws-Marktplatz

Voraussetzungen

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

Einrichtung

  1. Gehe zuIronPdfEngine auf dem AWS-Marktplatz. Klicken Sie auf die Schaltfläche "Weiter zum Abonnieren"

  2. Akzeptieren Sie die Bedingungen.

    EULA akzeptieren
  3. Weiter zu Confiuguration.

    Vollständig abonnieren
  4. Ziehen Sie das ironpdfengine-Image. Dieser Schritt zeigt Ihnen einen Befehl, um das ironpdfengine-Image zu ziehen.
    Starten Sie diese Software

    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
  1. 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

IronPdfEngine im Azure Marketplace beziehen

Azure-Marktplatz

Einrichtung

  1. Gehe zuIronPDF Docker-Container auf dem Azure-Marktplatz. Klicken Sie auf "Get It Now" und "Continue"

  2. Füllen Sie die Felder "Grundlagen", "Cluster-Details" und "Anwendungsdetails" aus, um den Kubernetes-Dienst zu erstellen.

  3. 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
Kubernetes-Dienst - Befehl ausführen

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.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");

Aktualisieren des Codes zur Verwendung von IronPdfEngine

Dazu muss der Code geändert werden, um sicherzustellen, dass IronPDF auf den richtigen Port verweist, der von IronPdfEngine bereitgestellt wird. Dieser Vorgang ist für jede Programmiersprache leicht unterschiedlich. Spezifische Hinweise zur Verwendung finden Sie in den folgenden Artikeln:

Chaknith Bin
Software-Ingenieur
Chaknith arbeitet an IronXL und IronBarcode. Er hat tiefgehende Expertise in C# und .NET und hilft, die Software zu verbessern und Kunden zu unterstützen. Seine Erkenntnisse aus Benutzerinteraktionen tragen zu besseren Produkten, Dokumentation und einem insgesamt besseren Erlebnis bei.