既存のDockerコンテナにIronPDFを追加する

カーティス・チャウ

更新日:12月 3, 2025

Translated

View the article in English

IronPDF for .NET Standardは、LinuxおよびWindows用のAzure Dockerコンテナを含むDockerを完全にサポートしています。

代わりにIronPDFを別のDockerコンテナとしてデプロイしますか？ IronPDFEngineチュートリアルガイドについて詳しく学びましょう。

なぜAzureでDockerを使用するのか？

優れたエンタープライズスケーラビリティに加え、Azure上のDockerコンテナは通常のWebAppsよりも多くの権限を持っています。これにより、GDI+グラフィックスへのシステムアクセスが可能になるため、SVGフォントのレンダリングが可能になります。

IronPDFとLinux入門

Dockerと.NETが初めての方には、DockerデバッグとVisual Studioプロジェクトとの統合の設定に関する優れた記事をお勧めします。

IronPDF Linuxセットアップと互換性ガイドもぜひお読みください。

推奨Linux Dockerディストリビューション

IronPDFの"簡単な構成"のため、以下の最新の64ビットLinux OSをお勧めします。

Ubuntu 22
Ubuntu 20
Ubuntu 18
Debian 11
Debian 10
CentOS 8
Amazon AWS Linux 2 IronPDF AWS Lambdaセットアップガイドを読む

Microsoftの公式Dockerイメージ for .NETの使用をお勧めします。他のLinuxディストリビューションも部分的にサポートされていますが、手動での設定が必要な場合があります。 "Linux手動セットアップ"ガイドをご覧ください。

IronPDF Linux Dockerインストール

Linux最適化NuGetパッケージを使用

ディスクスペースを節約し、Dockerインスタンスを開始したときにアセットがダウンロードされないようにするため、通常のIronPDFパッケージの代わりにIronPDF.Linux NuGetパッケージを使用することをお勧めします。心配しないでください。WindowsやmacOSでの開発時にも動作しますが、Linuxに最適化されています。

Install-Package IronPdf.Linux

もう1つの解決策として、通常のIronPDF NuGetパッケージの上にIronPDF.Native.Chrome.Linuxを追加するだけです。

Install-Package IronPdf.Native.Chrome.Linux

自動依存関係インストールを避ける

多くのユーザーは、LinuxAndDockerDependenciesAutoConfigをfalseに設定すると、Linux & Dockerでの結果がより良いと報告しています。これは、前提条件がDockerファイル内のapt-getスタイルのパッケージマネージャによってすでにインストールされているためです。

// Disable automatic configuration of Linux and Docker dependencies
IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = false;

// Disable automatic configuration of Linux and Docker dependencies
IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = false;

' Disable automatic configuration of Linux and Docker dependencies
IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = False

$vbLabelText $csharpLabel

GPUアクセラレーションを無効にする

Linux Dockerコンテナは、GPUにアクセスできないことがよくあります。 GPUアクセラレーションはデフォルトで無効になっています。 ChromeGpuModes.Enabledが有効になっている場合、Dockerデプロイメントのために無効にすることを強くお勧めします。

// Disable GPU acceleration for Docker environments
IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;

// Disable GPU acceleration for Docker environments
IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;

' Disable GPU acceleration for Docker environments
IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled

$vbLabelText $csharpLabel

Ubuntu Linux Dockerファイル

Ubuntu 22 with .NET 8

Ubuntu 22 with .NET 7

Ubuntu 20 with .NET 6 （英語

Ubuntu 20 with .NET 5

Ubuntu 20 with .NET 3.1 LTS

Ubuntu 18 with .NET 3.1 LTS

Debian Linux Docker ファイル

Debian 12 と .NET 8 の組み合わせ

Debian 11 with .NET 7

Debian 11 と .NET 6 の組み合わせ

Debian 11 with .NET 5

Debian 11 with .NET 3.1 LTS

Debian 10 with .NET 5

Debian 10 with .NET 3.1 LTS

アルパインLinux Dockerファイル

Alpine Linux上でのIronPDFの実行はサポートされていません。できればそうしたいのですが、できません。率直に言って、私たちはアルパインが好きで、このプロジェクトが継続し、成長することを願っています。 2023年として、Alpineでは依然として古い"musl" C言語ライブラリを使用しており、このOSでの完全なサポートがまだ不可能です。

.NET 6でのIronPdfEngineを用いたAlpine Dockerの使用

IronPDFはすべてのIronPDFの機能を含むコンテナイメージを提供します。これにより、Alpine上で動作するプロジェクトがIronPdfEngineコンテナに接続することで、IronPDの機能にアクセスできるようになります。

ステップ1: IronPDFエンジンのDockerイメージをプルして実行する。

ターミナルで以下のコマンドを実行し、IronPDF Engine Dockerイメージをプルして実行してください：

# Pull the IronPDF Engine Docker Image
docker pull ironsoftwareofficial/ironpdfengine

