Un revisor de seguridad abre tu diagrama de arquitectura de Google Cloud y hace tres preguntas. ¿Puede alguien llamar directamente a la URL de Cloud Run y saltarse Cloud Armor? ¿Cómo llega un servicio serverless a una base de datos que solo tiene IP privada? ¿Qué pasa con un evento de pedido cuando falla el worker? Si el diagrama es una cuadrícula de iconos de productos, ninguna de las respuestas aparece en él.
Un diagrama de arquitectura de GCP útil muestra dónde vive cada cosa, cómo viajan las solicitudes y los ajustes que deciden la seguridad y la capacidad. Este artículo recorre una aplicación web típica de Google Cloud, desde el balanceador de carga y Cloud Run hasta Cloud SQL y Pub/Sub, y las decisiones detrás de cada pieza.
Empieza por la jerarquía de recursos
Los recursos de Google Cloud están en un árbol: una organización, carpetas opcionales y proyectos. Los roles de IAM y las políticas de la organización definidos en un nodo se aplican a todo lo que hay debajo (jerarquía de recursos). Las carpetas se pueden anidar hasta 10 niveles y cumplen el papel de los grupos de administración de una landing zone de Azure o de las unidades organizativas (OU) de una landing zone de AWS.
Una estructura habitual es una carpeta por entorno y un proyecto por aplicación y entorno, como shop-prod bajo production. El proyecto delimita la facturación, las cuotas y la mayoría de los permisos de IAM, y el ingress interno de Cloud Run solo confía en Pub/Sub del mismo proyecto o del mismo perímetro de VPC Service Controls.
El ejemplo, solicitud por solicitud
El ejemplo es una tienda en línea en el proyecto shop-prod: una arquitectura de tres capas con cómputo serverless en us-central1.
- El dominio apunta a la IP anycast de un Application Load Balancer externo global, que termina TLS con un certificado administrado por Google, aplica una política de Cloud Armor y sirve respuestas en caché desde Cloud CDN.
- El URL map envía
/api/*al servicioapiy todo lo demás aweb, cada uno a través de un grupo de puntos de conexión de red (NEG) serverless. webguarda las sesiones y una caché de páginas en Memorystore for Valkey.apiusa Cloud SQL for PostgreSQL por IP privada.apipublica eventos de pedido en Pub/Sub, que los envía por push aworker, un tercer servicio de Cloud Run que escribe PDF de facturas en Cloud Storage.- Las credenciales viven en Secret Manager; los logs y las métricas van a Cloud Logging y Cloud Monitoring.
Al momento de escribir esto (noviembre de 2026), una instancia de Cloud Run admite 80 solicitudes simultáneas por defecto (80 por vCPU con gcloud o Terraform), y una revisión escala hasta 100 instancias.
Ingress y cuentas de servicio
Cada servicio de Cloud Run recibe una URL run.app, y el ingress es all por defecto, así que cualquiera que tenga la URL puede saltarse el balanceador y Cloud Armor. Configura el ingress de web y api en internal-and-cloud-load-balancing (ajustes de ingress). Las solicitudes del balanceador no llevan identidad de Google, así que estos servicios también deben ser públicos; Google recomienda desactivar la comprobación de IAM Invoker en lugar de conceder el rol de invoker a allUsers. El worker usa el ingress internal, que aun así admite Pub/Sub del mismo proyecto, y conserva tanto la comprobación de IAM como su URL predeterminada, que es la que llama el push de Pub/Sub.
Por defecto, Cloud Run ejecuta el código con la cuenta de servicio predeterminada de Compute Engine, que puede tener el rol Editor en el proyecto según la política de la organización. Dale a cada servicio la suya:
| Cuenta de servicio | Roles (recurso) |
|---|---|
web-sa |
Ninguno; llega a Memorystore por la VPC |
api-sa |
Pub/Sub Publisher (topic orders), Secret Manager Secret Accessor (sus secretos) |
worker-sa |
Storage Object Creator (bucket invoices), Secret Manager Secret Accessor (sus secretos) |
push-sa |
Cloud Run Invoker (worker), usada por la suscripción push |
Los secretos en variables de entorno se leen cuando arranca una instancia, así que fija una versión (db-password:3 más abajo).
Redes serverless: Direct VPC egress o conector
Cloud Run no se ejecuta dentro de tu VPC, así que, para llegar a las IP privadas de Cloud SQL o Memorystore, su tráfico saliente debe entrar en una subred. Google recomienda Direct VPC egress frente a un conector de Serverless VPC Access; ambos están disponibles de forma general.
| Direct VPC egress | Conector de VPC Access | |
|---|---|---|
| Coste | Solo egress de red | Egress más las VM del conector |
| Latencia y rendimiento | Menor latencia, mayor rendimiento | Mayor latencia, menor rendimiento |
| Direcciones IP | Unas dos por instancia | Menos |
La subred debe ser /26 o mayor, Cloud Run usa el doble de direcciones que de instancias, y una revisión que reduce su escala conserva sus direcciones hasta 20 minutos. En un despliegue, api limitada a 40 instancias puede retener (40 + 40) × 2 = 160 direcciones. Con el valor por defecto de 100, un solo servicio necesita 400, más que las 252 utilizables de una /24, así que suma todos los servicios de la subred. Las instancias nuevas también pueden esperar un minuto o más antes de que funcione el egress, así que añade una sonda de arranque que pruebe una dependencia real.
gcloud run deploy api \
--image=us-central1-docker.pkg.dev/shop-prod/app/api:1.42 \
--region=us-central1 \
--service-account=api-sa@shop-prod.iam.gserviceaccount.com \
--ingress=internal-and-cloud-load-balancing \
--no-invoker-iam-check \
--network=shop-vpc --subnet=run-us-central1 \
--vpc-egress=private-ranges-only \
--max-instances=40 \
--set-secrets=DB_PASSWORD=db-password:3
Elegir el almacén de datos
Los SLA de abajo son de disponibilidad mensual en la mayoría de las regiones:
| Servicio | Elígelo cuando | SLA |
|---|---|---|
| Cloud SQL | PostgreSQL, MySQL o SQL Server estándar con menos de 64 TB | Con HA: 99,95 %, o 99,99 % en Enterprise Plus |
| AlloyDB | PostgreSQL con carga alta o analítica sobre datos en vivo | 99,99 % con HA |
| Spanner | Datos relacionales más allá de un solo primary, o escrituras en varias regiones | 99,99 % regional, 99,999 % multirregional |
| Firestore | Documentos para clientes web y móviles con sincronización sin conexión | 99,99 % regional, 99,999 % multirregional |
| Bigtable | Terabytes de datos de una sola clave con baja latencia | 99,9 % a 99,999 %, según la replicación |
Cloud SQL HA mantiene un standby replicado de forma síncrona en una segunda zona, y una conmutación por error tarda unos 60 segundos (alta disponibilidad). Con Cloud Run, vigila las conexiones: max_connections es 500 por defecto con 15 a 30 GB de memoria, y cada instancia de Cloud Run puede abrir hasta 100. Si limitas api a 40 instancias con un pool de 10, llega como máximo a 400 y deja margen.
Trabajo asíncrono: Pub/Sub o Cloud Tasks
El push de Pub/Sub exige acertar cuatro detalles:
- El worker confirma devolviendo 102, 200, 201, 202 o 204.
- El plazo de confirmación (de 10 a 600 segundos, 10 por defecto) debe superar el tiempo de procesamiento; si no, Pub/Sub reentrega mientras el primer intento sigue en curso.
- Un topic de mensajes fallidos recibe un mensaje tras 5 intentos de entrega por defecto; el agente de servicio de Pub/Sub necesita permiso para publicar en él.
- La entrega es al menos una vez, así que haz el worker idempotente; nombra cada PDF con el ID de su pedido.
Elige Cloud Tasks cuando el emisor deba controlar la entrega: tareas programadas, límites de velocidad de hasta 500 envíos por segundo por cola y deduplicación. Pub/Sub encaja con el fan-out a varios suscriptores. El diagrama de arquitectura serverless cubre más patrones de eventos.
Regiones y alta disponibilidad
Los fallos de zona están cubiertos: Cloud Run se reparte entre zonas, las réplicas de Memorystore caen en otras zonas y el standby de Cloud SQL toma el relevo. Sin embargo, los SLA se componen: 99,95 % de Cloud Run por 99,95 % de Cloud SQL HA da cerca de 99,90 %, es decir, 43 minutos de caída en un mes de 30 días (el 0,1 % de 43 200 minutos).
Para una caída de región, despliega una segunda región y añade su NEG serverless a cada servicio de backend. El balanceador envía entonces a los usuarios a la región más cercana, y la detección de valores atípicos aparta el tráfico de la que falla. Lo difícil son los datos: una réplica interregional de Cloud SQL que promueves, o Spanner multirregional. La conmutación por error multirregión en AWS y el diagrama de arquitectura de recuperación ante desastres cubren esas compensaciones.
Equivalencias entre AWS y Google Cloud
| AWS | Google Cloud |
|---|---|
| Organizations, OU, cuentas | Organización, carpetas, proyectos |
| ALB, CloudFront, AWS WAF | Application Load Balancer externo global, Cloud CDN, Cloud Armor |
| ECS on Fargate, Lambda | Servicios, jobs, worker pools y funciones de Cloud Run |
| RDS, Aurora | Cloud SQL, AlloyDB |
| ElastiCache | Memorystore |
| SQS, SNS | Cloud Tasks, Pub/Sub |
| CloudWatch | Cloud Logging, Cloud Monitoring |
| VPC (regional) | VPC (global, con subredes regionales) |
Las equivalencias son aproximadas; la comparación de servicios de Google lista más. Para el lado de AWS, consulta las subredes y tablas de rutas de una VPC para las redes y ECS on Fargate para los contenedores.
El diagrama de la aplicación web en Google Cloud
Contenido del diagrama
- Project shop-prod (folder: production)
- us-central1
- Users
- Global external Application LB
- web frontend
- api
- worker
- Memorystore for Valkey
- Cloud SQL for PostgreSQL
- Cloud Storage
- Pub/Sub topic
- Secret Manager
- Cloud Logging and Monitoring
- HTTPS
- /*
- /api/*
- sessions, page cache
- SQL over private IP
- publish
- push
- invoice PDFs
Cómo leerlo:
- Los marcos muestran el alcance. El marco exterior es el proyecto shop-prod en la carpeta production; el recuadro azul es la región us-central1. Los servicios globales quedan fuera de la región.
- Las aristas azules son la ruta de las solicitudes: HTTPS al balanceador, luego
/*al frontend web y/api/*a la api; la nota lista Cloud Armor, Cloud CDN y el certificado. - Las aristas verdes son acceso a datos: Memorystore para las sesiones, la instancia de Cloud SQL con HA por IP privada y Cloud Storage para los PDF de facturas.
- Las aristas moradas discontinuas son asíncronas. La api publica, Pub/Sub hace push al worker y un topic de mensajes fallidos recoge los mensajes tras cinco intentos.
- Secret Manager y el registro llevan notas en lugar de aristas, y el bloque Markdown lista los ajustes clave.
Dibujar con claridad diagramas de arquitectura de Google Cloud
- Anida la jerarquía: un marco de proyecto con su carpeta en la etiqueta, la región dentro y los servicios globales fuera de la región. No dibujes Cloud Run dentro de una subred; envía egress allí, pero no vive allí.
- Nombra el producto en cada etiqueta. Un recuadro llamado base de datos invita a una pregunta; Cloud SQL for PostgreSQL with HA la responde.
- Pon los ajustes de seguridad en la página: ingress, IP privadas y cuentas de servicio.
- Etiqueta las aristas con rutas y datos, y traza con guiones las asíncronas.
- Deja fuera las herramientas de compilación, las copias por zona de servicios regionales y los enlaces de IAM; guarda los roles en una tabla.
Constrúyelo en Archboard
- Inicia sesión con Google o GitHub y crea un diagrama.
- Añade un Marco del paquete Básico con la etiqueta Project shop-prod (folder: production), y dentro una Región del paquete Nube con la etiqueta us-central1.
- Coloca una Persona del paquete Modelo C4 a la izquierda del marco para los usuarios. Dentro del marco, a la izquierda de la región, añade un Balanceador de carga en la nube del paquete Nube y una nota Texto de Básico para Cloud Armor, Cloud CDN y el certificado.
- En la región, añade tres nodos Recurso en la nube del paquete Nube con los nombres web frontend, api y worker, y establece su tipo de recurso en Cloud Run service.
- A su lado, añade un nodo Redis del paquete Datos para Memorystore, y luego Base de datos administrada y Almacenamiento de objetos del paquete Nube para Cloud SQL y Cloud Storage.
- Fuera de la región, añade un Tema del paquete Datos para Pub/Sub, una Bóveda del paquete Seguridad para Secret Manager y un nodo Registros del paquete DevOps, con notas Texto de Básico.
- Dibuja aristas etiquetadas: HTTPS, /, /api/, sessions and page cache, SQL over private IP e invoice PDFs. Haz discontinuas publish y push.
- Añade un bloque Markdown del paquete Básico con los ajustes clave.
Archboard no importa desde una cuenta activa de Google Cloud; si el proyecto está en Terraform, la herramienta gratuita Terraform to diagram te da un primer borrador editable. Consulta los diagramas de arquitectura en la nube para ver los tipos de nodos de nube. El ejemplo usa 14 nodos de diagrama, dentro del plan Free.
Preguntas frecuentes
¿Qué debe mostrar un diagrama de arquitectura de Google Cloud? El proyecto y la carpeta, la región, cada componente de la ruta de las solicitudes y los ajustes que deciden la seguridad: ingress, IP privadas y cuentas de servicio. Los servicios globales como Pub/Sub van fuera del recuadro de la región.
¿Cloud Run se ejecuta dentro de una VPC? No. Se ejecuta en infraestructura administrada por Google; Direct VPC egress o un conector envía su tráfico saliente a tu subred para que pueda llegar a IP privadas.
¿Debo usar Direct VPC egress o un conector de Serverless VPC Access? Direct VPC egress para la mayoría de los servicios: Google lo recomienda, la latencia es menor y solo pagas el egress. Un conector usa menos direcciones IP y da arranques en frío más rápidos detrás de Cloud NAT.
¿Cómo evito que los usuarios se salten Cloud Armor? Configura el ingress de Cloud Run en internal-and-cloud-load-balancing para que el tráfico de internet deba pasar por el Application Load Balancer externo, y desactiva la URL run.app predeterminada donde ningún servicio de Google la necesite.
¿Cuántas conexiones puede abrir Cloud Run a Cloud SQL? Hasta 100 por instancia. Mantén el máximo de instancias por el tamaño del pool por debajo de max_connections (500 por defecto con 15 a 30 GB de memoria), o usa Managed Connection Pooling en Enterprise Plus.