Solución de Problemas de Despliegue para Azure Linux App Service

Curtis Chau

Updated: 10 de junio de 2026

Download IronPDF

• NuGet Download
• DLL Download
• Windows Installer

• ---

• Start Free Trial

Copy for LLMs

• Copy for LLMs

  Copy page as Markdown for LLMs
  # Solución de Problemas de Despliegue para Azure Linux App Service Al desplegar IronPDF en un Azure Linux App Service, la aplicación puede fallar al renderizar PDFs debido a bibliotecas del sistema faltantes. Esto ocurre porque los entornos Linux vienen con menos paquetes preinstalados que Windows, y el motor de renderizado de IronPDF requiere bibliotecas compartidas adicionales para operar. ```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') ``` El error significa que una o más bibliotecas compartidas requeridas por `IronInterop.so` están ausentes en el entorno Linux. Ejecutar `ldd IronInterop.so` desde la consola SSH en el servicio de la aplicación identifica exactamente qué bibliotecas faltan. El mensaje del sistema de archivos de solo lectura para la carpeta de runtimes es un síntoma separado de la misma condición de dependencia faltante. ## Solución ### Paso 1: Identificar dependencias faltantes 1. Despliegue el servicio de la aplicación desde Visual Studio como de costumbre. 2. Abra la consola SSH para su Azure Linux App Service. 3. Navegue al directorio wwwroot: ```txt cd /home/site/wwwroot ``` 4. Ejecute `ldd` contra el binario nativo para listar las dependencias no resueltas: ```txt ldd IronInterop.so ``` 5. Verifique la versión del SO para confirmar qué nombres de paquetes aplican: ```txt cat /etc/os-release ``` ### Paso 2: Instalar bibliotecas faltantes Para la mayoría de las distribuciones de Linux (imágenes basadas en Debian/Ubuntu), instale los paquetes requeridos con: ```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 ``` Para las imágenes de Ubuntu 24.04 (utilizadas con .NET 10), use la siguiente instrucción de Dockerfile en su lugar, ya que algunos nombres de paquetes han cambiado: ```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 ``` ### Paso 3: Verificar que todas las dependencias estén resueltas Ejecute `ldd` nuevamente para confirmar que no hay entradas no resueltas restantes: ```txt ldd IronInterop.so ``` Todas las entradas deben mostrar una ruta resuelta en lugar de `not found`. Una vez que todas las dependencias estén en su lugar, la renderización de PDF a través de la aplicación web funcionará normalmente. Para la lista completa de paquetes requeridos en distribuciones de Linux, consulte la [guía de despliegue de 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

Al desplegar IronPDF en un Azure Linux App Service, la aplicación puede fallar al renderizar PDFs debido a bibliotecas del sistema faltantes. Esto ocurre porque los entornos Linux vienen con menos paquetes preinstalados que Windows, y el motor de renderizado de IronPDF requiere bibliotecas compartidas adicionales para operar.

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')

El error significa que una o más bibliotecas compartidas requeridas por IronInterop.so están ausentes en el entorno Linux. Ejecutar ldd IronInterop.so desde la consola SSH en el servicio de la aplicación identifica exactamente qué bibliotecas faltan. El mensaje del sistema de archivos de solo lectura para la carpeta de runtimes es un síntoma separado de la misma condición de dependencia faltante.

Solución

Paso 1: Identificar dependencias faltantes

1. Despliegue el servicio de la aplicación desde Visual Studio como de costumbre.
2. Abra la consola SSH para su Azure Linux App Service.
3. Navegue al directorio wwwroot:

cd /home/site/wwwroot

cd /home/site/wwwroot

4. Ejecute ldd contra el binario nativo para listar las dependencias no resueltas:

ldd IronInterop.so

ldd IronInterop.so

5. Verifique la versión del SO para confirmar qué nombres de paquetes aplican:

cat /etc/os-release

cat /etc/os-release

Paso 2: Instalar bibliotecas faltantes

Para la mayoría de las distribuciones de Linux (imágenes basadas en Debian/Ubuntu), instale los paquetes requeridos con:

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

Para las imágenes de Ubuntu 24.04 (utilizadas con .NET 10), use la siguiente instrucción de Dockerfile en su lugar, ya que algunos nombres de paquetes han cambiado:

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

Paso 3: Verificar que todas las dependencias estén resueltas

Ejecute ldd nuevamente para confirmar que no hay entradas no resueltas restantes:

ldd IronInterop.so

ldd IronInterop.so

Todas las entradas deben mostrar una ruta resuelta en lugar de not found. Una vez que todas las dependencias estén en su lugar, la renderización de PDF a través de la aplicación web funcionará normalmente. Para la lista completa de paquetes requeridos en distribuciones de Linux, consulte la guía de despliegue de Linux.

Curtis Chau

Chatea con el equipo de ingeniería ahora

Escritor Técnico

Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien estructurados y visualmente atractivos.

...

Leer más