1. .NET
  2. Başlamak için
  3. Docker'da IronPdfEngine'i barındır ve kullan
IronPDF Motorunu Docker'da Nasıl Kullanılır | IronPDF

IronPDF'i Uzaktan Konteyner Olarak Çalıştırma

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

IronPdfEngine, PDF'leri oluşturma, yazma, düzenleme ve okuma işlemlerini gerçekleştirebilen bağımsız bir hizmettir. IronPDF Docker, uyumlu IronPDF sürümleriyle (v2023.2.x ve üstü) docker hizmetlerini çalıştırmaya hazırdır. Bu, geliştiricilerin IronPDF ile karşılaştıkları dağıtım sorunlarını ortadan kaldırmalarına yardımcı olacaktır.

IronPDF'in kendi konteyneri olarak çalıştırılmasının iyi bir fikir olmasının nedeni

IronPDF, çalıştırmak için hem Chrome hem de Pdfium ikili dosyalarına ihtiyaç duyar ve bunlar dosya boyutu açısından büyüktür (yüzlerce MB). Ayrıca makineye birkaç bağımlılığın kurulmasını gerektirir.

Bu yöntemi kullanarak, müşteriniz boyutun sadece bir kısmını kaplayacaktır (MB olarak).

Dağıtım Sorunlarını Önleyin

Çevreyi/konteyneri tüm bağımlılıkları düzgün bir şekilde içerecek şekilde yapılandırmak zorlu olabilir. IronPDF Docker konteynerini kullanmak, IronPDF'in önceden yüklenmiş ve çalışacağı garanti edilen bir şekilde gelmesi anlamına gelir, böylece tüm dağıtım ve bağımlılık sorunlarından kaçınır.

Sürümler

IronPDF Docker etiketi, IronPdfEngine'in kendi versiyonuna dayanır. Bu, IronPDF ürününün aynı versiyonu değildir.

Her IronPDF sürümü, kendi ilişkili IronPdfEngine sürümüne sahip olacaktır. Sürüm numarası mutlaka IronPDF Docker versiyonu ile eşleşmelidir.

Örneğin, IronPDF for Java sürümü 2023.2.1, IronPdfEngine 2023.2.1 sürümünü gerektirir. Uyumsuz IronPdfEngine ve IronPDF sürümlerini kullanamazsınız.

IronPDF Docker nasıl kullanılır

IronPDF Kurulumu

Projenize IronPdf.Slim NuGet paketini ekleyin.

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

Not: IronPdf, IronPdf.Linux ve IronPdf.MacOs paketlerinin tümü IronPdf.Slim içerir.

Uygulamanızın boyutunu azaltmak için sadece IronPdf.Slim'i yüklemenizi tavsiye ederiz. IronPdf.Native.Chrome.xxx paketi artık kullanılmamaktadır, bu nedenle projenizden kaldırabilirsiniz.

Gerekli Konteyner Sürümünü Belirleme

Varsayılan olarak, Docker için IronPDF sürümü, NuGet üzerindeki mevcut IronPDF sürümü ile eşleşecektir. Versiyonu manuel olarak kontrol etmek için aşağıdaki kodu kullanabilirsiniz:

: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
$vbLabelText   $csharpLabel

Docker Konteyner için IronPDF'i Kurma

Docker Compose Olmadan

Önceki adımda belirtilen sürümü kullanarak docker konteynerini çalıştırın.

  • Docker kurulmuş olmalıdır.

Kurulum

  1. https://hub.docker.com/r/ironsoftwareofficial/ironpdfengine adresine gidin
  2. En son ironsoftwareofficial/ironpdfengine görüntüsünü çekin
docker pull ironsoftwareofficial/ironpdfengine
docker pull ironsoftwareofficial/ironpdfengine
SHELL

Veya belirli bir sürümü çekin (önerilir)

docker pull ironsoftwareofficial/ironpdfengine:2025.3.6
docker pull ironsoftwareofficial/ironpdfengine:2025.3.6
SHELL
  1. ironsoftwareofficial/ironpdfengine konteynerini çalıştırın.

Bu komut bir konteyner oluşturacak ve arka planda 33350 numaralı portla çalıştıracaktır

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
SHELL

IronPdfEngine Çalışma Zamanı Parametreleri Nasıl Yapılandırılır?

Çalışma zamanı parametreleri, görüntü adından sonra key=value çiftleri olarak doğrudan kapsayıcıya aktarılabilir. Bunlar, motor davranışını yeniden yapılandırmaya gerek kalmadan yapılandırır.

docker run -d -p 33350:33350 ironsoftwareofficial/ironpdfengine:2025.3.6 \
  license_key="YOUR_LICENSE_KEY" \
  enable_debug=true \
  chrome_browser_limit=8
docker run -d -p 33350:33350 ironsoftwareofficial/ironpdfengine:2025.3.6 \
  license_key="YOUR_LICENSE_KEY" \
  enable_debug=true \
  chrome_browser_limit=8
SHELL

Aşağıdaki parametreler kullanılabilir:

Parametre Tür Varsayılan Açıklama
port int 33350 gRPC dinleme portu
license_key string — IronPDF lisans anahtarı
enable_debug bool false Tam hata ayıklama günlüğünü etkinleştir
log_path yol — Günlük dosyası yolu (tam hata ayıklama günlüğünü de etkinleştirir)
logging_mode string Console Günlük modu: Yok, Konsol, Özel, Hata Çıkışı Penceresi, Dosya, Tümü
chrome_browser_limit int — Maksimum eşzamanlı Chrome tarayıcı örnekleri
chrome_cache_path yol — Chrome tarayıcı önbelleği dizini
chrome_gpu_mode int 0 GPU modu: 0 Devre Dışı, 1 Donanım, 2 DonanımTam, 3 Yazılım
chrome_custom_deployment_dir yol — Chrome dağıtım ikili dosyaları için özel dizin
temp_folder_path yol — Geçici dizini geçersiz kıl
skip_shutdown bool false Motorun boşta iken kapanmasını engelle
skip_initialization bool false Başlangıçta Chrome/Pdfium başlatmayı atla
keep_alive bool false Müşteri bağlantısı kesildikten sonra motoru çalışır halde tut
single_process bool — Chrome'u tek süreçli modda çalıştır
linux_and_docker_auto_config bool true Linux/Docker bağımlılıklarını otomatik yapılandır (Docker giriş noktası tarafından otomatik olarak ayarlanır)
send_anonymous_analytics_and_crash_data bool — Anonim telemetriyi etkinleştir veya devre dışı bırak

Lütfen dikkate alınlinux_and_docker_auto_config parametresi, Docker giriş noktası tarafından otomatik olarak true olarak ayarlanır. Manuel olarak geçirmenize gerek yok. chrome_gpu_mode, ana bilgisayarınız GPU passthrough sağlamadıkça Docker'da 0 (Devre Dışı) olarak kalmalıdır.

IRONPDF_ENGINE_LICENSE_KEY ortam değişkeni, Docker Compose'da -e veya environment: aracılığıyla lisans anahtarını ayarlamak için de kullanılabilir. Komut satırı parametreleri, her ikisi de ayarlandığında ortam değişkenlerine öncelik verir.

Üretim örneği:

docker run -d --restart=unless-stopped \
  -p 33350:33350 \
  -e IRONPDF_ENGINE_LICENSE_KEY=MY_KEY \
  ironsoftwareofficial/ironpdfengine \
  chrome_browser_limit=8 skip_shutdown=true
docker run -d --restart=unless-stopped \
  -p 33350:33350 \
  -e IRONPDF_ENGINE_LICENSE_KEY=MY_KEY \
  ironsoftwareofficial/ironpdfengine \
  chrome_browser_limit=8 skip_shutdown=true
SHELL

Hata ayıklama örneği:

docker run -p 33350:33350 \
  ironsoftwareofficial/ironpdfengine \
  enable_debug=true log_path=/app/logs/engine.log
docker run -p 33350:33350 \
  ironsoftwareofficial/ironpdfengine \
  enable_debug=true log_path=/app/logs/engine.log
SHELL

Docker Compose ile

Anahtar, IronPdfEngine ve uygulamanızın birbirini görebileceği bir Docker ağı kurmaktır. 'depends_on'u ayarlayın, böylece IronPdfEngine uygulamanız başlamadan önce yükselecektir.

