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.
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:
- Gere carga progressiva para a rota que usa o banco, começando abaixo do limite esperado.
- Observe latência, erros, fila do pool, número de instâncias e conexões do banco ao mesmo tempo.
- Confirme que o serviço não está apenas mantendo requisições dentro das instâncias enquanto o banco já está saturado.
- Repita a observação durante um deploy com tráfego dividido entre duas revisões.
- 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
- Google Cloud, "Set maximum instances for services", consultado em 18/11/2026.
- Google Cloud, "About instance autoscaling in Cloud Run services", consultado em 18/11/2026.
- Google Cloud, "Maximum instance limits", consultado em 18/11/2026.
- Google Cloud, "Cloud SQL for PostgreSQL quotas and limits", consultado em 18/11/2026.