Gerar PDF no Azure Functions sem empacotar um navegador
Publicado em 3 min de leitura
Uma função que gera PDFs costuma esbarrar no mesmo problema: as ferramentas usuais exigem um
navegador ou bibliotecas nativas, e uma função quer um pacote pequeno e uma partida rápida. Com uma
API HTTP, não há nada para empacotar. A função monta uma requisição, envia com HttpClient e
devolve os bytes. Este guia usa o modelo isolated worker do .NET e a API do rustedf.cloud, com o
cliente tipado do guia de C# e ASP.NET Core.
Registre o cliente
using System.Net.Http.Headers;using Microsoft.Extensions.DependencyInjection;using Microsoft.Extensions.Hosting;
var host = new HostBuilder() .ConfigureFunctionsWorkerDefaults() .ConfigureServices(services => { services.AddHttpClient<PdfClient>(client => { client.BaseAddress = new Uri("https://api.rustedf.com/"); client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue( "Bearer", Environment.GetEnvironmentVariable("RUSTEDF_KEY")); client.Timeout = TimeSpan.FromSeconds(40); }); }) .Build();
host.Run();Se o AddHttpClient não for encontrado, acrescente o pacote Microsoft.Extensions.Http.
A chave vem de uma configuração do aplicativo chamada RUSTEDF_KEY. Localmente ela fica em
local.settings.json, que precisa ficar fora do controle de versão. No Azure, defina-a na
configuração do aplicativo ou como referência a um segredo do Key Vault. Nunca a escreva no
código.
Um gatilho HTTP que devolve o PDF
using System.Net;using Microsoft.Azure.Functions.Worker;using Microsoft.Azure.Functions.Worker.Http;
public sealed class InvoicePdf(PdfClient pdf){ [Function("InvoicePdf")] public async Task<HttpResponseData> Run( [HttpTrigger(AuthorizationLevel.Function, "get", Route = "faturas/{number}.pdf")] HttpRequestData request, string number, CancellationToken cancellationToken) { var data = await LoadInvoiceDataAsync(number); var file = await pdf.RenderAsync(invoiceTemplateId, data, "pt-BR", cancellationToken);
var response = request.CreateResponse(HttpStatusCode.OK); response.Headers.Add("Content-Type", "application/pdf"); response.Headers.Add("Content-Disposition", $"attachment; filename=\"fatura-{number}.pdf\""); await response.Body.WriteAsync(file, cancellationToken); return response; }}AuthorizationLevel.Function pede uma chave de função, para que um desconhecido não possa chamar
a função e gastar os seus créditos. Limpe o número da fatura antes de ele chegar a um nome de
arquivo e confira se quem chama pode ver aquela fatura.
Limites de tempo
Uma função tem limites próprios, e o serviço de PDF também. Mantenha três números em ordem: o
tempo limite do HttpClient, acima do limite de tempo do seu plano para que a chamada não desista
antes do serviço; o tempo que a plataforma permite a uma função com gatilho HTTP para responder; e
o tamanho dos documentos que você gera. Um documento que demora para renderizar é motivo para
levar o trabalho a uma fila, abaixo, em vez de manter uma requisição web aberta.
Um gatilho de fila para lotes
Quando o trabalho é “gerar esta fatura e guardá-la”, deixe uma fila conduzir. Cada mensagem é um
documento, e uma falha é repetida pela plataforma. A função abaixo guarda o arquivo com o
Azure.Storage.Blobs, então registre um cliente de contêiner ao lado do PdfClient:
// dentro de ConfigureServicesservices.AddSingleton(_ => new BlobContainerClient( Environment.GetEnvironmentVariable("STORAGE_CONNECTION"), "faturas"));public sealed class InvoiceBatch(PdfClient pdf, BlobContainerClient container){ [Function("InvoiceBatch")] public async Task Run( [QueueTrigger("faturas-para-gerar")] string number, CancellationToken cancellationToken) { var data = await LoadInvoiceDataAsync(number); var file = await pdf.RenderAsync(invoiceTemplateId, data, "pt-BR", cancellationToken);
await container.GetBlobClient($"faturas/{number}.pdf") .UploadAsync(new BinaryData(file), overwrite: true, cancellationToken); }}Dois pontos tornam isso seguro:
- Deixe os erros certos escaparem. Um
429(limite de taxa) e um503(ocupado) trazem o cabeçalhoRetry-After, e uma renderização que falha não consome crédito. Se o cliente lança exceção nesses casos, a mensagem volta para a fila e é tentada de novo, até o número de tentativas que você configurar, e depois cai na fila de mensagens suspeitas (poison queue). - Torne o trabalho repetível. Enviar com
overwrite: truefaz com que uma mensagem executada duas vezes deixe um só arquivo. Uma renderização que deu certo e perdeu a resposta consome um crédito de novo quando repetida, então mantenha os lotes dentro do que você pode repetir.
Várias instâncias de uma função podem rodar ao mesmo tempo, e a taxa de requisições do seu plano é
compartilhada por toda a conta. Limite quantas mensagens são processadas em paralelo nas
configurações do host, para que uma fila grande não vire um muro de respostas 429. O guia de
lotes traz os detalhes: Gerar milhares de PDFs em C#.
Confira antes de publicar
Envie o template e os dados de exemplo para POST /v1/validate: ele informa o que o serviço não
conseguiu usar, sem PDF e sem crédito. Nos testes, acrescente "strict": true para que um
documento que passe a usar algo não suportado falhe com 422 strict_mode_rejected.
Leia Gerar um PDF, Autenticação e Erros e limites.
Continue lendo
Código e integrações
Gerar PDF no ASP.NET Core: MVC, Razor Pages e minimal APIs
Transforme uma view Razor em PDF no ASP.NET Core com uma chamada de API: renderizador de views, view pronta para impressão, action MVC e handler do Razor Pages.
3 min de leitura
Código e integrações
Converter página web em PDF em C# sem navegador headless
Busque uma página com HttpClient e transforme o HTML em PDF com uma chamada de API em C#. Quais páginas isso atende, quais não e como conferir antes de depender.
3 min de leitura
Código e integrações
Gerador de relatório PDF em C#: tabela paginada com totais
Monte um relatório em PDF em C# a partir de uma lista de objetos: tabela com cabeçalho repetido em cada página, total, número de página e contagem de páginas.
3 min de leitura
Código e integrações
Salvar PDF em C#: em disco, como download ou em blob storage
Salve o PDF devolvido por uma chamada de renderização em C#: grave em disco, envie como download no ASP.NET Core, guarde um link assinado ou suba para o storage.
2 min de leitura