Run IronPDF as a Remote Container

デプロイメントの問題を避ける

環境/コンテナを適切に設定してすべての依存関係を含むようにするのは難しい場合があります。 IronPDF Docker コンテナを使用すると、IronPDF が事前にインストールされ、確実に動作するため、すべての展開と依存関係の問題を回避できます。

IronPDFをインストールする

プロジェクトにIronPdf.Slim Nugetパッケージを追加します。

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

注: IronPdf、IronPdf.Linux および IronPdf.MacOs パッケージにはすべて IronPdf.Slim が含まれています。

アプリケーションサイズを削減するために、IronPdf.Slim のみをインストールすることをお勧めします。 IronPdf.Native.Chrome.xxx パッケージはもはや使用されていないため、プロジェクトから削除できます。

必要なコンテナバージョンを決定する

デフォルトでは、Docker 用の IronPDF バージョンは NuGet の現在の IronPDF バージョンと一致します。 以下のコードを使用してバージョンを手動で確認することができます。

: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

Docker コンテナに IronPDF をセットアップする

docker pull ironsoftwareofficial/ironpdfengine

docker pull ironsoftwareofficial/ironpdfengine

docker pull ironsoftwareofficial/ironpdfengine:2025.3.6

docker pull ironsoftwareofficial/ironpdfengine:2025.3.6

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

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'

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

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

IronPdfEngine に接続する

IronPDF コードを実行します。 アプリケーションは Docker 内の IronPdfEngine と通信します。

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

using IronPdf;
using IronPdf.GrpcLayer;

// Configure for Docker container
var config = IronPdfConnectionConfiguration.Docker;
config.Host = "localhost";
IronPdf.Installation.ConnectToIronPdfHost(config);

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

Imports IronPdf
Imports IronPdf.GrpcLayer

' Configure for Docker container
Private config = IronPdfConnectionConfiguration.Docker
config.Host = "localhost"
IronPdf.Installation.ConnectToIronPdfHost(config)

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

接続タイプ

: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

: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

前提条件

• IronPdfEngine Docker イメージをプルします。 これは上記の Docker コンテナの IronPDF のセットアップ にあります。
• ECS へのアクセス権限を持つ AWS アカウント。

セットアップ

1. ECS クラスターを作成します。 ECS クラスターをコンソールを使用して Fargate および External 起動タイプのクラスターを作成するためのガイド に従ってください。
2. タスク定義を作成します。 コンソールを使用してタスク定義を作成するためのガイド に従ってください。

推奨設定:

• AWS Fargate
• 最小 1 vCPU と 2 GB の RAM を推奨します。 PDF が 10 ページ以上であるか、重い負荷要求があるワークロードの場合は、より高い層を選択してください。
• ネットワーク モード: awsvpc
• ポートマッピング:

  {
    "containerPort": 33350,
    "hostPort": 33350,
    "protocol": "tcp",
    "appProtocol": "grpc"
  }

• イメージ URI: 任意の IronPdfEngine を指します。 たとえば、"ironsoftwareofficial/ironpdfengine:2024.1.20"（DockerHub から）
• AWS パーミッションとネットワーキングは自己責任で
• Amazon CloudWatch の有効化を推奨します。 （ログの有効化）
• コンテナの起動順は、同じタスク定義にアプリケーションのコンテナをデプロイしたい場合に必要です。

3. タスク定義を実行します。 タスク定義を タスク または サービス として実行することができます。 コンソールを使用してサービスを作成するためのガイド に従ってください。

推奨設定:

• 起動タイプ: AWS Fargate
• 公開 IP: テスト用にはオン、本番用にはオフです。 セキュリティと AWS ネットワーキングは自己責任で。

4. お楽しみください！ IronPdfEngine Docker が AWS で起動し、稼働しています！

[{i:(水平スケーリングはサポートされていません。こちらのIronPdfEngine 制限をご参照ください。）}] ## IronPdfEngine を Azure コンテナインスタンスにデプロイする

• Azure アカウント

前提条件

• IronPdfEngine Docker イメージをプルします。 これは上記の Docker コンテナの IronPDF のセットアップ にあります。
  1. Azure コンテナを作成します。

セットアップ

Azure ポータルを使用してコンテナインスタンスを Azure にデプロイするためのクイックスタートガイドに従ってください。 - イメージソース: 他のレジストリ

推奨設定:

• イメージ: ironsoftwareofficial/ironpdfengine:2024.1.20（Docker Hub から）
• OS タイプ: Linux
• サイズ: 最小で 1 vCPU と 2 GiB のメモリ、またはそれ以上
• ポート: TCP ポート 33350
  2. お楽しみください！

IronPdfEngine Docker が Azure コンテナインスタンスで実行されています！ ## AWS ECR パブリックギャラリーでの IronPdfEngine を取得する

[{i:(水平スケーリングはサポートされていません。こちらのIronPdfEngine 制限をご参照ください。）}] ## IronPdfEngine を Azure コンテナインスタンスにデプロイする

前提条件

1. https://gallery.ecr.aws/v1m9w8y1/ironpdfengine にアクセスします。

• Docker をインストールする必要があります。

セットアップ

2. v1m9w8y1/ironpdfengine イメージをプルします。
3. ironpdfengine コンテナを実行します。

docker pull https://gallery.ecr.aws/v1m9w8y1/ironpdfengine

docker pull https://gallery.ecr.aws/v1m9w8y1/ironpdfengine

または特定のバージョン（推奨）をプルします。

docker pull https://gallery.ecr.aws/v1m9w8y1/ironpdfengine:2023.12.6

docker pull https://gallery.ecr.aws/v1m9w8y1/ironpdfengine:2023.12.6

「IronPdfEngine を使用するようにコードを更新」セクションに移動して、IronPdf クライアントを設定する方法を学びます。

このコマンドは、コンテナを作成し、ポート 33350 でバックグラウンドで実行します。

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

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

Azure マーケットプレイス

1. Azure マーケットプレイス の IronPDF Docker Container にアクセスします。

セットアップ

"Get It Now" および "Continue" をクリックします。 2. Kubernetes サービスを作成するために、"Basics"、"Cluster Details"、および "Application Details" を完了します。

3. デプロイメントが完了したら、左サイドバーをナビゲートして Kubernetes リソース > コマンドの実行を選択します。 以下のコマンドを実行します：
   class="content-img-align-center">

   class="center-image-wrapper">

kubectl get services

kubectl get services

EXTERNAL-IP と PORT(S) の情報を使用して、IronPDFEngine の接続を適切に設定できます。

AWS マーケットプレイス

: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")

前提条件

• AWS CLI をインストールしてログインしていること。

• Docker をインストールする必要があります。
  1. AWS マーケットプレイスの IronPdfEngine にアクセスします。

セットアップ

'Continue to Subscribe' をクリックします。 3. 規約に同意します。