Kurulum

  1. docker-compose.yml dosyası oluşturarak başlayın. Aşağıdaki şablonu kullanarak Docker Compose dosyanızı ayarlayın:
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 yol 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'
  1. Uygulamanızda (myconsoleapp) IronPdfEngine adresini 'myironpdfengine:33350' olarak ayarlayın
  2. docker compose çalıştırın
docker compose up --detach --force-recreate --remove-orphans --timestamps
docker compose up --detach --force-recreate --remove-orphans --timestamps
SHELL

IronPdfEngine'e Bağlanma

IronPDF kodunuzu çalıştırın; uygulamanız artık Docker'daki IronPdfEngine ile iletişim kuruyor!

: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")
$vbLabelText   $csharpLabel

Bağlantı Türü

Yapmak istediğiniz bağlantı türüne bağlı olarak atayabileceğiniz birkaç IronPdfConnectionType vardır.

İşte mevcut özelliklerin bir listesi:

LocalExecutable: Yerel makinenizde bir uygulama çalıştıran bir IronPdfEngine "sunucusu" ile bağlantı kurmak için bu seçeneği kullanırız. Çabuk bir örnek, bulut hizmetleri olmadan yerel olarak PDF üreten bir WinForm faturalama uygulaması olabilir.

Docker: Docker konteynerine ya yerel olarak ya da bulutta bağlanmaya çalışırken bu seçenek kullanılmalıdır.

Uzaktan Sunucu: Buluttaki IronPdfEngine için bu seçenek kullanılır. Bu, HTTP veya HTTPS protokolü aracılığıyla bulut barındırmalı (örneğin, Docker) IronPdfEngine örneğine bağlanır. Dikkat edin ki, bu uzak bir sunucuya bağlanma olduğundan, tam URL gereklidir (HTTP veya HTTPS protokolü dahil).

Özel: Bağlantı üzerinde tam kontrol ve özelleştirme için bu seçeneği kullanabilirsiniz. Bu seçenek, yukarıdaki diğer tanımlı seçenekler yerine sizin özel tanımlanmış Grpc.Core.ChannelBase ile kullanılır. Geliştiriciler, yeni bir Grpc.Core.Channel obje yaratarak veya Grpc.Net.Client.GrpcChannel.ForAddress(System.String) kullanarak yeni bir kanal oluşturabilir ve gRPC kanalı üzerinde özel ve eksiksiz bir kontrol sağlayabilir.

.NET Framework ile NetFrameworkChannel

.NET Framework için, çünkü gRPC .NET Framework projelerinde farklı çalışır, farklı bir kurulum gereklidir. Bu yöntemin çalışması için, Grpc.Core NuGet paketinin yüklendiğinden emin olun. Bu özel kurulum için Grpc.Core.ChannelBase'den türetilmiş bir özel gRPC kanalı kullanacağız.

IronPDFEngine kullanarak bir PDF oluşturmak ve kaydetmek için bağlantı kanalını nasıl uygulayacağımızı bu örnekte ele alalım.

İpuçlarıgRPC, .NET Framework projesinde farklı şekilde çalıştığından, aşağıdaki kod çalışmıyorsa adresdeki <http> veya <https> önekini kaldırmayı deneyin.

UyarıBu durumda pdf.Dispose'nin gerekli olduğunu lütfen unutmayın.

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

' This code demonstrates how to use IronPdf with gRPC in a .NET Framework application.

' 1. Configure connection to use local IronPdfEngine executable
Dim 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
Dim renderer As New ChromePdfRenderer()

' 4. Render HTML string as PDF document
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("Hello world")

' 5. Save the PDF to disk
pdf.SaveAs("output.pdf")

' 6. Clean up, this is needed to work
pdf.Dispose()
$vbLabelText   $csharpLabel

WithCustomChannel ile Alternatif Yöntem

Alternatif bir yöntem, IronPdf.GrpcLayer tarafından sağlanan WithCustomChannel yöntemini kullanmak olabilir.

WithCustomChannel iki parametre alır: customChannel, yani özel gRPC kanalınız ve metadata. metadata parametresi isteğe bağlıdır ve varsayılan olarak null olarak ayarlanmıştır.

: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();
Imports IronPdf
Imports IronPdf.GrpcLayer
Imports Grpc.Core

