1. IronPDF
  2. Rozpocznij
  3. Hostowanie i używanie IronPdfEngine w Dockerze
Jak korzystać z silnika IronPDF w Dockerze | IronPDF

Uruchom IronPDF jako zdalny kontener

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

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.

Dłączego 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 IronPdfEngine w wersji 2023.2.1. 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 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żna 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ę:

: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

Skonfiguruj IronPDF dla kontenera Docker

Bez Docker Compose

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

  • Docker musi być zainstalowany.

Konfiguracja

  1. Przejdź do https://hub.docker.com/r/ironsoftwareofficial/ironpdfengine
  2. 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
  1. 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 środowiska uruchomieniowego można przekazać 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 Domyślny 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 ścieżka — Ś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 ścieżka — 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 ścieżka — Niestandardowy katalog dla binariów wdrożenia Chrome
temp_folder_path ścieżka — 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 jednoprocesówym
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. chrome_gpu_mode powinien pozostać 0 (Wyłączony) w Dockerze, chyba że Twój host zapewnia przepustowość GPU.

Zmienna środowiskowa IRONPDF_ENGINE_LICENSE_KEY może być również użyta do ustawienia klucza licencyjnego poprzez -e lub 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

  1. 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 ścieżka 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. Ustaw adres IronPdfEngine wewnątrz twojej aplikacji (myconsoleapp) na "myironpdfengine:33350"
  2. 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!

: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

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.

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

OstrzeżenieNależy pamiętać, że w tym przypadku wymagany jest ten pdf.Dispose.

: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

Alternatywna metoda z WithCustomChannel

Alternatywną metodą byłoby wykorzystanie metody WithCustomChannel udostępnionej przez IronPdf.GrpcLayer.

WithCustomChannel przyjmuje dwa parametry: customChannel, który jest Twoim niestandardowym kanałem gRPC, oraz metadata. Parametr metadata jest opcjonalny i domyślnie ma wartość null.

: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

Wdróż IronPdfEngine na AWS ECS

Wymagania wstępne

Konfiguracja

  1. Utwórz klaster ECS. Postepuj zgodnie z tym przewodnikiem tworzenia klastra dla typow uruchamiania Fargate i External uzywajac konsoli.
  2. 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"
}
  • 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.
  1. 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.
  1. 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

Konfiguracja

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

Wymagania wstępne

  • Docker musi być zainstalowany.

Konfiguracja

  1. Przejdź do https://gallery.ecr.aws/v1m9w8y1/ironpdfengine
  2. 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
  1. 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

Rynek Azure

Konfiguracja

  1. Przejdź do IronPDF Docker Container na Rynek Azure. Kliknij "Pobierz teraz" i "Kontynuuj."
  2. Uzupełnij "Podstawy", "Szczegóły klastra" i "Szczegóły aplikacji", aby utworzyć usługę Kubernetes.
  3. 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
Usługa Kubernetes - uruchom polecenie

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

: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

Rynek AWS

aws marketplace

Wymagania wstępne

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

Konfiguracja

  1. Przejdź do IronPdfEngine na rynku AWS. Kliknij 'Przejdź do subskrypcji.'

  2. Zaakceptuj warunki.
Zaakceptuj EULA
  1. Przejdź do konfiguracji.
Subskrypcja zakończona
  1. Pobierz obraz ironpdfengine. Ten krok pokaże Ci polecenie do pobrania obrazu ironpdfengine.
Uruchom to oprogramowanie

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

Ponieważ sprawdzamy obecność IronPdfEngine, zastępujemy nazwę usługi IronPdfEngine.

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

Status

Jak widać w odpowiedzi, status odpowiedzi to SERVING, co oznacza, że usługa działa. Jeśli kontener nie działa poprawnie, odpowiedź statusowa będzie brzmiała 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
YAML

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

Czytaj więcej
Gotowy, aby rozpocząć?
Nuget Pliki do pobrania 18,926,724 | Wersja: 2026.5 just released
Still Scrolling Icon

Wciąż przewijasz?

Czy chcesz szybko dowodu? PM > Install-Package IronPdf
Uruchom przykład i zobacz, jak Twój kod HTML zamienia się w plik PDF.