Google Cloud Run에서 IronPDF 배포 문제 해결

Updated: 2026년 6월 10일

IronPDF가 Google Cloud Run 1세대에 배포될 때 PDF를 생성하지 못하거나 충돌합니다. 세 가지 일반적인 오류 모드가 있습니다:

애플리케이션이 충돌하거나 PDF 생성 중에 세그멘테이션 오류가 발생
그래픽 라이브러리 libglib2.0-0, libxkbcommon-x11-0, libgtk2.0-0의 누락으로 인한 종속성 실패
환경에 그래픽 가속 지원이 없는 경우 GPU 또는 렌더링 오류

Google Cloud Run 1세대는 Linux 커널 4.4.0을 사용하며, 이는 IronPDF의 Chrome 기반 렌더러가 필요한 지원을 제공하지 않습니다. 2세대 환경은 커널 6.4.10을 사용하며 이러한 호환성 문제를 해결합니다.

해결책

1단계: 2세대 실행 환경으로 전환

배포 명령에 --execution-environment gen2를 추가하십시오:

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

2단계: 필요한 의존성과 함께 Dockerfile을 업데이트하십시오

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"]

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"]

Text

Linux 배포판별로 필요한 패키지의 전체 목록은 Linux 배포 가이드를 참조하십시오.

Curtis Chau

지금 바로 엔지니어링 팀과 채팅하세요

기술 문서 작성자

커티스 차우는 칼턴 대학교에서 컴퓨터 과학 학사 학위를 취득했으며, Node.js, TypeScript, JavaScript, React를 전문으로 하는 프론트엔드 개발자입니다. 직관적이고 미적으로 뛰어난 사용자 인터페이스를 만드는 데 열정을 가진 그는 최신 프레임워크를 활용하고, 잘 구성되고 시각적으로 매력적인 매뉴얼을 제작하는 것을 즐깁니다.

...

더 읽어보기