Cómo tirar y hacer funcionar IronPdfEngine

La extracción y ejecución de una imagen de IronPdfEngine implica la obtención de la imagen de contenedor preconstruida de Dockerhub, AWS ECR Public Gallery o AWS Marketplace y su posterior ejecución en un entorno Docker.

Extracción: Se refiere a recuperar la imagen del contenedor IronPdfEngine del registro especificado (Dockerhub, Galería pública de AWS ECR o AWS Marketplace) a su sistema local. Para ello se suele utilizar el comando docker pull.

Ejecutar: Una vez extraída la imagen, se utiliza el comando docker run para lanzar una instancia de contenedor basada en esa imagen. Esto inicia la aplicación IronPdfEngine dentro de un contenedor Docker, permitiéndole utilizar su funcionalidad.

Biblioteca NuGet C# para PDF

Instalar con NuGet

Install-Package IronPdf
o
Java PDF JAR

Descargar DLL

Descargar DLL

Instalar manualmente en su proyecto

Obtener IronPdfEngine en Dockerhub

Requisito previo

  • Docker debe estar instalado.

Configurar

  1. Visite https://hub.docker.com/r/ironsoftwareofficial/ironpdfengine
  2. Extraer la imagen ironsoftwareofficial/ironpdfengine
docker pull ironsoftwareofficial/ironpdfengine

O extraiga la versión específica (recomendado)

docker pull ironsoftwareofficial/ironpdfengine:2023.12.6
  1. Ejecute el contenedor ironsoftwareofficial/ironpdfengine.

    Este comando creará un contenedor y se ejecutará en segundo plano con el puerto 33350

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

Aprenda a configurar el cliente IronPdf para utilizar IronPdfEngine navegando hasta la sección "Actualizar el código para utilizar IronPdfEngine."


IronPdfEngine dentro de Docker compose

La clave es configurar una red Docker que permita que IronPdfEngine y tu aplicación se vean entre sí. Establece 'depends_on' para asegurarte de que IronPdfEngine está instalado antes de que se inicie tu aplicación.

Configurar

  1. Comience por crear un archivo docker-compose.yml. Configure su archivo Docker Compose utilizando la siguiente plantilla:
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. Establece la dirección de IronPdfEngine dentro de tu aplicación (myconsoleapp) a "myironpdfengine:33350"
  2. Ejecutar docker compose
docker compose up --detach --force-recreate --remove-orphans --timestamps

Obtención de IronPdfEngine en la galería pública de AWS ECR

Requisito previo

  • Docker debe estar instalado.

Configurar

  1. Visite https://gallery.ecr.aws/v1m9w8y1/ironpdfengine
  2. Extraer la imagen v1m9w8y1/ironpdfengine
docker pull https://gallery.ecr.aws/v1m9w8y1/ironpdfengine

O extraiga la versión específica (recomendado)

docker pull https://gallery.ecr.aws/v1m9w8y1/ironpdfengine:2023.12.6
  1. Ejecuta el contenedor ironpdfengine.

    Este comando creará un contenedor y se ejecutará en segundo plano con el puerto 33350

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

Aprenda a configurar el cliente IronPdf para utilizar IronPdfEngine navegando hasta la sección "Actualizar el código para utilizar IronPdfEngine."


Obtener IronPdfEngine en AWSMarketplace

Requisitos previos

  • Docker debe estar instalado.
  • AWS CLI debe estar instalado y conectado.

Configurar

  1. Ir a awsmarketplace/ironpdfengine
  2. Haga clic en el botón "Continuar con la suscripción".

    Seguir suscrito
  3. Acepte las condiciones.

    Aceptar el CLUF
  4. Continuar con Confiuguración.

    Suscripción completa
  5. Tira de la imagen ironpdfengine. Este paso le mostrará un comando para extraer la imagen ironpdfengine.
    Iniciar este software

    Por ejemplo:

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. Ejecute el contenedor ironpdfengine. Este comando creará un contenedor y lo ejecutará en segundo plano con el puerto 33350.
docker run -d -p 33350:33350 000000000000.dkr.ecr.us-east-1.amazonaws.com/iron-software/ironpdfengine:2024.1.15

Obtener IronPdfEngine en Azure Marketplace

Configurar

  1. Ir a Contenedor Docker IronPDF.
  2. Complete los "Conceptos básicos", "Detalles del clúster" y "Detalles de la aplicación" para crear el servicio Kubernetes.
  3. Una vez completado el despliegue, en la barra lateral izquierda, vaya a Recursos de Kubernetes -> Ejecutar comando. Ejecute el siguiente comando:
kubectl get services
 Servicio Kubernetes - comando de ejecución

Con la información de EXTERNAL-IP y PORT(S)puede configurar la conexión IronPDFEngine en consecuencia.

:path=/static-assets/pdf/content-code-examples/how-to/pull-run-ironpdfengine-azure-marketplace.cs
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.GrpcLayer

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

Dim configuration As New IronPdfConnectionConfiguration()
configuration.ConnectionType = IronPdfConnectionType.RemoteServer
'INSTANT VB WARNING: An assignment within expression was extracted from the following statement:
'ORIGINAL LINE: configuration.Host = "http://48.216.143.233" configuration.Port = 80;
"http://48.216.143.233" configuration.Port = 80
configuration.Host = "http://48.216.143.233" configuration.Port
IronPdf.Installation.ConnectToIronPdfHost(configuration)

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

Actualizar el código para utilizar IronPdfEngine

Esto implica modificar el código para asegurar que IronPdf apunta al puerto correcto que está siendo expuesto por IronPdfEngine. Esta operación varía ligeramente para cada lenguaje de programación. Consulte los siguientes artículos para obtener instrucciones de uso específicas: