Uruchom IronPDF jako zdalny kontener

Q: Jak skonfigurować IronPdfEngine za pomocą Docker Compose?

Utwórz plik docker-compose.yml i zdefiniuj usługi oraz sieci. Upewnij się, że IronPdfEngine uruchamia się przed aplikacją, używając dyrektywy depends_on .

Curtis Chau

Updated: 19 maja 2026

IronPdfEngine to samodzielna usługa, która może obsługiwać tworzenie, zapisywanie, edytowanie i czytanie plików PDF. IronPDF Docker jest gotowy do uruchamiania usług docker z kompatybilnymi wersjami IronPDF (v2023.2.x i nowszymi). To pomoże programistom wyeliminować problemy z wdrażaniem, których mogą doświadczać z IronPDF.

Dlaczego uruchamianie IronPDF jako osobnego kontenera to dobry pomysł

IronPDF wymaga zarówno Chrome, jak i binariów Pdfium do działania, które są ogromne (setki MB). Wymaga również zainstalowania kilku zależności na komputerze.

Korzystając z tej metody, twój klient zajmie tylko część rozmiaru (w MB).

Uniknięcie problemów z wdrożeniem

Może być wyzwaniem skonfigurowanie środowiska/kontenera tak, aby poprawnie uwzględniało wszystkie zależności. Korzystanie z kontenera Docker IronPDF oznacza, że IronPDF jest wstępnie zainstalowany i gwarantowany do działania, unikając wszelkich problemów z wdrożeniem i zależnościami.

Wersje

Tag Docker IronPDF opiera się na wersji samego IronPdfEngine. Nie jest to ta sama wersja co produkt IronPDF.

Każda wersja IronPDF będzie miała swoją własną związaną wersję IronPdfEngine. Numer wersji musi zgadzać się z wersją Docker IronPDF.

Na przykład, wersja IronPDF for Java wymaga wersji 2023.2.1 IronPdfEngine. Nie można używać niepasujących wersji IronPdfEngine i IronPDF.

Jak używać IronPDF Docker

Zainstaluj IronPDF

Dodaj pakiet IronPdf.Slim NuGet do swojego projektu.

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

Uwaga: pakiety IronPdf, IronPdf.Linux i IronPdf.MacOs wszystkie zawierają IronPdf.Slim.

Aby zmniejszyć rozmiar aplikacji, zalecamy zainstalowanie tylko IronPdf.Slim. Pakiet IronPdf.Native.Chrome.xxx nie jest już używany, więc możesz go usunąć z projektu.

Określenie wymaganej wersji kontenera

Domyślnie, wersja IronPDF dla Docker będzie odpowiadać aktualnej wersji IronPDF na NuGet. Możesz użyć poniższego kodu, aby ręcznie sprawdzić wersję:

string ironPdfEngineVersion = IronPdf.Installation.IronPdfEngineVersion;

string ironPdfEngineVersion = IronPdf.Installation.IronPdfEngineVersion;

Dim ironPdfEngineVersion As String = IronPdf.Installation.IronPdfEngineVersion

Dim ironPdfEngineVersion As String = IronPdf.Installation.IronPdfEngineVersion

Skonfiguruj IronPDF dla kontenera Docker

Bez Docker Compose

Uruchom kontener docker używając wersji z poprzedniego kroku.

Docker musi być zainstalowany.

Konfiguracja

Przejdź do https://hub.docker.com/r/ironsoftwareofficial/ironpdfengine
Pobierz najnowszy obraz ironsoftwareofficial/ironpdfengine

docker pull ironsoftwareofficial/ironpdfengine

docker pull ironsoftwareofficial/ironpdfengine

SHELL

Lub pobierz konkretną wersję (zalecane)

docker pull ironsoftwareofficial/ironpdfengine:2025.3.6

docker pull ironsoftwareofficial/ironpdfengine:2025.3.6

SHELL

Uruchom kontener ironsoftwareofficial/ironpdfengine.

Polecenie to utworzy kontener i uruchomi go w tle z portem 33350

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

Jak skonfigurować parametry czasu wykonania IronPdfEngine?

Parametry uruchomieniowe mogą być przekazywane bezpośrednio do kontenera jako pary key=value po nazwie obrazu. Te konfigurują zachowanie silnika bez potrzeby przebudowywania obrazu.

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

Dostępne są następujące parametry:

Parametr	Typ	Default	Opis
`port`	int	`33350`	gRPC nasłuchujący port
`license_key`	string	—	Klucz licencyjny IronPDF
`enable_debug`	bool	`false`	Włącz pełne logowanie debugowania
`log_path`	path	—	Ścieżka pliku logu (również włącza pełne logowanie debugowania)
`logging_mode`	string	`Console`	Tryb logowania: Brak, Konsola, Niestandardowy, Okno wyjścia debugowania, Plik, Wszystko
`chrome_browser_limit`	int	—	Maksymalna liczba jednoczesnych instancji przeglądarki Chrome
`chrome_cache_path`	path	—	Katalog dla pamięci cache przeglądarki Chrome
`chrome_gpu_mode`	int	`0`	Tryb GPU: 0 Wyłączone, 1 Sprzęt, 2 Pełny sprzęt, 3 Oprogramowanie
`chrome_custom_deployment_dir`	path	—	Niestandardowy katalog dla binariów wdrożenia Chrome
`temp_folder_path`	path	—	Zastąp katalog tymczasowy
`skip_shutdown`	bool	`false`	Zapobiegaj zamykaniu silnika, gdy jest bezczynny
`skip_initialization`	bool	`false`	Pomiń inicjalizację Chrome/Pdfium przy starcie
`keep_alive`	bool	`false`	Utrzymuj uruchomiony silnik po rozłączeniu klienta
`single_process`	bool	—	Uruchom Chrome w trybie jednoprocesowym
`linux_and_docker_auto_config`	bool	`true`	Automatyczna konfiguracja zależności Linux/Docker (ustawiony automatycznie przez punkt wejścia Docker)
`send_anonymous_analytics_and_crash_data`	bool	—	Włącz lub wyłącz anonimową telemetrię

Zwróć uwagę: Parametr linux_and_docker_auto_config jest automatycznie ustawiany na true przez punkt wejścia Docker. Nie musisz go przekazywać ręcznie. W Dockerze chrome_gpu_mode powinno pozostać 0 (wyłączone), chyba że twój host udostępnia GPU passthrough.

Zmienne środowiskowe IRONPDF_ENGINE_LICENSE_KEY można również użyć do ustawienia klucza licencyjnego za pomocą -e albo environment: w Docker Compose. Parametry wiersza poleceń mają pierwszeństwo przed zmiennymi środowiskowymi, gdy oba są ustawione.

Przykład produkcji:

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

Przykład debugowania:

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

Z Docker Compose

Kluczowe jest ustawienie sieci Docker, która pozwala IronPdfEngine i twojej aplikacji widzieć się nawzajem. Ustaw 'depends_on', aby upewnić się, że IronPdfEngine jest uruchomiony, zanim twoja aplikacja wystartuje.

Konfiguracja

Zacznij od utworzenia pliku docker-compose.yml. Skonfiguruj plik Docker Compose korzystając z poniższego szablonu:

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'

Text

Ustaw adres IronPdfEngine wewnątrz twojej aplikacji (myconsoleapp) na "myironpdfengine:33350"
Uruchom docker compose

docker compose up --detach --force-recreate --remove-orphans --timestamps

docker compose up --detach --force-recreate --remove-orphans --timestamps

SHELL

Połącz się z IronPdfEngine

Uruchom swój kod IronPDF; twoja aplikacja teraz komunikuje się z IronPdfEngine w Docker!

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

Typ połączenia

Istnieje kilka IronPdfConnectionType, które można przypisać w zależności od typu połączenia, które chcesz nawiązać.

Oto lista dostępnych właściwości:

LocalExecutable: Aby polaczyc sie z "serwerem" IronPdfEngine uruchamianym na lokalnym komputerze, korzystamy z tej opcji. Szybki przykład to aplikacja fakturowania WinForm, która generuje pliki PDF lokalnie bez polegania na usługach w chmurze.

Docker: Tę opcję należy użyć, gdy próbujemy połączyć się z kontenerem Docker lokalnie lub w chmurze.

RemoteServer: Ta opcja jest używana dla IronPdfEngine w chmurze. Łączy się z instancją IronPdfEngine hostowaną w chmurze (np. Docker) przez protokół HTTP lub HTTPS. Zauważ, że ponieważ łączy się z serwerem zdalnym, wymagany jest pełny URL (w tym protokół HTTP lub HTTPS).

Custom: Dla pełnej kontroli i personalizacji połączenia, można użyć tej opcji. Opcja ta używa zdefiniowanego własnoręcznie Grpc.Core.ChannelBase zamiast innych zdefiniowanych opcji powyżej. Programiści mogą tworzyć nowy kanał tworząc nowy obiekt Grpc.Core.Channel lub używając Grpc.Net.Client.GrpcChannel.ForAddress(System.String) dla pełnej kontroli nad kanałem gRPC.

.NET Framework z NetFrameworkChannel

