リモートコンテナとしてIronPDFを実行する

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

環境/コンテナを適切に設定してすべての依存関係を含むようにするのは難しい場合があります。 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 の有効化を推奨します。 (Enable logging)
• コンテナの起動順は、同じタスク定義にアプリケーションのコンテナをデプロイしたい場合に必要です。

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

推奨設定:

• Launch type: AWS Fargate
• Public IP: Turned on for test and Turned off for production. Security and AWS Networking are on your own.

4. Enjoy! IronPdfEngine docker is up and running in your AWS!

水平スケーリングはサポートされていません。 詳細はIronPdfEngine Limitationを参照してください。

前提条件

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

セットアップ

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

推奨設定:

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

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

水平スケーリングはサポートされていません。 詳細はIronPdfEngine Limitationを参照してください。

前提条件

Prerequisite

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

セットアップ

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

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

3. Run ironpdfengine container.

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

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

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

Azure マーケットプレイス

Azure Marketplace

Setup

1. AzureマーケットプレイスのIronPDF Dockerコンテナにアクセスします。 "すぐに取得"と"続行"をクリックします。
2. "基本情報"、"クラスターの詳細"、および"アプリケーションの詳細"を完成させてKubernetesサービスを作成します。
3. デプロイが完了したら、左のサイドバーに移動してKubernetesリソース > コマンドを実行を選択します。 次のコマンドを実行します:

kubectl get services

kubectl get services

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

: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マーケットプレイス

前提条件

• Docker をインストールする必要があります。
• AWS CLIをインストールし、ログインしている必要があります。

Setup

1. Go to IronPdfEngine on AWS marketplace. 'サブスクライブに進む'をクリックします。

2. 利用規約に同意します。

4. 設定に進みます。

5. ironpdfengineのイメージをプルします。 このステップでは、ironpdfengineのイメージをプルするコマンドが表示されます。

6. ironpdfengine コンテナを実行します。

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

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

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

docker run -d -p 33350:33350 000000000000.dkr.ecr.us-east-1.amazonaws.com/iron-software/ironpdfengine:2024.1.15

docker run -d -p 33350:33350 000000000000.dkr.ecr.us-east-1.amazonaws.com/iron-software/ironpdfengine:2024.1.15

gRPCによるヘルスチェック

IronPdfEngineは、次のプロトコル構造を利用して、標準のgRPCヘルスチェックパターンに準拠しています。

message HealthCheckRequest {
 string service = 1; // Name of the service to check (e.g., "IronPdfEngine")
}

IronPdfEngineをチェックしているので、サービス名をIronPdfEngineに置き換えます。

デフォルトの33350を使用して、PostmanでローカルIronPdfEngineサービスにgRPCリクエストを送信するJavaScriptの例を以下に示します。

応答からわかるように、ステータス応答はSERVINGであり、サービスが稼働していることを示します。 コンテナが健康でない場合、ステータス応答はNOT_SERVINGになります。

Kubernetesセットアップによるヘルスチェック

Kubernetesセットアップの場合、サービスが健康かどうかを確認するために次のコマンドを使用できます。

 livenessProbe:
          exec:
            command:
            - /bin/grpc_health_probe
            - -addr=:33350
            - -rpc-timeout=5s

 livenessProbe:
          exec:
            command:
            - /bin/grpc_health_probe
            - -addr=:33350
            - -rpc-timeout=5s