Run IronPDF as a Remote Container

Sin Docker Compose

Ejecute el contenedor docker usando la versión del paso anterior.

• Docker debe estar instalado.

Configuración

1. Vaya a https://hub.docker.com/r/ironsoftwareofficial/ironpdfengine
2. Extraiga la última imagen ironsoftwareofficial/ironpdfengine

docker pull ironsoftwareofficial/ironpdfengine

docker pull ironsoftwareofficial/ironpdfengine

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

docker pull ironsoftwareofficial/ironpdfengine:2025.3.6

docker pull ironsoftwareofficial/ironpdfengine:2025.3.6

3. Ejecute el contenedor ironsoftwareofficial/ironpdfengine.

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

docker run -d -p 33350:33350 -e IRONPDF_ENGINE_LICENSE_KEY=MY_LICENSE_KEY ironsoftwareofficial/ironpdfengine:2025.3.6

docker run -d -p 33350:33350 -e IRONPDF_ENGINE_LICENSE_KEY=MY_LICENSE_KEY ironsoftwareofficial/ironpdfengine:2025.3.6

Con Docker Compose

La clave es configurar una red Docker que permita a IronPdfEngine y su aplicación verse mutuamente. Establezca 'depends_on' para garantizar que IronPdfEngine esté activo antes de que su aplicación comience.

Configuración

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 (miaplicacionconsola) a "myironpdfengine:33350"
2. Ejecute docker compose

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

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

Hay varios IronPdfConnectionType que puede asignar dependiendo del tipo de conexión que desee realizar.

Aquí hay una lista de propiedades disponibles:

LocalExcutable: Para conectarse a un "servidor" IronPdfEngine que ejecuta un ejecutable en su máquina local, usamos esta opción. Un ejemplo rápido sería una aplicación de facturación WinForm que genera PDFs localmente sin depender de servicios en la nube.

Docker: Esta opción debe usarse al intentar conectarse a un contenedor Docker localmente o en la nube.

RemoteServer: Esta opción se utiliza para IronPdfEngine en la nube. Esto se conecta a una instancia IronPdfEngine alojada en la nube (por ejemplo, Docker) a través del protocolo HTTP o HTTPS. Tenga en cuenta que, como esto se conecta a un servidor remoto, se requiere la URL completa (incluyendo el protocolo HTTP o HTTPS).

Custom: Para un control y personalización completos sobre la conexión, puede usar esta opción. Esta opción utiliza su Grpc.Core.ChannelBase definido por el usuario en lugar de las otras opciones definidas anteriormente. Los desarrolladores pueden crear un nuevo canal ya sea creando un nuevo objeto Grpc.Core.Channel o usando Grpc.Net.Client.GrpcChannel.ForAddress(System.String) para un control completo y personalizado sobre el canal gRPC.

.NET Framework con NetFrameworkChannel

Para .NET Framework, requerimos una configuración diferente porque gRPC funciona de manera diferente en proyectos .NET Framework. Para que este método funcione, asegúrese de que el paquete NuGet Grpc.Core esté instalado. Usaremos un canal gRPC personalizado derivado de Grpc.Core.ChannelBase para esta configuración específica.

Examinemos este ejemplo, donde implementaremos el canal de conexión para crear y guardar un PDF usando IronPDFEngine.

:path=/static-assets/pdf/content-code-examples/how-to/ironpdfengine-docker-use-grpc.cs

using IronPdf;

// This code demonstrates how to use IronPdf with gRPC in a .NET Framework application.

// 1. Configure connection to use local IronPdfEngine executable
var config = IronPdf.GrpcLayer.IronPdfConnectionConfiguration.Executable;

// 2. Connect to the IronPDF host with the executable configuration
IronPdf.Installation.ConnectToIronPdfHost(config);

// 3. Create a PDF renderer instance
ChromePdfRenderer renderer = new ChromePdfRenderer();

// 4. Render HTML string as PDF document
PdfDocument pdf = renderer.RenderHtmlAsPdf("Hello world");

// 5. Save the PDF to disk
pdf.SaveAs("output.pdf");

// 6. Clean up , this is needed to work
pdf.Dispose();

IRON VB CONVERTER ERROR developers@ironsoftware.com

Método alternativo con WithCustomChannel

Un método alternativo sería utilizar el método WithCustomChannel proporcionado por el IronPdf.GrpcLayer.

El WithCustomChannel recibe dos parámetros, el customChannel, que es su canal gRPC personalizado, y metadata. El parámetro metadata es opcional y está configurado a null por defecto.

:path=/static-assets/pdf/content-code-examples/how-to/ironpdfengine-docker-use-grpc-alt.cs

using IronPdf;
using IronPdf.GrpcLayer;
using Grpc.Core;

// 1. Create custom gRPC channel (.NET Framework style)
var channel = new Channel("123.456.7.8:80", ChannelCredentials.SecureSsl);

// 2. (Optional) Add metadata headers if needed
var metadata = new Metadata
{
    { "Authorization", "Bearer your_token_here" }
};

// 3. Configure IronPDF with custom channel
var config = IronPdfConnectionConfiguration.WithCustomChannel(channel, metadata);
IronPdf.Installation.ConnectToIronPdfHost(config);

// 4. Generate PDF
var renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("Hello world");

// 5. Save the PDF to disk
pdf.SaveAs("output.pdf");

// 6. Clean up , this is needed to work
pdf.Dispose();

IRON VB CONVERTER ERROR developers@ironsoftware.com