//Durable Objects

Código serverless com estado próprio e consistente

Crie e execute serviços de chat, sistemas multiplayer e aplicações colaborativas que mantêm os usuários sincronizados no mundo todo, sem message brokers ou state stores para gerenciar.

Apps serverless de longa duração

Os durable objects executam pelo tempo necessário. Podem processar em segundo plano e atender a grandes volumes de requisições simultâneas.

Todos os usuários em sincronia

Todo durable object funciona como servidor e cliente WebSocket. Transmita o estado a todos os clientes conectados em poucas linhas de código.

Escale para milhões conforme precisar

Dê a cada unidade de trabalho da sua aplicação um durable object leve e isolado. Execute milhões deles, sem planejar capacidade.

Um coordenador para cada estado compartilhado

Toda chamada a um durable object chega à sua única instância ativa, onde quer que ela esteja entre os mais de 100 data centers. Uma escrita condicional garante um só dono, mesmo com falhas de rede. Você escreve a classe, a Azion cuida do posicionamento, do roteamento e do failover.

Usuários em regiões diferentes conectados a durable objects executados na infraestrutura distribuída da Azion

Casos de uso

AI agents

Runtime de agents com estado

Dê a cada agent um durable object para guardar o estado da conversa e das tarefas, executar etapas em ordem e retomar após uma pausa.

Chat e mensageria

Chat em tempo real com presença

Use um durable object por sala para guardar mensagens, saber quem está online e transmitir cada atualização aos usuários conectados.

Jogos multiplayer

Servidor de jogo autoritativo

Mantenha jogadores, regras e placar de cada partida em um durable object e envie cada jogada a todos no momento em que acontece.

Edição colaborativa

Sincronização de documentos ao vivo

Envie todas as edições de um documento ao durable object dele, para que mudanças simultâneas sejam aplicadas em ordem e todos vejam a mesma versão.

Reservas e checkout

Reserva de estoque e assentos

Gerencie cada evento, carrinho ou SKU no próprio durable object, para que o mesmo assento ou item nunca seja vendido ou adicionado duas vezes.

Contadores

Contadores compartilhados consistentes

Conte likes, votos, visualizações ou cotas em um durable object, para que cada incremento seja registrado mesmo com atualizações simultâneas.

O caminho mais curto para apps stateful em tempo real

Requisições de qualquer lugar chegam ao mesmo durable object, e uma única instância coordena todos os clientes que compartilham o estado. Ele faz fan-in e fan-out por WebSocket, e o SQLite embutido guarda estado, eventos e histórico junto do seu código.

1import { DurableObject } from 'azion/durable-objects';
2 
3export class Counter extends DurableObject {
4  // Events run one at a time: two increments never interleave.
5  async increment() {
6    const next = ((await this.ctx.storage.get('count')) ?? 0) + 1;
7    await this.ctx.storage.put('count', next);
8    return next;
9  }
10}
11 
12export default {
13  async fetch(request, env) {
14    const name = new URL(request.url).searchParams.get('name');
15    if (!name) return new Response('Missing ?name', { status: 400 });
16 
17    const total = await env.COUNTER.get(env.COUNTER.idFromName(name)).increment();
18    return Response.json({ name, total });
19  }
20};

1import { DurableObject } from 'azion/durable-objects';
2 
3export class ChatRoom extends DurableObject {
4  constructor(ctx, env) {
5    super(ctx, env);
6    this.ctx.storage.sql.exec('CREATE TABLE IF NOT EXISTS messages (author TEXT, body TEXT, sent_at INTEGER)');
7  }
8 
9  async fetch(request) {
10    const [client, server] = Object.values(new WebSocketPair());
11    this.ctx.acceptWebSocket(server);
12    return new Response(null, { status: 101, webSocket: client });
13  }
14 
15  async webSocketMessage(socket, message) {
16    const { author, body } = JSON.parse(message);
17    this.ctx.storage.sql.exec('INSERT INTO messages (author, body, sent_at) VALUES (?, ?, ?)', author, body, Date.now());
18    for (const peer of this.ctx.getWebSockets()) peer.send(message);
19  }
20}

1import { DurableObject } from 'azion/durable-objects';
2 
3export class SupportAgent extends DurableObject {
4  constructor(ctx, env) {
5    super(ctx, env);
6    this.ctx.storage.sql.exec('CREATE TABLE IF NOT EXISTS messages (id INTEGER PRIMARY KEY, role TEXT, content TEXT)');
7  }
8 
9  async ask(question) {
10    const history = this.ctx.storage.sql.exec('SELECT role, content FROM messages ORDER BY id DESC LIMIT 20').toArray().reverse();
11    const reply = await Azion.AI.run('Qwen/Qwen3-30B-A3B-Instruct-2507-FP8', { messages: [
12      { role: 'system', content: 'You are a support agent.' },
13      ...history,
14      { role: 'user', content: question }
15    ] });
16    const answer = reply.choices[0].message.content;
17    this.ctx.storage.sql.exec('INSERT INTO messages (role, content) VALUES (?, ?), (?, ?)', 'user', question, 'assistant', answer);
18    return answer;
19  }
20}

