Durable Objects en Cloudflare Workers: Estado y Coordinación en el Edge
El problema del estado en la informática perimetral
La promesa del edge computing es ejecutar lógica cerca del usuario final para reducir la latencia. Sin embargo, las arquitecturas sin servidor (serverless) tradicionales, como las funciones Lambda o los Workers básicos, son inherentemente stateless. Cada invocación se ejecuta en una instancia efímera que se destruye al finalizar. Para aplicaciones que requieren estado compartido —sesiones de usuario, contadores, locks, coordinación de websockets— esto se convierte en un obstáculo. La solución habitual (una base de datos externa centralizada) introduce latencia y contradice el propósito del edge. Aquí es donde entran los Durable Objects (DO) de Cloudflare Workers.
Qué son los Durable Objects
Un Durable Object es una instancia de una clase JavaScript que vive en un único punto de presencia (PoP) de Cloudflare y que mantiene su estado en memoria de forma persistente. Cloudflare garantiza que, para un ID dado, solo exista una instancia activa en todo el mundo en un momento dado. Esto proporciona un mecanismo de coherencia fuerte y una primitiva de coordinación sin necesidad de infraestructura externa.
La clave está en el modelo de concurrencia: cada DO procesa eventos (peticiones HTTP, mensajes de WebSockets, alarms) de forma secuencial, como si fuera un único hilo en Node.js. No hay carreras de datos dentro del objeto. Esto simplifica drásticamente la lógica de negocio, ya que no necesitas usar locks ni transacciones distribuidas para operaciones que afectan al mismo objeto. El estado se escribe en un almacenamiento persistente (basado en SQLite) que se replica de forma síncrona antes de que la petición sea respondida, garantizando durabilidad.
Componentes y estructura básica
Para usar DO, extiendes la clase DurableObject exportada desde cloudflare:workers. Las propiedades y métodos definidos en la clase se serializan y persisten automáticamente entre invocaciones. El constructor recibe un objeto state que expone métodos como state.storage.
La configuración se realiza en el archivo wrangler.toml:
name = "mi-app-doble" main = "src/index.ts" compatibility_date = "2025-04-01"[[durable_objects.bindings]] name = “COORDINADOR” class_name = “CoordinadorGlobal”
[[migrations]] tag = “v1” new_sqlite_classes = [“CoordinadorGlobal”]
En el lado del Worker principal, obtienes una instancia del DO usando un ID. El binding actúa como un "stub" para localizar o crear la instancia única.
Primer ejemplo: un contador distribuido
Veamos un ejemplo clásico: un contador de visitas que debe ser exacto, no aproximado. Sin DO, cada Worker incrementaría una variable local que se perdería. Con DO, el contador vive en un único objeto.
// src/index.ts (Worker principal)
export default {
async fetch(request: Request, env: Env): Promise<Response> {
const id = env.COORDINADOR.idFromName("contador-visitas");
const objeto = env.COORDINADOR.get(id);
return objeto.fetch("https://do.local/increment");
},
};
// Definición del DO
import { DurableObject } from “cloudflare:workers”;
export class CoordinadorGlobal extends DurableObject {
async fetch(request: Request): Promise<Response> {
const url = new URL(request.url);
if (url.pathname
comentarios(0)
$ dejar comentario