' 1. Create custom gRPC channel (.NET Framework style)
Dim channel As New Channel("123.456.7.8:80", ChannelCredentials.SecureSsl)

' 2. (Optional) Add metadata headers if needed
Dim metadata As New Metadata From {
    {"Authorization", "Bearer your_token_here"}
}

' 3. Configure IronPDF with custom channel
Dim config As IronPdfConnectionConfiguration = IronPdfConnectionConfiguration.WithCustomChannel(channel, metadata)
IronPdf.Installation.ConnectToIronPdfHost(config)

' 4. Generate PDF
Dim renderer As New ChromePdfRenderer()
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("Hello world")

' 5. Save the PDF to disk
pdf.SaveAs("output.pdf")

' 6. Clean up, this is needed to work
pdf.Dispose()
$vbLabelText   $csharpLabel

IronPdfEngine AWS ECS üzerine dağıtma

Ön Koşullar

Ayarlar

  1. Bir ECS Kümesi oluşturun. Bu kılavuzu takip ederek konsol kullanarak Fargate ve Dış Başlatma türleri için bir küme oluşturun.
  2. Bir görev tanımı oluşturun. Konsolu kullanarak bir görev tanımı oluşturmaya yönelik rehber 'i takip edin.

Önerilen ayarlar:

  • AWS Fargate
  • Minimum 1 vCPU ve 2 GB RAM önerilir. Gişe yükünüz ve ister PDF'lerle daha fazla sayfa içeren, ister ağır yük talepleri alan yorucu işler, daha yüksek bir sınıf seçin.
  • Ağ modu: awsvpc
  • Port eşlemeleri: 
    {
  "containerPort": 33350,
  "hostPort": 33350,
  "protocol": "tcp",
  "appProtocol": "grpc"
}
  • Görüntü URI'si: Bizden herhangi bir IronPdfEngine'e işaret edin. Örneğin, "ironsoftwareofficial/ironpdfengine:2024.1.20" (DockerHub üzerinden)
  • AWS İzin & Ağ sizi kendi sorumluluğunuzda
  • Amazon CloudWatch'u Etkinleştir önerilir. (Enable logging)
  • Konteyner başlatma sırası aynı görev tanımında uygulama konteynerinizi dağıtmak istiyorsanız gereklidir.
  1. Bir görev tanımı çalıştırın. Bir görev tanımını ya Görev ya da Hizmet olarak çalıştırabilirsiniz. Konsolu kullanarak bir hizmet oluşturmaya yönelik rehber 'ı takip edin.

Önerilen ayarlar:

  • Başlatma türü: AWS Fargate
  • Genel IP: Açık test için ve Kapatı üretim için. Güvenlik ve AWS Ağlandırma kendi başınızı sorumluluğuna bırakılmıştır.
  1. Keyfini çıkarın! IronPdfEngine docker AWS'nizde çalışıyor!

Lütfen dikkate alınIronPdfEngine Docker konteyneri yatay ölçeklendirmeyi desteklemez; Tek örnekli bir arka uç hizmeti olarak tasarlanmıştır. IronPDF kütüphanesini (IronPdfEngine ile veya IronPdfEngine olmadan) kullanan uygulamanız, birden fazla uygulama örneği dağıtarak yine de yatay olarak ölçeklenebilir. Daha fazla ayrıntı için IronPdfEngine Sınırlamaları'na bakın.

IronPdfEngine'i Azure Konteyner Örneği üzerinde dağıtma

Ön Koşullar

Ayarlar

  1. Bir Azure Konteyner oluşturun. Azure portalını kullanarak Azure'da bir konteyner örneği dağıtmaya yönelik kılavuzu takip edin.

Önerilen ayarlar:

  • Görüntü kaynağı: Diğer kayıt defteri
  • Resim: ironsoftwareofficial/ironpdfengine:2024.1.20 (Docker Hub üzerinden)
  • OS türü: Linux
  • Boyut: Minimum 1 vCPU ve 2 GiB bellek veya daha yüksek
  • Bağlantı Noktası: TCP Bağlantı Noktası 33350
  1. Keyfini çıkarın! IronPdfEngine docker Azure Konteyner Örneklerinizde çalışıyor!

