Dodawanie IronPDF do istniejącego kontenera Docker

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

IronPDF for .NET Standard teraz w pelni obsługuje Docker, włączajac Azure Docker Containers dla Linux i Windows.

Czy chcesz wdrożyć IronPDF jako osobny kontener Docker? Dowiedz sie więcej o przewodniku turorialowym IronPDFEngine.

Logo Docker
Logo Azure
Logo Linux
Logo AWS
Logo Windows

Dlaczego używać Docker na Azure?

Oprocz doskonalej skalowalnosci enterprise, kontenery Docker na Azure posiadaja więcej uprawnien niz zwykle aplikacje WebApps. Pozwala to na renderowanie czcionek SVG, poniewaz dostep do grafiki GDI+ jest możliwy.

IronPDF i Linux: Wprowadzenie

Jeśli Docker z .NET jest ci nowy, polecamy ten znakomity artykuł o konfiguracji debugowania Docker i integracji z projektami Visual Studio.

Zalecamy rowniez przeczytanie naszego przewodnika ustawien i kompatybilnosci IronPDF Linux.

Zalecane dystrybucje Linux Docker

Zalecamy najnowsze 64-bitowe systemy Linux, wymienione poniżej, dla 'łatwej konfiguracji' IronPDF.

Zalecamy korzystanie z Oficjalnych obrazów Docker dla .NET od Microsoft. Inne dystrybucje Linux sa częściowo wspierane, ale mogą wymagac recznej konfiguracji. Zobacz nasz przewodnik "Ręczna konfiguracja Linux".

Instalacja IronPDF dla Docker Linux

używać zoptymalizowane pakiety NuGet dla Linux

Zalecamy uzycie pakietu NuGet IronPdf.Linux zamiast standardowego pakietu IronPDF, aby zaoszczedzic miejsce na dysku i uniknac pobierania zasobow przy uruchamianiu instancji Docker. Nie martw się, nadal działa przy rozwijaniu na Windows lub macOS - jest po prostu zoptymalizowany dla Linux.

Install-Package IronPdf.Linux

Innym rozwiazaniem jest dodanie pakietu IronPdf.Native.Chrome.Linux na szczycie standardowego pakietu NuGet IronPDF.

Install-Package IronPdf.Native.Chrome.Linux

Unikaj automatycznej instalacji zależności

Wielu użytkowników zgłasza lepsze wyniki na Linux i Docker, gdy LinuxAndDockerDependenciesAutoConfig jest ustawiony na false. To dlatego, że wymagane pakiety są już zainstalowane przez menedżery pakietów w stylu apt-get w twoich plikach Docker.

:path=/static-assets/pdf/content-code-examples/get-started/ironpdf-docker-3.cs
// Disable automatic configuration of Linux and Docker dependencies
IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = false;
Imports IronPdf

' Disable automatic configuration of Linux and Docker dependencies
IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = False
$vbLabelText   $csharpLabel

Wyłącz przyspieszenie GPU

Kontenery Docker Linux często nie mają dostępu do GPU. Przyspieszenie GPU jest domyślnie wyłączone. Jeśli włączyłeś ChromeGpuModes.Enabled, zalecamy wyłączenie go dla wdrożeń w Docker:

:path=/static-assets/pdf/content-code-examples/get-started/ironpdf-docker-4.cs
// Disable GPU acceleration for Docker environments
IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;
' Disable GPU acceleration for Docker environments
IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled
$vbLabelText   $csharpLabel

Pliki Docker dla Linux Ubuntu

Logo Docker
Logo Ubuntu

Ubuntu 24 z .NET 10

Ubuntu 24.04 (Noble) używa 64-bitowych pakietów time_t transition, więc niektóre nazwy bibliotek różnią się od wcześniejszych wersji Ubuntu (np. libasound2t64 zamiast libasound2).

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

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

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

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

Ubuntu 24 z .NET 8

