Definir max instances en Cloud Run no consiste en elegir un número cómodo en el panel de configuración. Cada instancia puede abrir su propio pool de conexiones, así que escalar el servicio también puede aumentar la presión sobre la base de datos.
El cálculo inicial es sencillo: instancias máximas = floor((conexiones seguras - conexiones reservadas) / pool máximo por instancia). Convierte un presupuesto de la base de datos en un límite operativo. Después hay que validar el resultado con carga, observar las métricas y probar el comportamiento durante despliegues y divisiones de tráfico. La guía para elegir la concurrencia en Cloud Run cubre el otro eje de esta decisión: cuántas peticiones acepta una instancia al mismo tiempo.
Este artículo usa un ejemplo numérico para explicar el método. Los valores son ilustrativos, no un benchmark ni una recomendación universal para Cloud SQL.
Respuesta corta
- Define primero cuántas conexiones puede usar este servicio sin consumir el presupuesto de otros clientes.
- Multiplica el pool máximo de una instancia por el número máximo de instancias. Ese producto es la presión potencial del servicio.
- Redondea hacia abajo después de reservar conexiones para migraciones, jobs, administración y otros consumidores.
- Trata el resultado como un techo de escalado, no como una garantía absoluta. Los picos, las revisiones y la división de tráfico pueden cambiar la capacidad observada.
¿Qué limita max instances en Cloud Run?
Google Cloud documenta el número máximo de instancias de un servicio como una forma de controlar costes o proteger las conexiones a un servicio de respaldo. Limita el escalado, pero no elige por ti un presupuesto para la base de datos.
La documentación de autoscaling de Cloud Run contiene tres detalles importantes: el límite puede proteger el backend, los picos de tráfico o el mantenimiento pueden crear instancias temporalmente por encima del límite, y las distintas revisiones pueden tener sus propios límites. Una división de tráfico entre revisiones también puede hacer que el total del servicio se comporte de forma distinta a un único contador compartido.
Por eso, max instances es una barrera de contención. No corrige un pool demasiado grande, no sustituye al backpressure y no demuestra que la base de datos se haya dimensionado correctamente.
Separa concurrencia, pool e instancias
Estos números aparecen juntos durante un incidente, pero controlan cosas diferentes:
| Ajuste | Qué limita | Pregunta operativa |
|---|---|---|
| Concurrencia | Peticiones simultáneas por instancia | ¿Cuántas peticiones pueden competir dentro del proceso? |
| Tamaño del pool | Conexiones que una instancia puede mantener o abrir | ¿Cuántas operaciones de esta instancia pueden hablar con la base de datos? |
max instances |
Instancias que el servicio puede usar como techo | ¿Cuántas copias pueden multiplicar el pool? |
| Presupuesto seguro | Conexiones que la base de datos puede entregar a este servicio | ¿Qué queda después de contar a los demás consumidores? |
Una concurrencia de 80 no significa 80 conexiones a la base de datos, y un pool de 5 no impide que la plataforma cree varias instancias. La relación que importa para el límite de conexiones es el pool por instancia multiplicado por el número de instancias en escala.
Si todavía investigas la presión dentro de una instancia, empieza por el modelo de concurrencia de Cloud Run. Si el servicio tiene handlers de peticiones, jobs y workers con ciclos de vida distintos, compara también Service, Job y worker pool en Cloud Run en vez de poner todas las cargas bajo un mismo límite.
Calcula un techo a partir del presupuesto de la base de datos
Haz explícitas cuatro entradas:
B: conexiones seguras que puede consumir este servicio;R: conexiones reservadas para otros consumidores u operaciones;P: tamaño máximo del pool de una instancia;M: número máximo de instancias que permite el cálculo.
La fórmula es:
M = max(0, floor((B - R) / P))
Supón, solo para demostrar la aritmética, que el servicio tiene un presupuesto seguro de 42 conexiones, reserva 2 para otro propósito y configura un pool máximo de 5 por instancia:
floor((42 - 2) / 5) = 8
El resultado inicial es 8 instancias. El producto 8 × 5 = 40 queda dentro de las 40 conexiones disponibles después de la reserva. Si el pool crece hasta 9, el mismo cálculo baja a 4. Si las reservas consumen todo el presupuesto, el resultado es 0, lo que indica que las premisas no dejan espacio para una instancia.
No uses el número máximo de conexiones de la base de datos como B sin investigar quién más la utiliza. Para el camino de conexión integrado entre Cloud Run y Cloud SQL, la documentación de Cloud SQL para PostgreSQL advierte que cada instancia de Cloud Run puede tener hasta 100 conexiones por base de datos y que el total crece a medida que el servicio escala. Esa observación es específica de ese camino de conexión, no una regla para todos los drivers o topologías.
Prueba el cálculo sin esperar a toda la aplicación
Una pequeña fixture ayuda a evitar redondeos hacia arriba o entradas inválidas. Guarda este ejemplo como connection-budget.mjs y ejecútalo con Node.js. Prueba el cálculo, no la capacidad real de una base de datos:
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
Después sustituye los números ilustrativos por valores que puedas explicar: el límite configurado del pool, las conexiones observadas durante la carga, los consumidores fuera de Cloud Run y el margen operativo elegido por tu equipo. Si no hay una medición o una decisión explícita detrás de B, la fórmula solo da apariencia matemática a una suposición.
Aplica el límite en el alcance que quieres proteger
Google Cloud documenta la configuración del máximo de instancias con gcloud. Para actualizar el límite del servicio, un comando como este es un punto de partida:
gcloud run services update SERVICE \
--max 8 \
--region REGION
Confirma en el comando y en la configuración exportada del servicio qué alcance estás usando. Las revisiones, las tags y las divisiones de tráfico pueden producir un resultado distinto al valor que viste en un panel. Haz el cambio en una revisión identificable, registra B, R y P junto a ella y evita cambiar la concurrencia, el pool y el código de la aplicación en la misma prueba.
Un despliegue exitoso solo demuestra que se aceptó la configuración. No demuestra que la base de datos pueda soportar un pico, que el pool se vaya a utilizar por completo ni que una revisión antigua haya dejado de recibir tráfico.
Verifica el comportamiento bajo carga y durante un despliegue
Valida el límite con una secuencia que mantenga separadas las causas:
- Genera carga progresiva para la ruta que usa la base de datos, empezando por debajo del límite esperado.
- Observa a la vez la latencia, los errores, la espera del pool, el número de instancias y las conexiones de la base de datos.
- Confirma que el servicio no está simplemente reteniendo peticiones dentro de las instancias mientras la base de datos ya está saturada.
- Repite la observación durante un despliegue con tráfico dividido entre dos revisiones.
- Registra el nivel estable más alto y qué ocurrió cuando una dependencia llegó a su límite.
La guía de autoscaling de Cloud Run explica por qué los picos y el mantenimiento merecen una comprobación separada. La documentación de límites de instancias también deja claro que el valor es un límite superior de escalado, no una promesa de que el servicio nunca observará una superación transitoria.
Si la prueba muestra que una revisión antigua todavía recibe peticiones, trátalo como un problema del rollout. Si la base de datos se satura antes del techo, reduce el límite o el pool, ajusta la concurrencia e investiga la ruta. El despliegue canary en Cloud Run ayuda a estructurar una comparación controlada, mientras que la facturación de Cloud Run por solicitudes o instancias ayuda a separar la protección de capacidad de una decisión de costes.
Fallos habituales en este cálculo
Dividir el límite de la base de datos por el pool y olvidar a los demás consumidores
La base de datos atiende a más clientes que el servicio web. Incluye jobs, herramientas administrativas, migraciones, réplicas y otros servicios en el presupuesto reservado. Si no conoces el uso de esos clientes, marca B como incierto y prueba antes de convertir el cálculo en configuración.
Confundir concurrencia con conexiones
Una instancia puede recibir más peticiones de las que su pool puede ejecutar en paralelo. Puede ser aceptable cuando la cola cabe en el objetivo de latencia, pero también puede ocultar saturación. Bajar max instances no arregla una concurrencia mal elegida, y subir la concurrencia no crea conexiones de base de datos.
Configurar cada revisión como si fuera todo el servicio
Durante un rollout, dos revisiones pueden recibir tráfico. Suma la capacidad potencial de cada revisión antes de afirmar que la base de datos está protegida. Analiza el límite junto con la configuración de tráfico, no de forma aislada en el YAML de una revisión.
Tratar 0 como una configuración de producción válida
El 0 de la fixture significa que las premisas no dejan espacio para una instancia. No es una recomendación para apagar el servicio. Revisar el pool, las reservas o el presupuesto es la decisión que falta.
Método y límites de esta guía
Consulté la documentación oficial de Cloud Run y Cloud SQL el 18/11/2026 y ejecuté la fixture con Node.js 25.5.0. No ejecuté un servicio de Cloud Run ni una carga contra una base de datos de producción. La asistencia de IA ayudó a organizar la investigación y revisar la prosa, pero no aportó mediciones, valores universales ni validación de tu infraestructura. Usa los comandos como punto de partida y confirma la sintaxis y los límites en el entorno que operas.
Conclusión
Elegir max instances para proteger una base de datos es una decisión de capacidad, no una suposición sobre el autoscaling. Escribe el presupuesto seguro, resta las reservas, divide por el pool máximo y redondea hacia abajo. Después valida el cálculo con carga progresiva, métricas del servicio y de la base de datos, además de un despliegue con tráfico dividido.
El valor final es defendible cuando otro ingeniero puede repetir el cálculo y entender qué consumidores, revisiones y excepciones se consideraron. Cuando cambian esas premisas, el límite también necesita revisión.
Fuentes consultadas
- Google Cloud, "Set maximum instances for services", consultado el 18/11/2026.
- Google Cloud, "About instance autoscaling in Cloud Run services", consultado el 18/11/2026.
- Google Cloud, "Maximum instance limits", consultado el 18/11/2026.
- Google Cloud, "Cloud SQL for PostgreSQL quotas and limits", consultado el 18/11/2026.