Lütfen dikkate alınIronPdfEngine Docker konteyneri yatay ölçeklendirmeyi desteklemez; tek örnekli bir arka uç hizmeti olarak tasarlanmıştır. IronPDF kütüphanesini (IronPdfEngine ile veya IronPdfEngine olmadan) kullanan uygulamanız, birden fazla uygulama örneği dağıtarak yine de yatay olarak ölçeklenebilir. Daha fazla bilgi için IronPdfEngine Sınırlamaları'na bakın.

IronPdfEngine'i AWS ECR Açık Galerisinde Edinme

Ön Koşullar

  • Docker kurulmuş olmalıdır.

Ayarlar

  1. https://gallery.ecr.aws/v1m9w8y1/ironpdfengine adresine gidin
  2. v1m9w8y1/ironpdfengine görüntüsünü çekin
docker pull https://gallery.ecr.aws/v1m9w8y1/ironpdfengine
docker pull https://gallery.ecr.aws/v1m9w8y1/ironpdfengine
SHELL

Veya belirli bir sürümü çekin (önerilir)

docker pull https://gallery.ecr.aws/v1m9w8y1/ironpdfengine:2023.12.6
docker pull https://gallery.ecr.aws/v1m9w8y1/ironpdfengine:2023.12.6
SHELL
  1. ironpdfengine konteynerini çalıştırın.

Bu komut bir konteyner oluşturacak ve arka planda 33350 numaralı portla çalıştıracaktır

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

IronPdfEngine'i kullanmak için IronPDF istemcisini nasıl yapılandıracağınızı öğrenmek için 'Kodu IronPdfEngine kullanacak şekilde güncelleyin' bölümüne gidin.

Pazardan IronPdfEngine Alın

Hızlı bir şekilde başlamanıza yardımcı olmak için IronPdfEngine'i hem Azure hem de AWS Marketplaces üzerine kurduk.

Azure Marketplace

Azure Marketplace

Kurulum

Azure Marketplace'te IronPDF Docker Konteyneri üzerine gidin. "Şimdi Al" ve "Devam Et" üzerine tıklayın. "Temel Bilgiler", "Küme Detayları" ve "Uygulama Detayları" bölümlerini tamamlayarak Kubernetes hizmetini oluşturun. Dağıtım tamamlandıktan sonra, sol kenar çubuğuna gidin ve Kubernetes kaynakları> Komut çalıştır'ı seçin. Aşağıdaki komutu çalıştırın:

kubectl get services
kubectl get services
SHELL
Kubernetes hizmeti - komut çalıştır

EXTERNAL-IP ve PORT(S) bilgileriyle, IronPDFEngine bağlantısını uygun biçimde yapılandırabilirsiniz.

: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")
$vbLabelText   $csharpLabel

AWS Marketplace

aws marketplace

Önkoşullar

  • Docker kurulmuş olmalıdır.
  • AWS CLI kurulmuş ve giriş yapılmış olmalıdır.

Kurulum

AWS marketplace'te IronPdfEngine üzerinde gidin. 'Devam Etmek İçin Üye Ol' üzerine tıklayın.

  1. Şartları kabul edin.
EULA kabul et
  1. Yapılandırmaya Devam Edin.
Üyelik tamamlandı
  1. ironpdfengine görüntüsünü çekin. Bu adım, ironpdfengine imajını çekmek için komut gösterecek.
Bu yazılımı başlat

Örneğin:

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
SHELL

ironpdfengine konteynerini çalıştırın. Bu komut bir konteyner oluşturacak ve arka planda 33350 portuyla çalıştıracaktır.

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
SHELL

IronPdfEngine Sağlık Kontrolü

Docker Konteynerinizin sağlığını kontrol etmek, üretim ortamında güvenilirlik ve bulunabilirliği sağlamak için kritik öneme sahiptir. IronPdfEngine Docker konteynerini kontrol etme yeteneği, hizmetin arıza durumda yeniden başlatılmasına olanak tanır ve talep arttığında kaynakları ölçekte tutmakla birlikte sürekli bir uygulamayı izlemeyi sağlamakta olur.

IronPdfEngine'in sağlığını kontrol etmek için, aynı IronPdfEngine portuna (varsayılan olarak, 33350 olur) bir gRPC isteği göndererek bir yanıt alıp almadığımızı doğrulayabiliriz.

