Saltar al contenido

Diagrama de arquitectura de Google Cloud: una aplicación web en Cloud Run y Cloud SQL

Una arquitectura de referencia de Google Cloud para una aplicación web, dibujada y explicada: balanceador, Cloud Run, Cloud SQL, Memorystore, Pub/Sub, IAM y redes.

· Fundador y desarrollador

Publicado el

Diagrama de un proyecto de Google Cloud con una región us-central1. Los usuarios envían HTTPS a un balanceador global que enruta a los servicios web y api en Cloud Run. La api usa Cloud SQL y publica en Pub/Sub, que hace push a un worker que escribe PDF en Cloud Storage.

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.

  1. 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.
  2. El URL map envía /api/* al servicio api y todo lo demás a web, cada uno a través de un grupo de puntos de conexión de red (NEG) serverless.
  3. web guarda las sesiones y una caché de páginas en Memorystore for Valkey. api usa Cloud SQL for PostgreSQL por IP privada.
  4. api publica eventos de pedido en Pub/Sub, que los envía por push a worker, un tercer servicio de Cloud Run que escribe PDF de facturas en Cloud Storage.
  5. 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

Diagrama de un proyecto de Google Cloud con una región us-central1. Los usuarios envían HTTPS a un balanceador global que enruta a los servicios web y api en Cloud Run. La api usa Cloud SQL y publica en Pub/Sub, que hace push a un worker que escribe PDF en Cloud Storage.

19 componentes · 8 conexiones

Abrir en Archboard
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
Una aplicación web en un proyecto de Google Cloud. Un Application Load Balancer global con Cloud Armor y Cloud CDN enruta a servicios de Cloud Run en us-central1, que llegan a Cloud SQL y Memorystore por IP privada y pasan el trabajo lento a un worker mediante Pub/Sub.

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

  1. Inicia sesión con Google o GitHub y crea un diagrama.
  2. 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.
  3. 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.
  4. 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.
  5. 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.
  6. 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.
  7. Dibuja aristas etiquetadas: HTTPS, /, /api/, sessions and page cache, SQL over private IP e invoice PDFs. Haz discontinuas publish y push.
  8. 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.

Empieza gratis — un puesto, sin tarjeta de crédito.

Artículos relacionados

← Volver al blog

Abre un lienzo en un minuto

Inicia sesión con Google o GitHub. Gratis para un asiento. Mejora el plan cuando se una el equipo.