Definir max instances no Cloud Run não é escolher um número confortável na tela de configuração. Cada instância pode abrir seu próprio pool de conexões, então escalar o serviço também pode escalar a pressão sobre o banco.

A conta inicial é simples: instâncias máximas = piso((conexões seguras - conexões reservadas) / pool máximo por instância). Ela transforma um orçamento do banco em um limite operacional. Depois, você precisa verificar a conta com carga, observar as métricas e testar o comportamento durante deploy e divisão de tráfego. O guia para escolher a concorrência no Cloud Run trata de outro eixo da mesma decisão: quantas requisições uma instância aceita ao mesmo tempo.

Este artigo usa um exemplo numérico para explicar o método. Os valores são ilustrativos, não um benchmark ou uma recomendação universal para Cloud SQL.

Diagrama mostra o produto entre max instances e pool de conexões chegando ao orçamento seguro do banco.

Resposta curta

  • Defina primeiro quantas conexões o banco pode entregar ao serviço sem consumir o orçamento de outros clientes.
  • Multiplique o pool máximo de uma instância pelo número máximo de instâncias. Esse produto é a pressão potencial do serviço.
  • Arredonde para baixo depois de reservar conexões para migrações, jobs, administração e outros consumidores.
  • Trate o resultado como um teto de escala, não como garantia absoluta: picos, revisões e divisão de tráfego podem alterar a capacidade observada.

O que max instances limita no Cloud Run?

O Google Cloud documenta o máximo de instâncias de um serviço como um limite para controlar custo ou proteger conexões com serviços de apoio. Isso limita a escala, mas não escolhe um orçamento de banco para você.

Há três detalhes importantes na documentação de autoscaling do Cloud Run: o limite pode ajudar a proteger o backend, picos de tráfego ou manutenção podem criar instâncias temporariamente além do limite, e revisões diferentes podem ter limites próprios. Uma divisão de tráfego entre revisões também pode fazer o total do serviço não se comportar como um único contador.

Por isso, max instances é uma barreira de contenção. Ele não corrige um pool grande demais, não substitui backpressure e não prova que a capacidade do banco foi dimensionada corretamente.

Separe concorrência, pool e instâncias

Esses números aparecem juntos durante um incidente, mas controlam coisas diferentes:

Configuração O que limita Pergunta operacional
Concorrência Requisições simultâneas por instância Quantas requisições podem disputar o processo?
Pool Conexões que uma instância pode manter ou abrir Quantas operações dessa instância podem falar com o banco?
max instances Instâncias que o serviço tenta manter como teto Quantas cópias podem multiplicar o pool?
Orçamento seguro Conexões que o banco pode entregar a este serviço Quanto sobra depois dos outros consumidores?

Uma concorrência de 80 não significa 80 conexões ao banco, e um pool de 5 não impede que a plataforma crie várias instâncias. A relação que interessa para o limite de conexões é o pool por instância multiplicado pelas instâncias em escala.

Se você ainda está investigando a pressão dentro de uma instância, comece pelo modelo de concorrência do Cloud Run. Se o serviço tem funções de requisição, jobs e workers com ciclos de vida diferentes, compare também Service, Job e worker pool no Cloud Run, em vez de colocar todos os tipos de trabalho no mesmo limite.

Calcule o teto a partir do orçamento do banco

Use quatro entradas explícitas:

  • B: conexões seguras que este serviço pode consumir;
  • R: conexões reservadas para outros consumidores ou operações;
  • P: tamanho máximo do pool de uma instância;
  • M: máximo de instâncias que a conta permite.

A fórmula é:

M = max(0, floor((B - R) / P))

Suponha, apenas para demonstrar a aritmética, que o serviço tenha um orçamento seguro de 42 conexões, reserve 2 para outra finalidade e configure um pool máximo de 5 por instância:

floor((42 - 2) / 5) = 8

O resultado inicial é 8 instâncias. O produto 8 × 5 = 40 fica dentro das 40 conexões disponíveis depois da reserva. Se o pool subir para 9, a mesma conta cai para 4. Se as reservas ocuparem todo o orçamento, o resultado é 0, sinal de que a configuração não pode atender tráfego sem rever as premissas.

Não use o limite máximo de conexões do banco como B sem investigar quem mais usa esse banco. No caso da conexão integrada entre Cloud Run e Cloud SQL, a documentação do Cloud SQL para PostgreSQL alerta que cada instância do Cloud Run pode ter até 100 conexões por banco e que o total cresce conforme o serviço escala. Essa observação é específica desse caminho de conexão, não uma regra para todos os drivers ou topologias.

Teste a conta sem esperar uma aplicação inteira

Uma pequena fixture ajuda a evitar arredondamento para cima ou entradas inválidas. Salve o exemplo como connection-budget.mjs e execute com Node.js. Ele testa a função de cálculo, não a capacidade real do banco:

import assert from "node:assert/strict";

function maxInstances({ safeConnections, reservedConnections, poolPerInstance }) {
  for (const value of [safeConnections, reservedConnections, poolPerInstance]) {
    if (!Number.isInteger(value) || value < 0) {
      throw new TypeError("connection values must be non-negative integers");
    }
  }

  if (poolPerInstance === 0 || reservedConnections > safeConnections) {
    return 0;
  }

  return Math.floor(
    (safeConnections - reservedConnections) / poolPerInstance,
  );
}

