Solucionar Problemas de Despliegue de IronPDF en Google Cloud Run

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

IronPDF falla al generar PDFs o se bloquea cuando se despliega en Google Cloud Run de 1ra Generación. Tres modos de falla son comunes:

  • Aplicación se bloquea o produce errores de segmentación durante la generación de PDF
  • Fallos de dependencia causados por la falta de bibliotecas gráficas como libglib2.0-0, libxkbcommon-x11-0, y libgtk2.0-0
  • Errores de GPU o renderizado cuando el entorno carece de soporte de aceleración gráfica

Google Cloud Run de 1ra Generación utiliza el kernel 4.4.0 de Linux, que carece del soporte requerido por el renderizador basado en Chrome de IronPDF. El entorno de 2da Generación utiliza el kernel 6.4.10 y resuelve estos problemas de compatibilidad.

Solución

Paso 1: Cambia al entorno de ejecución de 2da Generación

Agrega --execution-environment gen2 a tu comando de despliegue:

gcloud run deploy my-ironpdf-service \
    --image gcr.io/my-project/my-ironpdf-app \
    --platform managed \
    --region us-central1 \
    --execution-environment gen2 \
    --allow-unauthenticated
gcloud run deploy my-ironpdf-service \
    --image gcr.io/my-project/my-ironpdf-app \
    --platform managed \
    --region us-central1 \
    --execution-environment gen2 \
    --allow-unauthenticated
SHELL

Paso 2: Actualiza tu Dockerfile con las dependencias necesarias

FROM --platform=linux/amd64 mcr.microsoft.com/dotnet/aspnet:8.0 AS base
USER root
WORKDIR /app
EXPOSE 8080

RUN apt update && apt install -y \
    sudo libglib2.0-0 libxkbcommon-x11-0 libc6 libc6-dev \
    libgtk2.0-0 libnss3 libatk-bridge2.0-0 libx11-xcb1 \
    libxcb-dri3-0 libdrm-common libgbm1 libasound2 \
    libxrender1 libfontconfig1 libxshmfence1 libgdiplus libva-dev \
    libstdc++6 libxcomposite1 \
    && rm -rf /var/lib/apt/lists/*

COPY . .
RUN dotnet publish -c Release -o /app/publish

CMD ["dotnet", "/app/publish/myapp.dll"]

Para la lista completa de paquetes necesarios por distribución de Linux, consulte la guía de despliegue en Linux.

Curtis Chau
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 ...

Leer más
¿Listo para empezar?
Nuget Descargas 20,088,359 | Versión: 2026.7 recién publicada
Still Scrolling Icon

¿Aún desplazándote?

¿Quieres una prueba rápida? PM > Install-Package IronPdf
ejecutar una muestra Mira cómo tu HTML se convierte en PDF.