Dodawanie IronPDF do istniejącego kontenera Docker
IronPDF for .NET Standard w pełni obsługuje teraz Docker, w tym kontenery Azure Docker dla systemów Linux i Windows.
Czy chcesz wdrożyć IronPDF jako oddzielny kontener Docker? Dowiedz się więcej o przewodniku po samouczkach IronPdfEngine.
Dlaczego warto korzystać z Docker na platformie Azure?
Oprócz doskonałej skalowalności w środowisku Enterprise, kontenery Docker na platformie Azure mają więcej uprawnień niż zwykłe aplikacje internetowe. Umożliwia to renderowanie czcionek SVG, ponieważ włączony jest dostęp systemu do grafiki GDI+.
IronPDF i Linux Primer
Jeśli Docker z .NET jest dla Ciebie nowością, polecamy ten znakomity artykuł na temat konfiguracji debugowania w Dockerze i integracji z projektami Visual Studio.
Zdecydowanie zalecamy również zapoznanie się z naszym Przewodnikiem po konfiguracji i kompatybilności IronPDF dla systemu Linux.
Zalecane dystrybucje Docker dla systemu Linux
Zalecamy najnowsze 64-bitowe systemy operacyjne Linux wymienione poniżej, aby zapewnić "łatwą konfigurację" IronPDF.
- Ubuntu 24 (Noble)
- Ubuntu 22
- Ubuntu 20
- Ubuntu 18
- Debian 11
- Debian 10
- CentOS 8
- Amazon AWS Linux 2 Przeczytaj przewodnik konfiguracji IronPDF AWS Lambda
Zalecamy korzystanie z oficjalnych obrazów Docker firmy Microsoft dla platformy .NET. Inne dystrybucje Linuksa są częściowo obsługiwane, ale mogą wymagać ręcznej konfiguracji. Zobacz nasz przewodnik "Konfiguracja ręczna w systemie Linux".
Instalacja IronPDF na systemie Linux w środowisku Docker
Korzystaj z pakietów NuGet zoptymalizowanych pod kątem systemu Linux
Zalecamy użycie pakietu IronPdf.Linux NuGet zamiast zwykłego pakietu IronPDF, aby zaoszczędzić miejsce na dysku i uniknąć pobierania zasobów podczas uruchamiania instancji Docker. Nie martw się, nadal działa podczas programowania w systemie Windows lub macOS — jest po prostu zoptymalizowany pod kątem systemu Linux.
Install-Package IronPdf.Linux
Innym rozwiązaniem jest po prostu dodanie IronPdf.Native.Chrome.Linux do standardowego pakietu IronPDF NuGet.
Install-Package IronPdf.Native.Chrome.Linux
Unikaj automatycznej instalacji zależności
Wielu użytkowników zgłasza lepsze wyniki w systemie Linux i Dockerze, gdy LinuxAndDockerDependenciesAutoConfig jest ustawione na false. Wynika to z faktu, że wymagane komponenty są już zainstalowane przez menedżery pakietów typu 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
Wyłącz przyspieszenie GPU
Kontenery Docker w systemie Linux często nie mają dostępu do procesora graficznego (GPU). Przyspieszenie GPU jest domyślnie wyłączone. Jeśli włączyłeś ChromeGpuModes.Enabled, zdecydowanie zalecamy wyłączenie tej opcji w przypadku 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
Pliki Docker dla systemu Ubuntu Linux
Ubuntu 24 z .NET 10
Ubuntu 24.04 (Noble) wykorzystuje 64-bitowe pakiety przejściowe time_t, więc nazwy niektórych bibliotek różnią się od tych w wcześniejszych wersjach 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 połączeniu z Ubuntu 24.04 LTS to popularna kombinacja produkcyjna. Obowiązują te same nazwy bibliotek przejściowych 64-bitowych.
# 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 systemu Debian Linux
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 Alpine Linux
Uruchamianie IronPDF w systemie Alpine Linux nie jest obsługiwane. Chcielibyśmy, ale nie możemy. Szczerze mówiąc, podoba nam się Alpine i mamy nadzieję, że ten projekt będzie kontynuowany i się rozwijał. W 2023 r. Alpine nadal korzysta z przestarzałych bibliotek języka C "musl", które nie pozwalają programistom Chromium na pełną obsługę tego systemu operacyjnego.
Korzystanie z Alpine Docker z IronPdfEngine w .NET 6
IronPDF udostępnia obraz kontenera zawierający wszystkie funkcje IronPDF. Umożliwia to projektom działającym na platformie Alpine dostęp do funkcji IronPD poprzez połączenie z kontenerem IronPdfEngine.
Krok 1: Pobierz i uruchom obraz Docker silnika IronPDF
W terminalu wykonaj następujące polecenia, aby pobrać i uruchomić obraz Docker silnika IronPDF:
# Pull the IronPDF Engine Docker Image
docker pull ironsoftwareofficial/ironpdfengine
# Pull the IronPDF Engine Docker Image
docker pull ironsoftwareofficial/ironpdfengine
# 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
Krok 2: Skonfiguruj aplikację konsolową
Utwórz nową aplikację konsolową przeznaczoną dla platformy .NET 6. Zainstaluj pakiet IronPdf.Slim NuGet za pomocą menedżera pakietów NuGet.
Plik Docker dla systemu Windows
Kontenery Docker dla systemu Windows stają się coraz bardziej popularne w platformie Azure, ponieważ oferują wyższy poziom wydajności i skalowalności oraz dają programistom większe uprawnienia do konfigurowania instancji.
IronPDF zapewni w rzeczywistości bardziej atrakcyjne renderowanie tekstu w kontenerze Docker (Windows lub Linux) na platformie Azure dzięki wyższemu poziomowi dostępu do biblioteki graficznej i wirtualnej karty graficznej.
Artykuł "Visual Studio Container Tools for Docker" to naprawdę świetny przewodnik dla początkujących.
Oto przykładowy plik Dockerfile kontenera Windows dla .NET Core 3.1
Windows Server 2019 .NET 6.0
Wstępnie skonfigurowane kontenery Windows zawierają wszystkie zależności niezbędne do uruchomienia IronPDF.
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.
Dłączego 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.