gRPC ile Sağlık Kontrolü

IronPdfEngine, standart gRPC sağlık kontrolü modeline uyar ve aşağıdaki protokol yapısını kullanır.

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

IronPdfEngine'i kontrol ettiğimiz için, hizmet adını IronPdfEngine ile değiştiriyoruz.

33350 varsayılan numarası ile yerel IronPdfEngine hizmetine bir gRPC isteği göndermek için JavaScript kullanarak Postman ile bir örnek.

Durum

Yanıtta da görebileceğiniz gibi, durum yanıtı SERVING olup, hizmetin çalışır durumda olduğunu gösterir. Konteyner sağlıklı değilse, durum yanıtı NOT_SERVING olur.

Kubernetes Kurulumu ile Sağlık Kontrolü

Kubernetes kurulumları için, hizmetin sağlıklı olup olmadığını kontrol etmek için aşağıdakileri kullanabiliriz.

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

Sıkça Sorulan Sorular

Docker kullanarak C# ile HTML'i PDF'ye nasıl dönüştürebilirim?

IronPDF'in Docker kurulumu ile HTML'i C# içinde PDF'ye dönüştürebilirsiniz. bir Docker konteynerinde IronPdfEngine'i dağıtın ve RenderHtmlAsPdf gibi yöntemleri kullanarak bunu başarın.

Docker'da IronPdfEngine kullanmanın faydaları nelerdir?

IronPdfEngine'i Docker'da kullanmak, bağımlılık sorunlarını azaltan ve Chrome ile Pdfium ikili dosyaları gibi tüm gerekli bileşenlerin hazır bulunduğu önceden yüklenmiş ve güvenilir bir ortam sunar.

Docker Compose ile IronPdfEngine nasıl kurulum yapılır?

Bir docker-compose.yml dosyası oluşturun ve hizmetler ile ağları tanımlayın. depends_on direktifini kullanarak IronPdfEngine'in uygulamanızdan önce başlamasını sağlayın.

AWS ECS üzerinde IronPdfEngine'i dağıtmak için hangi adımlar gereklidir?

AWS ECS üzerinde dağıtım yapmak için, bir ECS Kümesi oluşturun, bir görev tanımı yapın ve kaynak tahsisi için AWS Fargate kullanın. Ardından IronPdfEngine'i başlatmak için görevinizi veya hizmetinizi çalıştırın.

AWS ECR Genel Galerisinden IronPdfEngine'i nasıl çekebilirim?

AWS ECR Genel Galerisine erişin, IronPdfEngine görüntüsünü bulun ve kontenjanı çekmek ve çalıştırmak için sağlanan komutları takip edin.

IronPdfEngine'i Azure Marketplace üzerinden kullanmak mümkün mü?

Evet, IronPdfEngine Azure Marketplace üzerinde mevcuttur. Docker konteynerini dağıtmak için Marketplace sayfasındaki kurulum talimatlarını takip edebilirsiniz.

IronPdfEngine kullanırken nelere dikkat etmeliyim?

IronPdfEngine Docker konteyneri, tek örnekli bir arka uç hizmeti olarak tasarlandığından yatay ölçeklendirmeyi desteklemez. Ancak, IronPDF kütüphanesini (IronPdfEngine ile veya IronPdfEngine olmadan) kullanan uygulamalar, birden fazla uygulama örneği dağıtarak yine de yatay olarak ölçeklenebilir. Dağıtımınızı bu ayrımı göz önünde bulundurarak planlayın.

Docker ile PDF oluşturma ve manipülasyon görevlerini verimli bir şekilde nasıl yönetebilirim?

IronPdfEngine'i bir Docker konteynerinde dağıtarak PDF oluşturma ve manipülasyon görevlerini etkili bir şekilde yönetin, bağımlılıkları ele almak ve tutarlı bir ortam sağlamak için Docker'ın yeteneklerinden yararlanın.

Azure Konteyner Örneklerine IronPdfEngine'i dağıtmak için gereklilikler nelerdir?

Azure Konteyner Örneklerine dağıtım yapmak için bir Azure hesabına sahip olduğunuzdan emin olun ve dağıtım için IronPdfEngine Docker görüntüsünü çekin.

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.