Pular para o conteúdo

Prévia com prazo: como evitamos serviço esquecido na nuvem

Equipe AIUBYEngenharia de plataforma

Cloud Run + rótulos + trava no PostgreSQL

A prévia do runtime do AIUBY Compute implanta contêineres de verdade na nuvem, sem cobrar do cliente. O custo é nosso, e o jeito mais comum de esse custo fugir do controle é um serviço que alguém subiu e esqueceu. Este texto descreve as guardas que colocamos para isso não acontecer, em que ordem elas atuam e o que uma revisão independente encontrou nelas.

#O risco

Recurso esquecido continua cobrando. Anotamos isso como risco do produto antes de escrever o runtime, com uma exigência: reconciliação e limpeza automática. A prévia vale só para organizações que a equipe habilita, mas confiar em quem usa não resolve o esquecimento. Quem resolve é o sistema apagar sozinho.

#Tetos no código, não em configuração

Os limites da prévia são constantes no código. O ambiente pode escolher um valor menor, nunca um maior. Um número errado numa variável não abre o custo, porque toda leitura passa por uma função que corta no teto e volta ao padrão quando o valor não faz sentido:

lib/compute/runtime-config.ts
const bounded = (raw: string | undefined, fallback: number, max: number) => {
  const n = Number(raw)
  return Number.isInteger(n) && n >= 1 ? Math.min(n, max) : fallback
}
O quêPadrãoTeto fixo
Hardware em CPU-1 vCPU, 1 GB, 1 réplica
Prazo em CPU6 horas24 horas
Prazo com GPU1 hora2 horas
Aplicações com GPU na plataforma-3
Aplicações implantadas na plataformapoucasfixo no código

Escala e forma de cobrança também não vêm do pedido do cliente. O serviço sempre nasce com escala mínima zero e no máximo uma instância. Em CPU, a CPU só é alocada enquanto há requisição: ocioso, não custa.

#O prazo mora no serviço

Toda implantação da prévia nasce com data para acabar. Essa data é gravada em dois lugares: no registro da implantação, no banco, e num rótulo do próprio serviço, na conta de nuvem.

O segundo lugar é o que importa. Se o prazo existisse só no banco, um registro perdido, uma transação desfeita ou um banco restaurado de backup deixariam um serviço de pé sem ninguém saber que ele vence. Com o prazo no rótulo, basta listar a conta de nuvem para saber o que apagar.

#A varredura confia na nuvem

Um temporizador dentro do app roda a cada 10 minutos, com uma primeira passada logo depois de o app subir. Ele lista os serviços do produto na conta de nuvem, em todas as regiões da prévia, e apaga os vencidos. Não consulta o banco para decidir. O registro é acertado depois, na próxima leitura da aplicação, que encontra o serviço ausente e encerra a implantação.

  • Serviço sem prazo conta como vencido. Um serviço do produto sem o rótulo não deveria existir, então é apagado.
  • A varredura também roda sob demanda. Quando alguém da prévia abre uma tela ou pede um plano e há serviço vencido, a limpeza acontece ali, sem esperar o temporizador.
  • Uma região fora do ar não para as outras. A limpeza é feita região por região. A que respondeu é limpa. A falha vira erro no fim, e com erro nada novo é criado: se não sabemos quantos serviços há de pé, a resposta é não implantar.

#Uma operação por vez

Criar, trocar, parar e apagar por vencimento rodam dentro de uma transação que pega uma trava consultiva do PostgreSQL, a mesma para a plataforma inteira. É uma operação por vez. A trava resolve dois problemas de corrida:

  • Passar do teto. O plano conta os serviços de pé antes de liberar, mas essa contagem pode estar velha. A que vale é refeita com a trava, na hora de criar. Dois pedidos simultâneos não conseguem ocupar a mesma última vaga.
  • Apagar o serviço de uma reimplantação. O nome do serviço é estável entre revisões. Sem a trava, uma leitura atrasada de um registro vencido poderia apagar o serviço que o dono acabou de reimplantar. Com ela, quem encerra um registro só apaga o serviço se aquele registro ainda era o vivo. Se uma reimplantação passou na frente, o serviço é dela e fica.

A varredura agendada usa a mesma trava, pelo mesmo motivo. E há um teste para a corrida: o registro vence, o dono reimplanta antes de alguém ler, e a leitura seguinte tem de encontrar a aplicação em execução.

#Reimplantar não renova o prazo

Se reimplantar renovasse o prazo, um pipeline que publica a cada commit manteria o serviço de pé para sempre, e o prazo viraria enfeite. Por isso a reimplantação troca a revisão no mesmo serviço e herda a data original, enquanto ela ainda não venceu. Depois de vencida, uma implantação nova começa um prazo novo.

Há um detalhe na troca de hardware. Passar de CPU para GPU muda a região, o serviço antigo é apagado na mesma operação e o prazo nunca passa do prazo do hardware novo: trocar CPU por GPU não herda as horas da CPU.

#O que a revisão de segurança achou

Antes de publicar a GPU na prévia, em 12 de novembro de 2026, uma revisão de segurança independente encontrou um achado alto e três médios nessas guardas. Todos foram corrigidos e ganharam teste.

  • Alto: serviço de GPU invisível. Desligar a GPU na configuração tirava a região dela da listagem. Um serviço de pé ali sairia da contagem e da limpeza. Agora as regiões de GPU são uma lista fixa no código, e listagem e varredura olham todas sempre.
  • Médio: apagar serviço que estava servindo. Uma falha anterior ao pedido de criação acionava a limpeza de erro. Agora ela só roda depois de a criação ter sido pedida.
  • Médio: uma região parando toda a limpeza. É a regra de região por região, descrita acima.
  • Médio: excluir o próprio serviço da contagem só pelo nome. Agora a exclusão considera também a região: um resto da mesma aplicação em outra região conta para o teto.

#Limites

Limite

O temporizador roda dentro do app. Com o app fora do ar, um serviço vencido fica de pé até ele voltar. Ocioso, escala a zero e não custa, mas o endereço continua respondendo.
  • A prévia vale só para organizações habilitadas pela equipe, e o endereço é público por padrão. Com dado sensível, exija token de acesso na tela da aplicação antes de implantar.
  • O tráfego de saída não tem teto no código. Um endereço público servindo arquivos grandes pode custar bem mais que a CPU. A conta de nuvem tem alerta de orçamento, mas alerta avisa, não bloqueia.
  • Com GPU a cobrança da nuvem é por instância de pé, não por requisição. O pior caso de uma implantação é o prazo inteiro com a instância ligada, e é por isso que o prazo da GPU é curto.

Os limites da prévia para quem usa estão em Compute, na documentação. O teste que deu origem às regras de GPU está em GPU sem servidor no Cloud Run.