IRONSOFTWAREHOME

Corrigindo Problemas de Implantação do IronPDF no Google Cloud Run

Curtis Chau
Curtis Chau
Updated: 10 de junho de 2026

O IronPDF falha ao gerar PDFs ou trava quando implantado no Google Cloud Run 1ª Geração. Três modos de falha são comuns:

  • Aplicativo travando ou produzindo falhas de segmentação durante a geração de PDF
  • Falhas de dependência causadas por bibliotecas gráficas ausentes, como libglib2.0-0, libxkbcommon-x11-0 e libgtk2.0-0
  • Erros de GPU ou de renderização quando o ambiente não possui suporte a aceleração gráfica

O Google Cloud Run 1ª Geração usa o kernel Linux 4.4.0, que não possui o suporte necessário para o renderizador baseado no Chrome do IronPDF. O ambiente da 2ª Geração usa kernel 6.4.10 e resolve esses problemas de compatibilidade.

Solução

Passo 1: Mude para o ambiente de execução da 2ª Geração

Adicione --execution-environment gen2 ao seu comando de implantação:

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

Passo 2: Atualize seu Dockerfile com as dependências necessárias

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

Para a lista completa de pacotes necessários por distribuição Linux, veja o guia de implantação Linux.

Curtis Chau
Redator Técnico

Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais bem estruturados e visualmente atraentes.

...
Leia mais

Pronto para começar?

Nuget Downloads 20,878,335Versão:2026.9recém-lançado

Obtenha sua chave de avaliação gratuita de 30 dias instantaneamente.
Não é necessário cartão de crédito nem criação de conta.
Biblioteca NuGet C# para PDF
Instalar com NuGet

Versão: 2026.9

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. No Solution Explorer, clique com o botão direito do mouse em Referências e selecione Gerenciar Pacotes NuGet.
  2. Selecione Procurar e pesquise "IronPDF".
  3. Selecione o pacote e instale.
DLL de PDF em C#
Baixar DLL

Versão: 2026.9

ou faça o download do Windows Installer aqui .

  1. Baixe e descompacte o IronPDF em um local como ~/Libs dentro do diretório da sua solução.
  2. No Solution Explorer do Visual Studio, clique com o botão direito do mouse em Referências. Selecione Procurar e digite "IronPDF.dll".

Licenças a partir de US$ 749

Key in blue circle

Obtenha sua chave de avaliação gratuita de 30 dias instantaneamente.

Your trial license will be sent to your email address

Sem limitações. 100% desbloqueado. Sem cartão de crédito.

bullet_checkedNão é necessário cartão de crédito nem criação de conta.Sem limitações. 100% desbloqueado. Sem cartão de crédito.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
Agende sua demonstração ao vivo gratuita.
Booking Badge

Aprovado por milhões de engenheiros em todo o mundo.

Logotipos dos clientes da Iron Software
Agende sua consulta sem compromisso.
Preencha o formulário abaixo ou envie um e-mail para sales@ironsoftware.com
Os seus dados serão sempre mantidos em sigilo.
Aprovado por milhões de engenheiros em todo o mundo.
Logotipos dos clientes da Iron Software
Obtenha sua chave de avaliação gratuita de 30 dias instantaneamente.
Não é necessário cartão de crédito nem criação de conta.