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

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

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

IronPDFをインストールする

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

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

注意: 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;

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

接続タイプ

: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();

: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();

前提条件

• 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 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 を取得する

前提条件

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

セットアップ

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

AWSマーケットプレイス

前提条件

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

セットアップ

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