Rozwiązywanie problemów z wdrażaniem w usłudze Azure Linux App Service

Curtis Chau

Updated: 10 czerwca 2026

Download IronPDF

• NuGet Download
• DLL Download
• Windows Installer

• ---

• Start Free Trial

Copy for LLMs

• Copy for LLMs

  Copy page as Markdown for LLMs
  # Rozwiązywanie problemów z wdrażaniem w usłudze Azure Linux App Service Podczas wdrażania IronPDF w usłudze Azure Linux App Service aplikacja może nie być w stanie renderować dokumentów PDF z powodu brakujących bibliotek systemowych. Dzieje się tak, ponieważ środowiska Linux mają mniej zainstalowanych domyślnie pakietów niż Windows, a silnik renderujący IronPDF wymaga dodatkowych bibliotek współdzielonych do działania. ```txt Multiple issues occurred while trying to deploy Chrome (libatk-1.0.so.0: cannot open shared object file: No such file or directory) (IronInterop.so: cannot open shared object file: No such file or directory) (Read-only file system: '/home/site/wwwroot/runtimes') ``` Błąd oznacza, że jedna lub więcej bibliotek współdzielonych wymaganych przez `IronInterop.so` jest nieobecna w środowisku Linux. Uruchomienie `ldd IronInterop.so` z konsoli SSH na usłudze aplikacji pozwala dokładnie zidentyfikować, które biblioteki są brakujące. Komunikat o systemie plików tylko do odczytu dla folderu environments to oddzielny objaw tego samego stanu brakujących zależności. ## Rozwiązanie ### Krok 1: Identyfikacja brakujących zależności 1. Wdróż usługę aplikacji z poziomu Visual Studio jak zwykle. 2. Otwórz konsolę SSH dla swojej usługi Azure Linux App Service. 3. Przejdź do katalogu wwwroot: ```txt cd /home/site/wwwroot ``` 4. Uruchom `ldd` na binarce natywnej, aby wymienić nierozwiązane zależności: ```txt ldd IronInterop.so ``` 5. Sprawdź wersję systemu operacyjnego, aby potwierdzić, które nazwy pakietów mają zastosowanie: ```txt cat /etc/os-release ``` ### Krok 2: Instalacja brakujących bibliotek Dla większości dystrybucji Linux (obrazów opartych na Debian/Ubuntu), zainstaluj wymagane pakiety używając: ```txt apt-get update && apt-get install -y libatk1.0-0 libatk-bridge2.0-0 libcups2 libdrm2 libxcomposite1 libxdamage1 libxfixes3 libxrandr2 libgbm1 libxkbcommon0 libasound2 libatspi2.0-0 ``` Dla obrazów Ubuntu 24.04 (używanych z .NET 10), użyj poniższej instrukcji Dockerfile, ponieważ niektóre nazwy pakietów uległy zmianie: ```dockerfile RUN apt update \ && apt install -y sudo libxkbcommon-x11-0 libc6 libc6-dev libgtk2.0-0 libnss3 libatk-bridge2.0-0 libx11-xcb1 libxcb-dri3-0 libdrm-common libgbm1 libasound2t64 libxrender1 libfontconfig1 libxshmfence1 libgdiplus libva-dev ``` ### Krok 3: Weryfikacja rozwiązania wszystkich zależności Uruchom ponownie `ldd`, aby potwierdzić, że nie ma już nierozwiązanych wpisów: ```txt ldd IronInterop.so ``` Wszystkie wpisy powinny pokazywać rozwiązana ścieżkę zamiast `not found`. Kiedy wszystkie zależności są na miejscu, renderowanie PDF przez aplikację webową będzie działać normalnie. Dla pełnej listy wymaganych pakietów w różnych dystrybucjach Linux zobacz [przewodnik wdrażania dla Linux](/get-started/linux/).

• ---

• Open in ChatGPT

  Ask ChatGPT about this page
• Open in Gemini

  Ask Gemini about this page
• Open in Grok

  Ask Grok about this page
• Open in Perplexity

  Ask Perplexity about this page

Share

• Share on Facebook
• Share on X (Twitter)
• Share on LinkedIn

• ---

• Email article

