rustedf.cloud
Menu

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

Program.cs
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 ConfigureServices
services.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 um 503 (ocupado) trazem o cabeçalho Retry-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: true faz 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.

  • 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

← Todos os posts