Generar un PDF en Azure Functions sin empaquetar un navegador
Publicado el 3 min de lectura
Una función que genera PDFs suele toparse con el mismo problema: las herramientas habituales
necesitan un navegador o bibliotecas nativas, y una función quiere un paquete pequeño y un
arranque rápido. Con una API HTTP no hay nada que empaquetar. La función arma una petición, la
envía con HttpClient y devuelve los bytes. Esta guía usa el modelo isolated worker de .NET y la
API de rustedf.cloud, con el cliente tipado de la
guía de C# y ASP.NET Core.
Registra el 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();Si AddHttpClient no se encuentra, añade el paquete Microsoft.Extensions.Http.
La clave sale de un ajuste de la aplicación llamado RUSTEDF_KEY. En local vive en
local.settings.json, que debe quedar fuera del control de versiones. En Azure, defínela en la
configuración de la aplicación o como referencia a un secreto de Key Vault. Nunca la escribas en
el código.
Un disparador HTTP que devuelve el 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 = "facturas/{number}.pdf")] HttpRequestData request, string number, CancellationToken cancellationToken) { var data = await LoadInvoiceDataAsync(number); var file = await pdf.RenderAsync(invoiceTemplateId, data, "es-ES", cancellationToken);
var response = request.CreateResponse(HttpStatusCode.OK); response.Headers.Add("Content-Type", "application/pdf"); response.Headers.Add("Content-Disposition", $"attachment; filename=\"factura-{number}.pdf\""); await response.Body.WriteAsync(file, cancellationToken); return response; }}AuthorizationLevel.Function pide una clave de función, para que un desconocido no pueda llamar a
la función y gastar tus créditos. Limpia el número de factura antes de que llegue a un nombre de
archivo y comprueba que quien llama puede ver esa factura.
Límites de tiempo
Una función tiene límites propios, y el servicio de PDF también. Mantén tres números en orden: el
tiempo límite del HttpClient, por encima del límite de tiempo de tu plan para que la llamada no
se rinda antes que el servicio; el tiempo que la plataforma permite responder a una función con
disparador HTTP; y el tamaño de los documentos que generas. Un documento que tarda en renderizarse
es motivo para llevar el trabajo a una cola, más abajo, en lugar de mantener abierta una petición
web.
Un disparador de cola para lotes
Cuando el trabajo es “generar esta factura y guardarla”, deja que lo dirija una cola. Cada mensaje
es un documento, y la plataforma reintenta un fallo. La función de abajo guarda el archivo con
Azure.Storage.Blobs, así que registra un cliente de contenedor junto al PdfClient:
// dentro de ConfigureServicesservices.AddSingleton(_ => new BlobContainerClient( Environment.GetEnvironmentVariable("STORAGE_CONNECTION"), "facturas"));public sealed class InvoiceBatch(PdfClient pdf, BlobContainerClient container){ [Function("InvoiceBatch")] public async Task Run( [QueueTrigger("facturas-por-generar")] string number, CancellationToken cancellationToken) { var data = await LoadInvoiceDataAsync(number); var file = await pdf.RenderAsync(invoiceTemplateId, data, "es-ES", cancellationToken);
await container.GetBlobClient($"facturas/{number}.pdf") .UploadAsync(new BinaryData(file), overwrite: true, cancellationToken); }}Dos puntos lo hacen seguro:
- Deja escapar los errores correctos. Un
429(límite de tasa) y un503(ocupado) traen la cabeceraRetry-After, y un renderizado que falla no consume crédito. Si el cliente lanza una excepción en esos casos, el mensaje vuelve a la cola y se intenta de nuevo, hasta el número de intentos que configures, y después cae en la cola de mensajes tóxicos (poison queue). - Haz el trabajo repetible. Subir con
overwrite: truehace que un mensaje ejecutado dos veces deje un solo archivo. Un renderizado que salió bien y perdió su respuesta consume otro crédito al repetirse, así que mantén los lotes dentro de lo que puedes permitirte repetir.
Varias instancias de una función pueden ejecutarse a la vez, y la tasa de peticiones de tu plan se
comparte entre toda la cuenta. Limita cuántos mensajes se procesan en paralelo en los ajustes del
host, para que una cola grande no se convierta en un muro de respuestas 429. La guía de lotes
da los detalles: Generar miles de PDF en C#.
Comprueba antes de desplegar
Envía la plantilla y los datos de ejemplo a POST /v1/validate: informa de lo que el servicio no
pudo usar, sin PDF y sin crédito. En las pruebas, añade "strict": true para que un documento que
empiece a usar algo no admitido falle con 422 strict_mode_rejected.
Sigue leyendo
Código e integraciones
Generar un PDF en ASP.NET Core: MVC, Razor Pages y minimal APIs
Convierte una vista Razor en PDF en ASP.NET Core con una llamada a la API: renderizador de vistas, vista lista para imprimir, acción MVC y handler de Razor Pages.
3 min de lectura
Código e integraciones
Convertir una página web a PDF en C# sin navegador headless
Descarga una página con HttpClient y convierte su HTML en PDF con una llamada a la API en C#. Qué páginas admite, cuáles no y cómo comprobarlo de antemano.
3 min de lectura
Código e integraciones
Generador de informes PDF en C#: tabla paginada con totales
Crea un informe PDF en C# a partir de una lista de objetos: tabla con la cabecera repetida en cada página, total, números de página y recuento de páginas.
3 min de lectura
Código e integraciones
Guardar un PDF en C#: en disco, como descarga o en blob storage
Guarda el PDF que devuelve una llamada de renderizado en C#: escríbelo en disco, envíalo como descarga en ASP.NET Core, usa un enlace firmado o súbelo al storage.
2 min de lectura