"Nossa parceria com a Azion transformou nossas operações. Reduzimos custos e melhoramos a performance, recuperando mais de 200 horas mensais para focar em desenvolvimento estratégico."

Mateus Leonardi

CTO na HeroSpark

Ver caso de sucesso

//Completo, não complexo

Todas as primitivas de desenvolvimento
de que você precisa

Compute

FunctionsExecute código serverless mais perto dos usuários

Rules EngineAutomatize o tratamento de requisições com regras programáveis

Load BalancerDistribua o tráfego para performance e disponibilidade

Image ProcessorOtimize e transforme imagens em tempo real

AI InferenceExecute modelos de AI mais perto dos usuários

AI GatewayProteja, gerencie e otimize o tráfego de AI

Data

Object StorageArmazenamento escalável e durável para dados não estruturados

SQL DatabaseBanco de dados relacional para aplicações distribuídas

KV StoreArmazenamento chave-valor globalmente distribuído e de baixa latência

CacheAcelere a entrega e reduza a carga na origem

Security

Web Application FirewallProteja aplicações humanas e de AI contra ameaças

API GatewayProteja, gerencie e escale o tráfego de APIs

Bot ManagementDetecte e bloqueie ameaças automatizadas instantaneamente

DNSHospede zonas DNS autoritativas com confiabilidade global

Perguntas Frequentes

O que é o Durable Objects?

O Durable Objects é computação serverless com estado próprio e consistente na Azion Web Platform. Cada objeto é uma só instância do seu código, identificada por um nome único, com estado em memória, armazenamento SQL transacional, suporte a WebSocket e alarmes. Toda requisição para esse objeto chega à mesma instância, o que torna o objeto o ponto de coordenação de tudo o que muitos usuários ou serviços compartilham.

Como o Durable Objects mantém o estado consistente?

Três garantias trabalham juntas. Só uma instância de cada durable object executa por vez, protegida por um registro de posse em armazenamento durável. Essa instância processa um evento por vez, então requisições simultâneas nunca se intercalam. E cada escrita é uma transação ACID no banco SQLite do próprio objeto, confirmada em armazenamento durável antes de a resposta ser enviada.

Qual a diferença entre Durable Objects e Functions?

Functions processa cada requisição de forma independente e não guarda nada entre execuções. Um durable object preserva o estado entre requisições, mantém conexões WebSocket abertas, executa alarmes e atende, a partir de uma única instância, todos os clientes que usam o mesmo objeto. Use Functions para lógica no momento da requisição e Durable Objects quando muitos clientes precisam compartilhar e atualizar o mesmo estado.

Quando usar Durable Objects em vez de KV Store ou SQL Database?

O KV Store é eventualmente consistente e mantém a última escrita quando duas escritas atingem a mesma chave, o que atende configurações e dados de sessão lidos em alto volume. O SQL Database atende dados relacionais consultados por toda a aplicação. Use Durable Objects quando uma entidade, como uma sala, um carrinho ou uma conta, precisa de atualizações em ordem e de uma única fonte da verdade.

Como funcionam os WebSockets no Durable Objects?

Um objeto aceita conexões WebSocket diretamente e pode enviar mensagens para todas elas. Quando não chegam mensagens, o objeto hiberna enquanto as conexões continuam abertas e acorda quando a próxima mensagem chega, então conexões ociosas não mantêm o objeto em execução.

Como funcionam os alarmes?

Um objeto define um alarme para um momento futuro, e a plataforma acorda esse objeto quando chega a hora, mesmo que ele tenha hibernado. Em casos raros de falha, um alarme pode disparar mais de uma vez, então escreva handlers que possam ser repetidos com segurança.

Posso criar AI agents com o Durable Objects?

Sim. Dê a cada agent ou conversa o próprio durable object e guarde o histórico no armazenamento SQL do objeto, para que cada interação leia e grave o mesmo estado.

Como o Durable Objects da Azion se compara a outras plataformas?

A Azion segue o mesmo modelo de Durable Objects: uma instância por objeto, eventos processados em ordem, armazenamento transacional, WebSockets e alarmes. Cada objeto guarda os dados no próprio banco SQLite, com as mudanças salvas em armazenamento durável fora da máquina que o executa. A API é compatível, então o código de Durable Objects que você já tem executa na Azion.

Como migrar código de Durable Objects existente para a Azion?

O modelo de programação é o mesmo: uma classe, um nome, armazenamento, WebSockets e alarmes. A API é compatível, então suas classes executam na Azion sem reescrita. Basta substituir os bindings atuais pela configuração da Azion.

//Build

Construa uma vez.
Rode em qualquer lugar.

Ganhe um caminho mais rápido para lançar, menos latência e menos sobrecarga de infraestrutura.