assert.equal(
  maxInstances({
    safeConnections: 42,
    reservedConnections: 2,
    poolPerInstance: 5,
  }),
  8,
);

assert.equal(
  maxInstances({
    safeConnections: 9,
    reservedConnections: 2,
    poolPerInstance: 5,
  }),
  1,
);

console.log("connection budget fixture passed");
node connection-budget.mjs

Depois, substitua os números ilustrativos por valores que você consiga explicar: limite configurado do pool, conexões observadas durante carga, consumidores fora do Cloud Run e margem operacional escolhida pela equipe. Se não há uma medição ou uma decisão explícita por trás de B, a fórmula apenas dá uma aparência matemática a uma suposição.

Aplique o limite no escopo que você pretende proteger

O Google Cloud documenta a configuração de máximo de instâncias com gcloud. Para atualizar o limite no serviço, um comando como este é um ponto de partida:

gcloud run services update SERVICE \
  --max 8 \
  --region REGION

Confirme no comando e na configuração exportada do seu serviço qual escopo está sendo usado. Revisões, tags e divisões de tráfego podem criar um resultado diferente do que você imaginou ao olhar apenas para um valor no painel. Faça a mudança em uma revisão identificável, registre B, R e P junto dela e evite misturar esse ajuste com alterações de concorrência, pool e código no mesmo teste.

Um deploy bem-sucedido só prova que a configuração foi aceita. Ele não prova que o banco aguenta o pico, que o pool será totalmente utilizado ou que uma revisão antiga deixou de receber tráfego.

Verifique o comportamento sob carga e durante deploy

Valide o limite em uma sequência que consiga separar as causas:

  1. Gere carga progressiva para a rota que usa o banco, começando abaixo do limite esperado.
  2. Observe latência, erros, fila do pool, número de instâncias e conexões do banco ao mesmo tempo.
  3. Confirme que o serviço não está apenas mantendo requisições dentro das instâncias enquanto o banco já está saturado.
  4. Repita a observação durante um deploy com tráfego dividido entre duas revisões.
  5. Registre o maior nível estável e o que aconteceu quando uma dependência atingiu seu limite.

O guia de autoscaling do Cloud Run explica por que picos e manutenção merecem uma verificação separada. A documentação de limites de máximo de instâncias também deixa claro que o valor é um limite superior de escala, não uma promessa de que o serviço jamais observará uma ultrapassagem transitória.

Se o teste revelar que uma revisão antiga ainda recebe requisições, trate o caso como um problema de rollout. Se revelar que o banco satura antes do teto, reduza o limite ou o pool, ajuste a concorrência e investigue a rota. A implantação canário no Cloud Run ajuda a estruturar uma comparação controlada, enquanto o custo de requisições e instâncias ajuda a separar proteção de capacidade de decisão de custo.

Falhas comuns nessa conta

Dividir o limite do banco pelo pool e esquecer outros consumidores

O banco atende mais do que o serviço web. Inclua jobs, ferramentas administrativas, migrações, réplicas e outros serviços no orçamento reservado. Se não souber o consumo desses clientes, marque B como incerto e teste antes de transformar a conta em configuração.

Confundir concorrência com conexões

Uma instância pode receber mais requisições do que seu pool consegue executar em paralelo. Isso pode ser aceitável quando a fila cabe na latência, mas também pode esconder saturação. Reduzir max instances não resolve uma concorrência mal escolhida, e aumentar concorrência não cria conexões de banco.

Configurar cada revisão como se fosse o serviço inteiro

Durante um rollout, duas revisões podem receber tráfego. Some a capacidade potencial de cada revisão antes de afirmar que o banco está protegido. O limite precisa ser analisado junto da configuração de tráfego, não isolado no YAML de uma revisão.

Interpretar 0 como uma configuração válida de produção

O 0 da fixture significa que as premissas não deixam espaço para uma instância. Não é uma recomendação para desligar o serviço. Rever o pool, as reservas ou o orçamento é a decisão que falta.

Método e limites deste guia

Consultei a documentação oficial do Cloud Run e do Cloud SQL em 18/11/2026 e executei a fixture com Node.js 25.5.0. Não rodei um serviço Cloud Run nem uma carga contra um banco de produção. A assistência de IA ajudou a organizar a pesquisa e revisar o texto, mas não forneceu medições, valores universais ou validação da sua infraestrutura. Use os comandos como ponto de partida e confirme a sintaxe e os limites no ambiente que você opera.

Conclusão

Escolher max instances para proteger um banco é uma decisão de capacidade, não um palpite sobre autoscaling. Escreva o orçamento seguro, retire as reservas, divida pelo pool máximo e arredonde para baixo. Em seguida, valide a conta com carga progressiva, métricas do serviço e do banco, além de um deploy com tráfego dividido.

O valor final é defensável quando outra pessoa consegue refazer a conta e entender quais consumidores, revisões e exceções foram considerados. Se as premissas mudarem, o limite também precisa voltar para revisão.

Fontes consultadas