Podczas wdrażania IronPDF w usłudze Azure Linux App Service aplikacja może nie być w stanie renderować dokumentów PDF z powodu brakujących bibliotek systemowych. Dzieje się tak, ponieważ środowiska Linux mają mniej zainstalowanych domyślnie pakietów niż Windows, a silnik renderujący IronPDF wymaga dodatkowych bibliotek współdzielonych do działania.

Multiple issues occurred while trying to deploy Chrome (libatk-1.0.so.0: cannot open shared object file: No such file or directory) (IronInterop.so: cannot open shared object file: No such file or directory) (Read-only file system: '/home/site/wwwroot/runtimes')

Multiple issues occurred while trying to deploy Chrome (libatk-1.0.so.0: cannot open shared object file: No such file or directory) (IronInterop.so: cannot open shared object file: No such file or directory) (Read-only file system: '/home/site/wwwroot/runtimes')

Błąd oznacza, że jedna lub więcej bibliotek współdzielonych wymaganych przez IronInterop.so jest nieobecna w środowisku Linux. Uruchomienie ldd IronInterop.so z konsoli SSH na usłudze aplikacji pozwala dokładnie zidentyfikować, które biblioteki są brakujące. Komunikat o systemie plików tylko do odczytu dla folderu environments to oddzielny objaw tego samego stanu brakujących zależności.

Rozwiązanie

Krok 1: Identyfikacja brakujących zależności

1. Wdróż usługę aplikacji z poziomu Visual Studio jak zwykle.
2. Otwórz konsolę SSH dla swojej usługi Azure Linux App Service.
3. Przejdź do katalogu wwwroot:

cd /home/site/wwwroot

cd /home/site/wwwroot

4. Uruchom ldd na binarce natywnej, aby wymienić nierozwiązane zależności:

ldd IronInterop.so

ldd IronInterop.so

5. Sprawdź wersję systemu operacyjnego, aby potwierdzić, które nazwy pakietów mają zastosowanie:

cat /etc/os-release

cat /etc/os-release

Krok 2: Instalacja brakujących bibliotek

Dla większości dystrybucji Linux (obrazów opartych na Debian/Ubuntu), zainstaluj wymagane pakiety używając:

apt-get update && apt-get install -y libatk1.0-0 libatk-bridge2.0-0 libcups2 libdrm2 libxcomposite1 libxdamage1 libxfixes3 libxrandr2 libgbm1 libxkbcommon0 libasound2 libatspi2.0-0

apt-get update && apt-get install -y libatk1.0-0 libatk-bridge2.0-0 libcups2 libdrm2 libxcomposite1 libxdamage1 libxfixes3 libxrandr2 libgbm1 libxkbcommon0 libasound2 libatspi2.0-0

Dla obrazów Ubuntu 24.04 (używanych z .NET 10), użyj poniższej instrukcji Dockerfile, ponieważ niektóre nazwy pakietów uległy zmianie:

RUN apt update \
    && apt install -y sudo libxkbcommon-x11-0 libc6 libc6-dev libgtk2.0-0 libnss3 libatk-bridge2.0-0 libx11-xcb1 libxcb-dri3-0 libdrm-common libgbm1 libasound2t64 libxrender1 libfontconfig1 libxshmfence1 libgdiplus libva-dev

RUN apt update \
    && apt install -y sudo libxkbcommon-x11-0 libc6 libc6-dev libgtk2.0-0 libnss3 libatk-bridge2.0-0 libx11-xcb1 libxcb-dri3-0 libdrm-common libgbm1 libasound2t64 libxrender1 libfontconfig1 libxshmfence1 libgdiplus libva-dev

Krok 3: Weryfikacja rozwiązania wszystkich zależności

Uruchom ponownie ldd, aby potwierdzić, że nie ma już nierozwiązanych wpisów:

ldd IronInterop.so

ldd IronInterop.so

Wszystkie wpisy powinny pokazywać rozwiązana ścieżkę zamiast not found. Kiedy wszystkie zależności są na miejscu, renderowanie PDF przez aplikację webową będzie działać normalnie. Dla pełnej listy wymaganych pakietów w różnych dystrybucjach Linux zobacz przewodnik wdrażania dla Linux.

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