Cómo tirar y hacer funcionar IronPdfEngine

Chaknith Bin
Chaknith Bin
18 de febrero, 2024
Actualizado 10 de diciembre, 2024
Compartir:
This article was translated from English: Does it need improvement?
Translated
View the article in English

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: Esto se refiere a la recuperación de la imagen del contenedor IronPdfEngine desde el registro especificado (Dockerhub, AWS ECR Public Gallery 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.

Comience con IronPDF

Comience a usar IronPDF en su proyecto hoy con una prueba gratuita.

Primer Paso:
green arrow pointer


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 extrae 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 de IronPdf para utilizar IronPdfEngine navegando a la sección "Actualizar el código para usar 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 creando 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. Establezca la dirección de IronPdfEngine dentro de su 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 extrae 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 de IronPdf para utilizar IronPdfEngine navegando a la sección "Actualizar el código para usar IronPdfEngine".


Obtener IronPdfEngine en AWS Marketplace

mercado aws

Requisitos previos

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

Configurar

  1. Ve a IronPdfEngine en el mercado de AWS. Haga clic en "Continuar con la suscripción"

  2. Acepte las condiciones.

    Aceptar el CLUF
  3. Continuar con Confiuguración.

    Suscripción completada
  4. Tira de la imagen ironpdfengine. Este paso le mostrará un comando para extraer la imagen ironpdfengine.

    Iniciar este software

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

Azure Marketplace

Configurar

  1. Vaya a IronPDF Docker Container en Azure Marketplace. Haz clic en "Consíguelo ahora" y "Continuar"

  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), puedes configurar la conexión de IronPDFEngine en consecuencia.

: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")
$vbLabelText   $csharpLabel

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:

Chaknith Bin
Ingeniero de software
Chaknith trabaja en IronXL e IronBarcode. Tiene una gran experiencia en C# y .NET, ayudando a mejorar el software y a apoyar a los clientes. Sus conocimientos de las interacciones con los usuarios contribuyen a mejorar los productos, la documentación y la experiencia general.