.NET 8 LTS w polaczeniu z Ubuntu 24.04 LTS to powszechna kombinacja produkcyjna. Obowiazuja te same nazwy bibliotek przejsciowych 64-bit.

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

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

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

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

Ubuntu 22 z .NET 8

Ubuntu 22 z .NET 7

Ubuntu 20 z .NET 6

Ubuntu 20 z .NET 5

Ubuntu 20 z .NET 3.1 LTS

Ubuntu 18 z .NET 3.1 LTS

Pliki Docker dla Linux Debian

Logo Docker
Logo Debian

Debian 12 z .NET 8

Debian 11 z .NET 7

Debian 11 z .NET 6

Debian 11 z .NET 5

Debian 11 z .NET 3.1 LTS

Debian 10 z .NET 5

Debian 10 z .NET 3.1 LTS

Pliki Docker dla Linux Alpine

Uruchamianie IronPDF na Alpine Linux nie jest wspierane. Chcielibyśmy, żebyśmy mogli, ale nie możemy. Szczerze, lubimy Alpine i mamy nadzieję, że ten projekt będzie się rozwijał. Na 2023 rok Alpine wciąż używa przestarzałych bibliotek języka C 'musl', które nie pozwalają deweloperom Chromium w pełni wspierać tego systemu.

Użycie Docker Alpine z IronPdfEngine w .NET 6

IronPDF dostarcza obraz kontenera zawierający wszystkie funkcjonalności IronPDF. To umożliwia projektom działającym na Alpine dostęp do funkcjonalności IronPDF poprzez połączenie z kontenerem IronPdfEngine.

Krok 1: Pobranie i uruchomienie obrazu Docker IronPDF Engine

Wykonaj poniższe polecenia w terminalu, aby pobrać i uruchomić obraz Docker IronPDF Engine:

# Pull the IronPDF Engine Docker Image
docker pull ironsoftwareofficial/ironpdfengine
# Pull the IronPDF Engine Docker Image
docker pull ironsoftwareofficial/ironpdfengine
SHELL
# Run the IronPDF Engine Docker container
docker run -d -p 33350:33350 ironsoftwareofficial/ironpdfengine
# Run the IronPDF Engine Docker container
docker run -d -p 33350:33350 ironsoftwareofficial/ironpdfengine
SHELL

Krok 2: Konfiguracja aplikacji konsolowej

Utwórz nową aplikację konsolową celującą na .NET 6. Zainstaluj pakiet NuGet IronPdf.Slim za pomocą Menedżera Pakietów NuGet.

Plik Docker dla Windows

Logo Docker
Logo Windows

Kontenery Docker dla Windows zyskują coraz większą popularność na platformie Azure, ponieważ oferują wyższy poziom wydajności i skalowalności oraz dają programistom więcej uprawnień do konfiguracji instancji.

IronPDF rzeczywiście zapewni bardziej atrakcyjne renderowanie tekstu wewnątrz kontenera Docker (Windows lub Linux) na platformie Azure z powodu wyższego poziomu dostępu do biblioteki graficznej i wirtualnej karty graficznej.

Artykuł 'Visual Studio Container Tools for Docker' to naprawdę świetny przewodnik na początek.

To przykład pliku Docker dla kontenera Windows dla .NET Core 3.1

Windows Server 2019 .NET 6.0

Wstępnie skonfigurowane kontenery Windows zawierają wszystkie niezbędne zależności do uruchamiania IronPDF.

Zwróć uwagęZauważ, że te kontenery nie są przeznaczone do BUDOWY aplikacji .NET, ale raczej do ICH URUCHAMIANIA.

Odwiedź repozytorium Docker, aby zapoznać się z dodatkowymi wstępnie skonfigurowanymi obrazami do uruchamiania IronPDF.

Często Zadawane Pytania

Jak mogę zintegrować bibliotekę .NET do generowania plików PDF z kontenerem Docker?

