1. .NET
  2. Başlamak için
  3. Docker'da IronPDF çalıştırın

IronPDF'yi Mevcut Bir Docker Konteynerine Ekleme

Curtis Chau
Curtis Chau
Güncellendi:
This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPDF for .NET Standard, Linux ve Windows için Azure Docker Containers dahil olmak üzere Docker'ı artık tam olarak desteklemektedir.

IronPDF'yi ayrı bir Docker konteyneri olarak mı dağıtmak istersiniz? IronPdfEngine eğitim kılavuzu hakkında daha fazla bilgi edinin.

Docker Logosu
Azure Logosu
Linux Logosu
AWS Logosu
Windows Logosu

Neden Azure'da Docker kullanmalı?

Mükemmel Enterprise ölçeklenebilirliğin yanı sıra, Azure'daki Docker Konteynerleri normal WebApps'lerden daha fazla izinlere sahiptir. Bu, GDI+ grafiklerine sistem erişimi etkinleştirildiği için SVG yazı tiplerinin görüntülenmesine olanak tanır.

IronPDF ve Linux Primer

.NET ile Docker sizin için yeni bir konuysa, Docker hata ayıklama ve Visual Studio projeleriyle entegrasyonun kurulumu hakkında yazılmış bu mükemmel makaleyi okumanızı öneririz.

Ayrıca, IronPDF Linux Kurulum ve Uyumluluk Kılavuzumuzu okumanızı şiddetle tavsiye ederiz.

Önerilen Linux Docker Dağıtımları

IronPDF'nin "kolay yapılandırılması" için aşağıdaki en yeni 64 bit Linux işletim sistemlerini öneririz.

.NET için Microsoft'un Resmi Docker Görüntülerini kullanmanızı öneririz. Diğer Linux dağıtımları kısmen desteklenir, ancak manuel yapılandırma gerektirebilir. "Linux Manuel Kurulum" kılavuzumuza bakın.

IronPDF Linux Docker Kurulumu

Linux için Optimize Edilmiş NuGet Paketlerini Kullanın

Disk alanından tasarruf etmek ve Docker örneğini başlattığınızda varlıkların indirilmesini önlemek için, normal IronPDF paketi yerine IronPdf.Linux NuGet paketini kullanmanızı öneririz. Endişelenmeyin, Windows veya macOS üzerinde geliştirme yaparken de çalışır - sadece Linux için optimize edilmiştir.

Install-Package IronPdf.Linux

Başka bir çözüm ise, normal IronPDF NuGet paketinin üzerine IronPdf.Native.Chrome.Linux'u eklemektir.

Install-Package IronPdf.Native.Chrome.Linux

Otomatik Bağımlılık Yüklemesinden Kaçının

Birçok kullanıcı, LinuxAndDockerDependenciesAutoConfig false olarak ayarlandığında Linux ve Docker ile daha iyi sonuçlar elde ettiğini bildiriyor. Bunun nedeni, önkoşulların Docker dosyalarınızda apt-get tarzı paket yöneticileri tarafından zaten yüklenmiş olmasıdır.

// 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 Hızlandırmasını Devre Dışı Bırak

Linux Docker kapsayıcıları genellikle GPU'ya erişemez. GPU hızlandırma varsayılan olarak devre dışıdır. ChromeGpuModes.Enabled'yi etkinleştirdiyseniz, Docker dağıtımları için bunu devre dışı bırakmanızı şiddetle tavsiye ederiz:

// 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 Dosyaları

Docker Logosu
Ubuntu Logosu

.NET 10 ile Ubuntu 24

Ubuntu 24.04 (Noble), 64 bit time_t geçiş paketleri kullanır, bu nedenle bazı kütüphane adları önceki Ubuntu sürümlerinden farklıdır (ör. libasound2 yerine libasound2t64).

# Build stage
FROM mcr.microsoft.com/dotnet/sdk:10.0-noble AS build
WORKDIR /app
COPY *.csproj .
RUN dotnet restore
COPY . .
RUN dotnet publish -c Release -o /app/publish

# Runtime stage
FROM mcr.microsoft.com/dotnet/aspnet:10.0-noble AS runtime