# Pull the IronPDF Engine Docker Image
docker pull ironsoftwareofficial/ironpdfengine

SHELL

# Run the IronPDF Engine Docker container
docker run -d -p 33350:33350 ironsoftwareofficial/ironpdfengine

# Run the IronPDF Engine Docker container
docker run -d -p 33350:33350 ironsoftwareofficial/ironpdfengine

SHELL

ステップ 2: コンソールアプリのセットアップ

.NET 6をターゲットとした新しいコンソール・アプリケーションを作成し、NuGetパッケージ・マネージャーを使ってIronPdf.Slim NuGetパッケージをインストールします。

Windowsドッカーファイル

Windows Dockerコンテナは、より高いレベルのパフォーマンスとスケーラビリティを提供し、開発者にインスタンスを構成するためのより多くの権限を与えるため、Azure上でますます人気が高まっています。

IronPdfはAzure上のDockerコンテナ（WindowsまたはLinux）内でより魅力的なテキストレンダリングを行います。

Visual Studio Container Tools for Docker"は、本当に素晴らしいスタートガイドです。

.NET Core 3.1用のWindowsコンテナDockerfileの例です。

Windows Server 2019 .NET 6.0について

設定済みのWindowsコンテナには、IronPDFを実行するために必要なすべての依存関係が含まれています。

BRACKET-i-OPEN--これらのコンテナは、.NETアプリケーションを構築するためのものではなく、実行するためのものであることに注意してください。

Dockerリポジトリを訪問して、IronPDFを実行するための設定済みイメージを追加してください。

よくある質問

.NETライブラリをDockerコンテナに統合する方法は？

IronPDFという.NETライブラリをDockerコンテナに統合するには、Microsoftの公式DockerイメージとLinux向けのIronPdf.Linux NuGetパッケージ、またはWindows環境用の事前設定されたWindows Dockerコンテナを使用します。

AzureでPDF操作にDockerコンテナを使用する利点は何ですか？

AzureでPDF操作にDockerコンテナを使用することで、エンタープライズのスケーラビリティが向上し、通常のWebAppsよりも多くの権限が得られます。このセットアップは、GDI+のグラフィックスアクセスを通じてSVGフォントのレンダリングなどの高度な機能を有効にするのに理想的です。

Dockerで.NET PDFライブラリを実行するのに最適なLinuxディストリビューションはどれですか？

DockerでIronPDFを実行するのに最適なLinuxディストリビューションには、設定と互換性が簡単なUbuntu 18/20/22、Debian 10/11、CentOS 8、Amazon AWS Linux 2があります。

Linux Dockerコンテナで.NET PDFライブラリのパフォーマンスを最適化する方法は？

パフォーマンスを最適化するには、IronPdf.Linuxパッケージを使用し、自動依存関係インストールを無効にし、GPUアクセラレーションを無効にしてIronPdf.Installation.ChromeGpuModeをIronPdf.Engines.Chrome.ChromeGpuModes.Disabledに設定します。

Dockerコンテナ内でAlpine LinuxにIronPDFを実行できますか？

IronPDFは'musl'ライブラリとの互換性がないため、Alpine Linuxをネイティブにサポートしていません。Alpine LinuxでIronPDFを使用するには、IronPdfEngine Dockerコンテナを介して実行することを検討してください。

事前設定されたDockerコンテナを.NETライブラリで使用する目的は何ですか？

事前設定されたDockerコンテナは、IronPDFを効率的に実行するために必要なすべての依存関係を提供し、特にAzureなどのプラットフォームにデプロイするときに、高性能とスケーラビリティを確保します。

Dockerで.NETアプリケーションのための.NET PDFライブラリをどのように構成しますか？

Dockerで.NETアプリケーションのためにIronPDFを構成するには、LinuxとWindowsのDockerコンテナに統合し、マイクロサービスアーキテクチャ内で堅牢なPDF機能を有効にします。

.NETライブラリをDockerでデプロイするための推奨手順は何ですか？

推奨される手順には、IronPdf.LinuxのようなLinuxに最適化されたパッケージを使用し、自動依存関係インストールを無効にし、Docker環境でのランタイム中に遅延を防ぐためにIronPDFを事前に初期化します。

.NET 6.0を実行しているWindows Server 2019 Dockerコンテナで.NET PDFライブラリをどのようにセットアップしますか？

.NET 6.0でIronPDFを実行するためのすべての必要な依存関係と構成を含む事前設定されたDockerfileを使用して、Windows Server 2019 Dockerコンテナで.NET PDFライブラリをセットアップします。

Dockerのセットアップで.NETライブラリのGPUアクセラレーションを無効にする理由は？

DockerでIronPDFのGPUアクセラレーションを無効にすると、GPUリソースが限られた環境でのグラフィック関連の問題を避けることにより、よりスムーズなデプロイメントとパフォーマンスをもたらします。