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

Curtis Chau

Updated: 19 Mayıs 2026

Download IronPDF

• NuGet Download
• DLL Download
• Windows Installer

• ---

• Start Free Trial

Copy for LLMs

• Copy for LLMs

  Copy page as Markdown for LLMs

• ---

• Open in ChatGPT

  Ask ChatGPT about this page
• Open in Gemini

  Ask Gemini about this page
• Open in Grok

  Ask Grok about this page
• Open in Perplexity

  Ask Perplexity about this page

Share

• Share on Facebook
• Share on X (Twitter)
• Share on LinkedIn

• ---

• Email article

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 sürümünü 2023.2.1 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ılmıyor, bu yüzden 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:

string ironPdfEngineVersion = IronPdf.Installation.IronPdfEngineVersion;

string ironPdfEngineVersion = IronPdf.Installation.IronPdfEngineVersion;

Dim ironPdfEngineVersion As String = IronPdf.Installation.IronPdfEngineVersion

Dim ironPdfEngineVersion As String = IronPdf.Installation.IronPdfEngineVersion

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

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

docker pull ironsoftwareofficial/ironpdfengine:2025.3.6

docker pull ironsoftwareofficial/ironpdfengine:2025.3.6

3. 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

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

Çalışma zamanı parametreleri, görüntü adından sonra doğrudan key=value çiftleri olarak konteynıra 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

Aşağıdaki parametreler kullanılabilir:

| Parametre | Tür | Default | 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 | path | — | 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 | path | — | 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 | path | — | Chrome dağıtım ikili dosyaları için özel dizin | | temp_folder_path | path | — | 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 |

IRONPDF_ENGINE_LICENSE_KEY ortam değişkeni, lisans anahtarını -e veya environment: üzerinden Docker Compose ile 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

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

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. Docker Compose dosyanızı aşağıdaki şablonu kullanarak kurun:

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'

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'

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

IronPdfEngine'e Bağlanma

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

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

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

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

Bağlantı Türü

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.

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

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

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

WithCustomChannel ile Alternatif Yöntem

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

WithCustomChannel, iki parametre alır, biri özelleştirilmiş gRPC kanalınız olan customChannel, diğeri metadata. metadata parametresi isteğe bağlıdır ve varsayılan olarak null olarak ayarlanmıştır.

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

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

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

IronPdfEngine AWS ECS üzerine dağıtma

Ön Koşullar

• IronPdfEngine Docker imajını çekin. Bu, yukarıda Docker Konteyner için IronPDF'i Kurma kısmında yer almaktadır.
• ECS'ye erişimi olan bir AWS hesabı.

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"
  }

  JSON

• 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.

3. 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.

4. Keyfini çıkarın! IronPdfEngine docker AWS'nizde çalışıyor!

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

Ön Koşullar

• IronPdfEngine Docker imajını çekin. Bu, yukarıda Docker Konteyner için IronPDF'i Kurma kısmında yer almaktadır.
• Azure Hesabı

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
• Port: TCP Port 33350

2. Keyfini çıkarın! IronPdfEngine docker Azure Konteyner Örneklerinizde çalışıyor!

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

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

3. 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

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

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

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

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

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

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

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.

3. Şartları kabul edin.

4. Yapılandırmaya Devam Edin.

5. ironpdfengine görüntüsünü çekin. Bu adım, ironpdfengine imajını çekmek için komut gösterecek.

Ö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

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

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 {
 string service = 1; // Name of the service to check (e.g., "IronPdfEngine")
}

message HealthCheckRequest {
 string service = 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.

Yanıttan görebileceğiniz gibi, durum yanıtı SERVING, hizmetin aktif ve çalışır durumda olduğunu gösteriyor. Konteynır sağlıklı değilse, durum yanıtı NOT_SERVING olacaktır.

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

Curtis Chau

Chat with engineering team now

Technical Writer

Curtis Chau holds a Bachelor’s degree in Computer Science (Carleton University) and specializes in front-end development with expertise in Node.js, TypeScript, JavaScript, and React. Passionate about crafting intuitive and aesthetically pleasing user interfaces, Curtis enjoys working with modern frameworks and creating well-structured, visually appealing manuals.

...

Read More