Solucionar Problemas de Despliegue de IronPDF en Google Cloud Run
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, ylibgtk2.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
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.