Dla .NET Framework, wymagana jest inna konfiguracja, ponieważ gRPC działa inaczej w projektach .NET Framework. Aby ta metoda działała, upewnij się, że pakiet NuGet Grpc.Core jest zainstalowany. Użyjemy niestandardowego kanału gRPC wyprowadzonego z Grpc.Core.ChannelBase dla tej konkretnej konfiguracji.

Przyjrzyjmy się temu przykładowi, gdzie wdrożymy kanał połączenia do tworzenia i zapisywania plików PDF przy użyciu IronPdfEngine.

Porady: Ponieważ gRPC działa inaczej w projekcie .NET Framework, jeśli poniższy kod nie działa, spróbuj usunąć prefiks <http> lub <https> w adresie.

Ostrzeżenie: Należy zauważyć, że w tym przypadku wymagane jest 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();

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

Alternatywna metoda z WithCustomChannel

Alternatywna metoda wykorzystuje metodę WithCustomChannel dostarczoną przez IronPdf.GrpcLayer.

WithCustomChannel akceptuje dwa parametry: customChannel, który jest twoim niestandardowym kanałem gRPC, oraz metadata. Parametr metadata jest opcjonalny i domyślnie ustawiony na null.

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

Wdróż IronPdfEngine na AWS ECS

Wymagania wstępne

Pobierz obraz Docker IronPdfEngine. To jest opisane w powyżej Konfiguracja kontenera Docker dla IronPDF.
Konto AWS z dostępem do ECS.

Konfiguracja

Utwórz klaster ECS. Postepuj zgodnie z tym przewodnikiem tworzenia klastra dla typow uruchamiania Fargate i External uzywajac konsoli.
Utwórz definicję zadania. Postępuj zgodnie z tym przewodnikiem tworzenia definicji zadania używając konsoli.

Zalecane ustawienia:

AWS Fargate
Zalecana jest minimalna 1 vCPU z 2 GB RAM. W zależności od obciążenia pracą, jeśli pracujesz z plikami PDF zawierającymi więcej niż 10 stron lub doświadczasz dużych żądań obciążenia, wybierz wyższy poziom.
Tryb sieciowy: awsvpc

Mapowanie portów:

{
  "containerPort": 33350,
  "hostPort": 33350,
  "protocol": "tcp",
  "appProtocol": "grpc"
}

{
  "containerPort": 33350,
  "hostPort": 33350,
  "protocol": "tcp",
  "appProtocol": "grpc"
}

JSON

URI obrazu: wskaż dowolny IronPdfEngine od nas. Na przykład, "ironsoftwareofficial/ironpdfengine:2024.1.20" (z DockerHub)
Uprawnienia AWS & Sieciowanie są na twojej własnej odpowiedzialności
Włącz Amazon CloudWatch jest zalecane. (Enable logging)
Kolejność uruchamiania kontenera jest konieczna, jeśli chcesz wdrożyć kontener aplikacji w tej samej definicji zadania.

Uruchom definicję zadania. Możesz uruchomić definicję zadania jako Zadanie lub Usługa. Postępuj zgodnie z tym przewodnikiem o tworzeniu usługi używając konsoli.

Zalecane ustawienia:

Typ uruchomienia: AWS Fargate
Publiczny IP: Włączony dla testu i Wyłączony dla produkcji. Bezpieczeństwo i sieciowanie AWS są na twojej odpowiedzialności.

Ciesz się! IronPdfEngine docker działa w Twoim AWS!

Zwróć uwagę: Sam kontener Docker IronPdfEngine nie obsługuje skalowania poziomego; Została zaprojektowana jako usługa backendowa z pojedynczą instancją. Twoja aplikacja korzystająca z biblioteki IronPDF (z IronPdfEngine lub bez) nadal może skalować się horyzontalnie poprzez wdrożenie wielu instancji aplikacji. Więcej szczegółów można znaleźć w sekcji Ograniczenia IronPdfEngine.

Wdróż IronPdfEngine w Azure Container Instances

Wymagania wstępne

Pobierz obraz Docker IronPdfEngine. To jest opisane w powyżej Konfiguracja kontenera Docker dla IronPDF.
Konto Azure

Konfiguracja

Utwórz kontener Azure. Skorzystaj z tego przewodnika szybkiego startu na wdrożenie instancji kontenera w Azure przy użyciu portalu Azure.

Zalecane ustawienia:

Źródło obrazu: Inna rejestracja
Obraz: ironsoftwareofficial/ironpdfengine:2024.1.20 (z Docker Hub)
Typ systemu operacyjnego: Linux
Rozmiar: Minimum 1 vCPU i 2 GiB pamięci, lub więcej
Port: port TCP 33350

