Adding IronPDF to an Existing Docker Container

This article was translated from English: Does it need improvement?
Translated
View the article in English

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

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

class="container-fluid">
class="row">
class="col-md-2"> Docker Logo
class="col-md-2"> Azure Logo
class="col-md-2"> Linux Logo
class="col-md-2"> AWS Logo
class="col-md-2"> Windows Logo

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

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

IronPDFとLinux入門

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

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

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

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

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

IronPDF Linux Dockerインストール

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

We recommend using the IronPdf.Linux NuGet package instead of the regular IronPdf package to save disk space and avoid assets being downloaded when you start your Docker instance. 心配しないでください。WindowsやmacOSでの開発時にも動作しますが、Linuxに最適化されています。

Install-Package IronPdf.Linux

Another solution is to simply add IronPdf.Native.Chrome.Linux on top of the regular IronPdf NuGet package.

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ファイル

class="container-fluid">
class="row">
class="col-md-2"> Docker Logo
class="col-md-2"> Ubuntu Logo

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 Files

Docker Logo
Debian Logo

Debian 12 with .NET 8

Debian 11 with .NET 7

Debian 11 with .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

Alpine Linux Docker Files

Running IronPDF on Alpine Linux is not supported. We wish we could but we can't. Frankly, we like Alpine and hope this project continues and grows. As of 2023, Alpine still uses outdated "musl" C language libraries that do not allow chromium developers to fully support this OS yet.

Using Alpine Docker with IronPdfEngine in .NET 6

IronPDF provides a container image containing all IronPDF functionalities. This enables projects running on Alpine to access IronPD functionalities by connecting to the IronPdfEngine container.

Step 1: Pull and Run IronPDF Engine Docker Image

Execute the following commands in your terminal to pull and run the IronPDF Engine Docker image:

# 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

Step 2: Set Up Console App

Create a new console application targeting .NET 6. Install the IronPdf.Slim NuGet package using the NuGet Package Manager.

Windows Docker File

Docker Logo
Windows Logo

Windows Docker Containers are becoming increasingly popular on Azure, as they offer higher levels of performance and scalability and give developers more permissions to configure instances.

IronPDF will actually perform more attractive text rendering within a Docker container (Windows or Linux) on Azure due to higher levels of access to graphics library and the virtual graphics card.

The article 'Visual Studio Container Tools for Docker' is a really great get-started guide.

This is an example Windows container Dockerfile for .NET Core 3.1

Windows Server 2019 .NET 6.0

Pre-configured Windows containers include all the necessary dependencies for running IronPDF.

ご注意Note that these containers are not intended for BUILDING .NET applications, but rather for RUNNING them.

Visit the Docker repository to explore additional pre-configured images for running 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.ChromeGpuModeIronPdf.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リソースが限られた環境でのグラフィック関連の問題を避けることにより、よりスムーズなデプロイメントとパフォーマンスをもたらします。

Curtis Chau
テクニカルライター

Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。

開発以外にも、CurtisはIoT(Internet of Things)への強い関心を持ち、ハードウェアとソフトウェアの統合方法を模索しています。余暇には、ゲームをしたりDiscordボットを作成したりして、技術に対する愛情と創造性を組み合わせています。

準備はいいですか?
Nuget ダウンロード 16,154,058 | バージョン: 2025.11 ただ今リリースされました