# Install IronPDF dependencies for Ubuntu 24.04 Noble (64-bit transition libraries)
RUN apt-get update && apt-get install -y \
    libasound2t64 \
    libatk1.0-0t64 \
    libatk-bridge2.0-0t64 \
    libcairo2 \
    libcups2t64 \
    libdbus-1-3 \
    libdrm2 \
    libexpat1 \
    libfontconfig1 \
    libgbm1 \
    libglib2.0-0t64 \
    libgtk-3-0t64 \
    libnspr4 \
    libnss3 \
    libpango-1.0-0 \
    libpangocairo-1.0-0 \
    libx11-6 \
    libxcb1 \
    libxcomposite1 \
    libxdamage1 \
    libxext6 \
    libxfixes3 \
    libxkbcommon0 \
    libxrandr2 \
    fonts-liberation \
    wget \
    && rm -rf /var/lib/apt/lists/*

WORKDIR /app
COPY --from=build /app/publish .
ENTRYPOINT ["dotnet", "YourApp.dll"]

.NET 8 ile Ubuntu 24

.NET 8 LTS ile Ubuntu 24.04 LTS, yaygın bir üretim kombinasyonudur. Aynı 64 bit geçiş kütüphanesi adları geçerlidir.

# Build stage
FROM mcr.microsoft.com/dotnet/sdk:8.0-noble AS build
WORKDIR /app
COPY *.csproj .
RUN dotnet restore
COPY . .
RUN dotnet publish -c Release -o /app/publish

# Runtime stage
FROM mcr.microsoft.com/dotnet/aspnet:8.0-noble AS runtime

# Install IronPDF dependencies for Ubuntu 24.04 Noble (64-bit transition libraries)
RUN apt-get update && apt-get install -y \
    libasound2t64 \
    libatk1.0-0t64 \
    libatk-bridge2.0-0t64 \
    libcairo2 \
    libcups2t64 \
    libdbus-1-3 \
    libdrm2 \
    libexpat1 \
    libfontconfig1 \
    libgbm1 \
    libglib2.0-0t64 \
    libgtk-3-0t64 \
    libnspr4 \
    libnss3 \
    libpango-1.0-0 \
    libpangocairo-1.0-0 \
    libx11-6 \
    libxcb1 \
    libxcomposite1 \
    libxdamage1 \
    libxext6 \
    libxfixes3 \
    libxkbcommon0 \
    libxrandr2 \
    fonts-liberation \
    wget \
    && rm -rf /var/lib/apt/lists/*

WORKDIR /app
COPY --from=build /app/publish .
ENTRYPOINT ["dotnet", "YourApp.dll"]

.NET 8 ile Ubuntu 22

.NET 7 ile Ubuntu 22

.NET 6 ile Ubuntu 20

.NET 5 ile Ubuntu 20

.NET 3.1 LTS ile Ubuntu 20

.NET 3.1 LTS ile Ubuntu 18

Debian Linux Docker Dosyaları

Docker Logosu
Debian Logosu

.NET 8 ile Debian 12

.NET 7 ile Debian 11

.NET 6 ile Debian 11

.NET 5 ile Debian 11

.NET 3.1 LTS ile Debian 11

.NET 5 ile Debian 10

.NET 3.1 LTS ile Debian 10

Alpine Linux Docker Dosyaları

Alpine Linux'ta IronPDF'nin çalıştırılması desteklenmemektedir. Keşke yapabilsek ama yapamıyoruz. Açıkçası, Alpine'i seviyoruz ve bu projenin devam etmesini ve büyümesini umuyoruz. 2023 itibariyle, Alpine hala Chromium geliştiricilerinin bu işletim sistemini tam olarak desteklemesine izin vermeyen, güncel olmayan "musl" C dili kütüphanelerini kullanmaktadır.

.NET 6'da IronPdfEngine ile Alpine Docker'ı kullanma

IronPDF, tüm IronPDF işlevlerini içeren bir konteyner görüntüsü sağlar. Bu, Alpine üzerinde çalışan projelerin IronPdfEngine konteynerine bağlanarak IronPD işlevlerine erişmesini sağlar.

Adım 1: IronPDF Engine Docker Görüntüsünü İndirin ve Çalıştırın

IronPDF Engine Docker görüntüsünü çekmek ve çalıştırmak için terminalinizde aşağıdaki komutları çalıştırın:

# 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

Adım 2: Konsol Uygulamasını Kurma

.NET 6'yı hedefleyen yeni bir konsol uygulaması oluşturun. NuGet Paket Yöneticisi'ni kullanarak IronPdf.Slim NuGet paketini yükleyin.

Windows Docker Dosyası

Docker Logosu
Windows Logosu

Windows Docker Kapsayıcıları, daha yüksek performans ve ölçeklenebilirlik sunarken geliştiricilere örnekleri yapılandırmak için daha fazla izin verdiği için Azure'da giderek daha popüler hale gelmektedir.

IronPDF, grafik kütüphanesine ve sanal grafik kartına daha yüksek erişim seviyeleri sayesinde Azure üzerindeki bir Docker konteyneri (Windows veya Linux) içinde daha çekici metin görüntüleme performansı sergileyecektir.

"Docker için Visual Studio Container Araçları" başlıklı makale, gerçekten harika bir başlangıç kılavuzudur.

Bu, .NET Core 3.1 için bir Windows konteyner Dockerfile örneğidir.

Windows Server 2019 .NET 6.0

Önceden yapılandırılmış Windows kapsayıcıları, IronPDF'yi çalıştırmak için gerekli tüm bağımlılıkları içerir.

Lütfen dikkate alınBu kapsayıcıların .NET uygulamalarını OLUŞTURMAK için değil, ÇALIŞTIRMAK için tasarlandığını unutmayın.

IronPDF'yi çalıştırmak için önceden yapılandırılmış diğer görüntüleri keşfetmek üzere Docker deposunu ziyaret edin.

Sıkça Sorulan Sorular

.NET kitaplığını bir Docker konteynerine entegre edebilir miyim?

IronPDF, bir Docker konteynerine PDF üretimi için bir .NET kütüphanesi olarak, Microsoft'un resmi Docker görüntüleri ve Linux için IronPdf.Linux NuGet paketi veya Windows ortamları için önceden yapılandırılmış Windows Docker konteynerleri kullanılarak entegre edilebilir.

Azure üzerinde PDF manipülasyonu için Docker konteynerlerini kullanmanın faydaları nelerdir?

Azure üzerinde PDF manipülasyonu için Docker konteynerlerini kullanmak, gelişmiş kurumsal ölçeklenebilirlik ve normal WebApps'ten daha fazla izin sağlayarak uygundur. Bu kurulum, GDI+ grafik erişimi yoluyla SVG fontlarının işlenmesi gibi gelişmiş özellikleri etkinleştirmek için idealdir.

Docker'da bir .NET PDF kütüphanesini çalıştırmak için en uygun Linux dağıtımları hangileridir?

Docker'da IronPDF çalıştırmak için en uygun Linux dağıtımları arasında, kolay yapılandırma ve uyumluluk sundukları için Ubuntu 18/20/22, Debian 10/11, CentOS 8 ve Amazon AWS Linux 2 bulunmaktadır.

Linux Docker konteynerlerinde bir .NET PDF kütüphanesinin performansını nasıl optimize edebilirim?

Performansı optimize etmek için IronPdf.Linux paketini kullanın, otomatik bağımlılık yüklemelerini devre dışı bırakın ve GPU hızlandırmasını kapatmak için IronPdf.Installation.ChromeGpuMode ayarını IronPdf.Engines.Chrome.ChromeGpuModes.Disabled olarak yapılandırın.

IronPDF, bir Docker konteynerinde Alpine Linux üzerinde çalışabilir mi?

IronPDF, uyumsuz 'musl' kütüphaneleri nedeniyle Alpine Linux'u doğal olarak desteklemez. Alpine Linux üzerinde IronPDF'i kullanmak için IronPdfEngine Docker konteyneri aracılığıyla çalıştırmayı düşünün.

Önceden yapılandırılmış Docker konteynerleri bir .NET kütüphanesi için ne amaçla kullanılır?

Önceden yapılandırılmış Docker konteynerleri, IronPDF'i verimli bir şekilde çalıştırmak için gerekli tüm bağımlılıkları sağlar, yüksek performans ve ölçeklenebilirlik sağlar, özellikle Azure gibi platformlara dağıtılırken faydalıdır.

Docker içinde .NET uygulamaları için bir .NET PDF kütüphanesi nasıl yapılandırılır?

IronPDF'i .NET uygulamaları için Docker'da yapılandırabilirsiniz, hem Linux hem de Windows Docker konteynerleri ile entegre ederek mikro hizmetler mimarisi içinde güçlü PDF işlevleri sağlar.

Docker içinde bir .NET kütüphaneyi dağıtmak için önerilen kurulum adımları nelerdir?

Önerilen adımlar arasında, IronPdf.Linux gibi Linux için optimize edilmiş bir paket kullanmak, otomatik bağımlılık kurulumlarını devre dışı bırakmak ve çalışma zamanında gecikmeleri önlemek için IronPDF'i önceden başlatmak yer alır.

.NET 6.0 çalıştıran bir Windows Server 2019 Docker konteynerine bir .NET PDF kütüphanesi nasıl kurulur?

.NET 6.0 ile birlikte IronPDF çalıştırmak için tüm gerekli bağımlılık ve yapılandırmaları içeren bir önceden yapılandırılmış Dockerfile kullanılarak bir Windows Server 2019 Docker konteynerinde bir .NET PDF kütüphanesi kurun.

.NET kütüphanesi için bir Docker kurulumunda GPU hızlandırmasını neden devre dışı bırakmalıyım?

IronPDF için Docker'da GPU hızlandırmayı devre dışı bırakmak, sınırlı GPU kaynaklarının olduğu ortamlarda olası grafik ile ilgili sorunları önleyerek daha akıcı bir dağıtım ve performans sağlayabilir.

Curtis Chau
Curtis Chau
  Mühendislik ekibiyle şimdi sohbet edin
Teknik Yazar

Curtis Chau, Bilgisayar Bilimleri alanında Lisans Derecesine (Carleton Üniversitesi) sahip ve Node.js, TypeScript, JavaScript ve React konularında uzmanlaşmış ön uç geliştirmeyle ilgileniyor. Sezgisel ve estetik açıdan hoş kullanıcı arayüzleri oluşturma tutkunu, Curtis modern çerçevelerle çalışmayı ve iyi yapı...

Daha Fazla Oku
Başlamaya Hazır mısınız?
Nuget İndirmeler 19,014,616 | Sürüm: 2026.5 just released
Still Scrolling Icon

Hâlâ Kaydırıyor Musunuz?

Hızlıca kanıt ister misiniz? PM > Install-Package IronPdf
bir örnek çalıştır HTML'nizi bir PDF'ye dönüştüğünü izleyin.