Ciesz się! IronPdfEngine docker działa w Twoich instancjach kontenera Azure!

Zwróć uwagę: Kontener Docker IronPdfEngine nie obsługuje skalowania poziomego; zaprojektowany jako usługa backendowa z pojedynczą instancją. Twoja aplikacja korzystająca z biblioteki IronPDF (z IronPdfEngine lub bez) nadal może skalować się horyzontalnie poprzez wdrożenie wielu instancji aplikacji. Więcej informacji można znaleźć w sekcji Ograniczenia IronPdfEngine.

Pobieranie IronPdfEngine w AWS ECR Public Gallery

Wymagania wstępne

Docker musi być zainstalowany.

Konfiguracja

Przejdź do https://gallery.ecr.aws/v1m9w8y1/ironpdfengine
Pobierz obraz v1m9w8y1/ironpdfengine

docker pull https://gallery.ecr.aws/v1m9w8y1/ironpdfengine

docker pull https://gallery.ecr.aws/v1m9w8y1/ironpdfengine

SHELL

Lub pobierz konkretną wersję (zalecane)

docker pull https://gallery.ecr.aws/v1m9w8y1/ironpdfengine:2023.12.6

docker pull https://gallery.ecr.aws/v1m9w8y1/ironpdfengine:2023.12.6

SHELL

Uruchom kontener ironpdfengine.

Polecenie to utworzy kontener i uruchomi go w tle z portem 33350

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

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

SHELL

Dowiedz sie, jak skonfigurowac klienta IronPDF, aby wykorzystac IronPdfEngine, przechodzac do sekcji "Aktualizuj kod, aby korzystac z IronPdfEngine."

Pobierz IronPdfEngine z Marketu

Aby pomóc Ci szybko rozpocząć, skonfigurowaliśmy IronPdfEngine zarówno w Azure, jak i na rynkach AWS.

Rynek Azure

Konfiguracja

Przejdź do IronPDF Docker Container na Rynek Azure. Kliknij "Pobierz teraz" i "Kontynuuj."
Uzupełnij "Podstawy", "Szczegóły klastra" i "Szczegóły aplikacji", aby utworzyć usługę Kubernetes.
Po zakończeniu wdrożenia, przejdź do lewego paska bocznego i wybierz Zasoby Kubernetes> Uruchom polecenie. Uruchom następujące polecenie:

kubectl get services

kubectl get services

SHELL

Z informacjami o EXTERNAL-IP i PORT(S), możesz skonfigurować połączenie IronPdfEngine zgodnie z potrzebami.

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

Rynek AWS

Wymagania wstępne

Docker musi być zainstalowany.
CLI AWS musi być zainstalowane i zalogowane.

Konfiguracja

Przejdź do IronPdfEngine na rynku AWS. Kliknij 'Przejdź do subskrypcji.'
Zaakceptuj warunki.

Przejdź do konfiguracji.

Pobierz obraz ironpdfengine. Ten krok pokaże Ci polecenie do pobrania obrazu ironpdfengine.

Na przykład:

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

Uruchom kontener ironpdfengine. To polecenie utworzy kontener i uruchomi go w tle z portem 33350.

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

Sprawdzenie kondycji dla IronPdfEngine

Sprawdzanie kondycji Twojego kontenera Docker jest kluczowe, aby zapewnić niezawodność i dostępność w środowisku produkcyjnym. Możliwość sprawdzenia kontenera Docker IronPdfEngine pozwala programistom zrestartować usługę, jeśli zawiedzie, oraz skalować zasoby, jeśli wzrośnie popyt razem z monitorowaniem ciągłej aplikacji.

Aby sprawdzić kondycję Twojego IronPdfEngine, możemy wysłać żądanie gRPC do tego samego portu IronPdfEngine (domyślnie będzie to 33350), aby zweryfikować, czy otrzymujemy odpowiedź.

Sprawdzenie kondycji z użyciem gRPC

IronPdfEngine stosuje się do standardowego wzorca sprawdzania kondycji gRPC, wykorzystując następującą strukturę protokołu.

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

Text

Ponieważ sprawdzamy IronPdfEngine, zastępujemy nazwę usługi przez IronPdfEngine.

Oto przykład użycia JavaScript z Postman do wysłania żądania gRPC do lokalnej usługi IronPdfEngine z domyślnym numerem 33350.

Jak można zauważyć w odpowiedzi, odpowiedź statusu jest SERVING, co oznacza, że usługa działa poprawnie. Jeśli kontener nie jest zdrowy, odpowiedź statusu będzie NOT_SERVING.