Możesz zintegrować IronPDF, bibliotekę .NET do generowania plików PDF, z kontenerem Docker, korzystając z oficjalnych obrazów Docker firmy Microsoft i pakietu IronPdf.Linux NuGet dla systemu Linux lub wstępnie skonfigurowanych kontenerów Docker dla środowisk Windows.

Jakie są zalety korzystania z kontenerów Docker do obróbki plików PDF w Azure?

Wykorzystanie kontenerów Docker do manipulacji plikami PDF w Azure zapewnia lepszą skalowalność w Enterprise i więcej uprawnień niż zwykłe aplikacje internetowe. Taka konfiguracja jest idealna do korzystania z zaawansowanych funkcji, takich jak renderowanie czcionek SVG poprzez dostęp do grafiki GDI+.

Które dystrybucje Linuksa najlepiej nadają się do uruchamiania biblioteki .NET PDF w Dockerze?

Najbardziej odpowiednie dystrybucje Linuksa do uruchamiania IronPDF w Dockerze to Ubuntu 18/20/22, Debian 10/11, CentOS 8 i Amazon AWS Linux 2, ponieważ oferują one prostą konfigurację i kompatybilność.

Jak mogę zoptymalizować wydajność biblioteki .NET do obsługi plików PDF w kontenerach Docker w systemie Linux?

Aby zoptymalizować wydajność, należy użyć pakietu IronPdf.Linux, wyłączyć automatyczną instalację zależności oraz wyłączyć przyspieszenie GPU, konfigurując IronPdf.Installation.ChromeGpuMode na IronPdf.Engines.Chrome.ChromeGpuModes.Disabłęd.

Czy IronPDF może działać na systemie Alpine Linux w kontenerze Docker?

IronPDF nie obsługuje natywnie systemu Alpine Linux ze względu na niekompatybilne biblioteki „musl”. Aby korzystać z IronPDF w systemie Alpine Linux, rozważ uruchomienie go za pośrednictwem kontenera Docker IronPdfEngine.

Jaki jest cel stosowania wstępnie skonfigurowanych kontenerów Docker dla biblioteki .NET?

Wstępnie skonfigurowane kontenery Docker zapewniają wszystkie niezbędne zależności do wydajnego działania IronPDF, gwarantując wysoką wydajność i skalowalność, co jest szczególnie korzystne podczas wdrażania na platformach takich jak Azure.

Jak skonfigurować bibliotekę .NET PDF dla aplikacji .NET w Dockerze?

Możesz skonfigurować IronPDF for .NET w Dockerze, integrując go zarówno z kontenerami Docker dla systemów Linux, jak i Windows, co umożliwi korzystanie z rozbudowanych funkcji PDF w architekturze mikrousług.

Jakie są zalecane kroki konfiguracji w celu wdrożenia biblioteki .NET w Dockerze?

Zalecane kroki obejmują użycie pakietu zoptymalizowanego pod kątem systemu Linux, takiego jak IronPdf.Linux, wyłączenie automatycznej instalacji zależności oraz wstępną inicjalizację IronPDF w celu zapobiegania opóźnieniom podczas działania w środowiskach Docker.

Jak skonfigurować bibliotekę .NET PDF w kontenerze Docker na Windows Server 2019 z uruchomionym .NET 6.0?

Skonfiguruj bibliotekę .NET PDF w kontenerze Docker na serwerze Windows Server 2019, korzystając z wstępnie skonfigurowanego pliku Dockerfile, który zawiera wszystkie niezbędne zależności i konfiguracje do uruchomienia IronPDF z .NET 6.0.

Dlaczego warto wyłączyć przyspieszenie GPU w konfiguracji Docker dla biblioteki .NET?

Wyłączenie przyspieszenia GPU dla IronPDF w Dockerze może zapewnić płynniejsze wdrażanie i lepszą wydajność poprzez uniknięcie potencjalnych problemów związanych z grafiką w środowiskach, w których zasoby GPU są ograniczone.

Curtis Chau
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 19,936,792 | Wersja: 2026.7 właśnie wydany
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.