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 pełni obsługuje Docker, włączając Azure Docker Containers dla Linux i Windows.

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

Logo Docker
Logo Azure
Logo Linux
Logo AWS
Logo Windows

Dlaczego używać Docker na Azure?

Oprócz doskonałej skalowalności enterprise, kontenery Docker na Azure posiadają więcej uprawnień niż zwykłe aplikacje WebApps. Pozwala to na renderowanie czcionek SVG, ponieważ dostęp 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.

Serdecznie polecamy również przeczytanie naszego przewodnika konfiguracji i kompatybilności IronPDF dla 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 są częściowo wspierane, ale mogą wymagać ręcznej konfiguracji. Zobacz nasz przewodnik "Ręczna konfiguracja Linux".

Instalacja IronPDF dla Docker Linux

Używać zoptymalizowane pakiety NuGet dla Linux

Zalecamy korzystanie z pakietu NuGet IronPdf.Linux zamiast zwykłego pakietu IronPdf, aby zaoszczędzić miejsce na dysku i uniknąć pobierania zasobów podczas uruchamiania kontenera Docker. Nie martw się, nadal działa przy rozwijaniu na Windows lub macOS - jest po prostu zoptymalizowany dla Linux.

Install-Package IronPdf.Linux

Innym rozwiązaniem jest dodanie IronPdf.Native.Chrome.Linux na szczycie zwykłego pakietu NuGet IronPdf.

Install-Package IronPdf.Native.Chrome.Linux

Unikaj automatycznej instalacji zależności

Wielu użytkowników zgłasza lepsze wyniki z Linux i Docker, gdy LinuxAndDockerDependenciesAutoConfig jest ustawione na false. Dzieje się tak, ponieważ wymogi są już zainstalowane przez menedżery pakietów stylu apt-get w plikach Docker.

// Disable automatic configuration of Linux and Docker dependencies
IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = false;
// Disable automatic configuration of Linux and Docker dependencies
IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = false;
' 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, zdecydowanie zalecamy jego wyłączenie dla wdrożeń Docker:

// 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;
' 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 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.Disabled.

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 srodowiskach, 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 18,560,885 | Wersja: 2026.4 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.