Sprawdzenie kondycji z ustawieniem Kubernetes

Dla ustawień Kubernetes, możemy użyć poniższego, aby sprawdzić, czy usługa jest zdrowa.

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

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

Text

Często Zadawane Pytania

Jak mogę przekonwertować HTML na PDF w języku C# przy użyciu Docker?

Możesz użyć konfiguracji Docker firmy IronPDF do konwersji HTML na PDF w języku C#. W tym celu wdróż IronPdfEngine w kontenerze Docker i użyj metod takich jak RenderHtmlAsPdf.

Jakie są zalety korzystania z IronPdfEngine w Dockerze?

Korzystanie z IronPdfEngine w Dockerze zapewnia wstępnie zainstalowane i niezawodne środowisko, ograniczając problemy z zależnościami i gwarantując dostępność wszystkich niezbędnych komponentów, takich jak pliki binarne Chrome i Pdfium.

Jak skonfigurować IronPdfEngine za pomocą Docker Compose?

Utwórz plik docker-compose.yml i zdefiniuj usługi oraz sieci. Upewnij się, że IronPdfEngine uruchamia się przed aplikacją, używając dyrektywy depends_on.

Jakie kroki są wymagane do wdrożenia IronPdfEngine na AWS ECS?

Aby wdrożyć rozwiązanie w AWS ECS, należy utworzyć klaster ECS, zdefiniować definicję zadania i użyć AWS Fargate do alokacji zasobów. Następnie należy uruchomić zadanie lub usługę, aby uruchomić IronPdfEngine.

Jak mogę pobrać IronPdfEngine z publicznej galerii AWS ECR?

Wejdź do publicznej galerii AWS ECR, znajdź obraz IronPdfEngine i postępuj zgodnie z podanymi poleceniami, aby pobrać i uruchomić kontener.

Czy można korzystać z IronPdfEngine z Azure Marketplace?

Tak, IronPdfEngine jest dostępny w Azure Marketplace. Możesz postępować zgodnie z instrukcjami konfiguracji na stronie Marketplace, aby wdrożyć kontener Docker.

O jakich ograniczeniach należy pamiętać podczas korzystania z IronPdfEngine?

Sam kontener Docker IronPdfEngine nie obsługuje skalowania horyzontalnego, ponieważ został zaprojektowany jako usługa backendowa z jedną instancją. Jednak aplikacje korzystające z biblioteki IronPDF (z IronPdfEngine lub bez) mogą nadal skalować się horyzontalnie poprzez wdrożenie wielu instancji aplikacji. Należy zaplanować wdrożenie, mając na uwadze tę różnicę.

Jak mogę efektywnie wykonywać zadania związane z generowaniem i edycją plików PDF za pomocą Docker?

Wdroż IronPdfEngine w kontenerze Docker, aby efektywnie zarządzać zadaniami związanymi z generowaniem i przetwarzaniem plików PDF, wykorzystując możliwości Docker do obsługi zależności i zapewnienia spójnego środowiska.

Jakie są wymagania dotyczące wdrożenia IronPdfEngine na Azure Container Instances?

Aby wdrożyć rozwiązanie w Azure Container Instances, upewnij się, że posiadasz konto Azure, a następnie pobierz obraz Docker IronPdfEngine w celu wdrożenia.

Curtis Chau

Czat z zespołem inżynierów teraz

Autor tekstów technicznych

Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podręczników.

...

Czytaj więcej

Gotowy, aby rozpocząć?

Nuget Downloads 20,667,543|Wersja:2026.7właśnie wydany

Pobierz z NuGet

Łączna liczba pobrań: 20,667,543

Zobacz licencje

Jak korzystać z silnika IronPDF w Dockerze

Zobacz na GitHubie

Zainstaluj za pomocą NuGet

Wersja: 2026.7

PM > Install-Package IronPdf

nuget.org/packages/IronPdf/

W Eksploratorze Rozwiązań, kliknij prawym przyciskiem Myszy na Odwołania, Zarządzaj pakietami NuGet
Wybierz opcję Przeglądaj i wyszukaj „IronPdf”
Wybierz pakiet i zainstaluj

Pobierz DLL

Wersja: 2026.7

Pobierz teraz

lub pobierz instalator Windows tutaj.

Pobierz i rozpakuj IronPDF do lokalizacji takiej jak ~/Libs w katalogu Solution
W Eksploratorze rozwiązań programu Visual Studio kliknij prawym przyciskiem myszy opcję Odwołania. Wybierz opcję Przeglądaj, „IronPdf.dll”

Licencje od 749 USD