Saltar al contenido
vfernandezg.devProyectosContacto
Todos los proyectos

Infraestructura AWS como código

Plataforma de reservas en AWS definida en Terraform. CloudFront y WAF delante de ECS Fargate y RDS PostgreSQL en subredes privadas, con pruebas, escaneo de seguridad y despliegues con aprobación.

Diagrama de arquitectura en AWS. Los usuarios entran por CloudFront con WAF hacia S3 o hacia API Gateway con Cognito; un VPC Link lleva al balanceador interno, a ECS Fargate y a RDS PostgreSQL en subredes privadas. Debajo, el flujo de despliegue, de pull request a plan, aprobación, apply y prueba de humoDiagrama de arquitectura en AWS. Los usuarios entran por CloudFront con WAF hacia S3 o hacia API Gateway con Cognito; un VPC Link lleva al balanceador interno, a ECS Fargate y a RDS PostgreSQL en subredes privadas. Debajo, el flujo de despliegue, de pull request a plan, aprobación, apply y prueba de humo
Rol
Proyecto universitario en equipo de cinco en 2025; rediseño completo y autoría individual de la versión actual en 2026
Periodo
jun 2025 — jul 2025
Estado
Completado
Tecnologías
  • Terraform
  • AWS
  • GitHub Actions
  • Docker
  • PostgreSQL
  • Checkov
  • Jenkins

El proyecto nació en 2025 como trabajo universitario en equipo: un primer despliegue con Terraform de un sistema de reservas, con instancias EC2, un balanceador público, RDS MySQL y pipelines de Jenkins. En noviembre de 2026 lo rediseñé por completo por mi cuenta. La versión actual define en Terraform la plataforma de un negocio de reservas de eventos, con tres entornos (desarrollo, staging y producción) que salen de un único módulo raíz y trece módulos.

Arquitectura

  • Entrada. CloudFront con un WAF es la única puerta pública. El sitio estático sale de un bucket S3 privado y las rutas /api/* van a un HTTP API de API Gateway, que valida el JWT emitido por Cognito.
  • Núcleo privado. API Gateway llega por un VPC Link a un balanceador interno y de ahí a tareas de ECS Fargate en ARM64 con autoescalado. Nada dentro de la VPC queda expuesto a internet.
  • Datos. RDS for PostgreSQL 18 vive en subredes aisladas sin ruta de salida. En producción mantiene una réplica en espera en otra zona (Multi-AZ).
  • Red. Una VPC de tres niveles en dos zonas de disponibilidad. Los grupos de seguridad se encadenan por referencia, del VPC Link al balanceador, a las tareas y a la base de datos; ninguna regla de entrada usa rangos de IP.

Decisiones de ingeniería

  • El balanceador es interno y aun así verifica una cabecera. API Gateway siempre expone su propia dirección pública, y quien la llame directamente se saltaría el WAF. CloudFront añade una cabecera secreta y el balanceador responde 403 si falta.
  • Ninguna contraseña en el código ni en el estado. RDS genera y rota la contraseña de la base de datos en Secrets Manager, y ECS la inyecta al arrancar la tarea. El CI entra a AWS con roles OIDC de GitHub, sin claves de larga duración.
  • De Aurora a RDS. El primer despliegue real fue en una cuenta del plan gratuito de AWS, que no permite crear Aurora Serverless dentro de una VPC. Antes que sacar la base de datos de la red privada, cambié a RDS for PostgreSQL y dejé la decisión escrita en un ADR.
  • Costo según el entorno. Graviton en las tareas y en la base de datos, Fargate Spot y un solo NAT fuera de producción, y Multi-AZ solo en producción. Lo que cambia entre entornos está en un archivo de variables por entorno.

Calidad y entrega

  • Pruebas. 25 casos de terraform test con el proveedor de AWS simulado: distribución de subredes, encadenado de grupos de seguridad, rutas con JWT, cifrado y alta disponibilidad de la base de datos.
  • Escaneo. TFLint, Trivy y Checkov, con unas 280 políticas sobre la configuración de producción y ningún fallo, frente a las 62 comprobaciones que fallaban en el proyecto original. Cada excepción está justificada junto al recurso, y gitleaks revisa el historial completo en busca de secretos.
  • Despliegue. Cada pull request publica el plan de Terraform como comentario. El apply es manual: plan, aprobación de los revisores del entorno, apply de ese mismo plan guardado y pruebas de humo contra el entorno desplegado.
  • Imagen. La imagen ARM64 de la aplicación se publica en ECR con su lista de componentes (SBOM) y una atestación de procedencia firmada.
  • Jenkins. El repositorio conserva un pipeline alternativo con las mismas comprobaciones y un controlador configurado como código.

Ejecución del CI en GitHub Actions con seis comprobaciones aprobadas: formato, validación y pruebas de Terraform, TFLint, Trivy y Checkov, terraform-docs, gitleaks y lint de Dockerfile y scripts Ejecución del CI en GitHub Actions con seis comprobaciones aprobadas: formato, validación y pruebas de Terraform, TFLint, Trivy y Checkov, terraform-docs, gitleaks y lint de Dockerfile y scripts

El entorno desplegado

El entorno de desarrollo se desplegó en AWS con esta misma configuración y con la versión del último commit: 115 recursos gestionados por Terraform. No se mantiene encendido, porque el NAT, el balanceador y la base de datos se pagan por hora, así que lo que sigue es el registro de ese despliegue, del 14 de noviembre de 2026.

La prueba de humo del repositorio, de extremo a extremo:

PASS  Static site served from S3 via CloudFront                200
PASS  API health through CloudFront                            200
PASS  Anonymous API route                                      200
PASS  Database round-trip over TLS                             200
PASS  Protected route without a token is rejected              401
PASS  WAF blocks a SQL injection probe                         403
PASS  Calling API Gateway directly (bypassing CloudFront)      403
All checks passed.

El servicio de ECS, con su tarea en ejecución, el despliegue completado y el destino del balanceador en buen estado:

Consola de ECS con el servicio activo, una tarea en ejecución de una deseada, el despliegue completado y un destino del balanceador en buen estado Consola de ECS con el servicio activo, una tarea en ejecución de una deseada, el despliegue completado y un destino del balanceador en buen estado

Esa tarea de Fargate es la que responde por la ruta pública, con la versión desplegada y su zona de disponibilidad:

Página del entorno de desarrollo desplegado. Al pulsar el botón de la ruta pública, la API responde 200 con un saludo desde ECS Fargate en ARM64, la versión desplegada y la zona de disponibilidad Página del entorno de desarrollo desplegado. Al pulsar el botón de la ruta pública, la API responde 200 con un saludo desde ECS Fargate en ARM64, la versión desplegada y la zona de disponibilidad

La base de datos, una instancia de PostgreSQL en Graviton, y la comprobación que va y vuelve hasta ella:

Consola de RDS con la instancia en estado disponible, motor PostgreSQL y clase db.t4g.micro Consola de RDS con la instancia en estado disponible, motor PostgreSQL y clase db.t4g.micro

Respuesta 200 de la ruta de comprobación de base de datos, con estado ok, motor postgresql y la latencia de la consulta Respuesta 200 de la ruta de comprobación de base de datos, con estado ok, motor postgresql y la latencia de la consulta

La red: seis subredes en dos zonas de disponibilidad, cada nivel con su tabla de rutas y sus salidas.

Mapa de recursos de la VPC con seis subredes públicas, de aplicación y de datos en dos zonas, cinco tablas de rutas y tres conexiones de red Mapa de recursos de la VPC con seis subredes públicas, de aplicación y de datos en dos zonas, cinco tablas de rutas y tres conexiones de red

En el borde, el WAF contó las peticiones de las pruebas y bloqueó las que llevaban inyección SQL; la ruta protegida, sin token, responde 401.

Totales del WAF en tres horas: 87 peticiones, 81 permitidas y 6 bloqueadas Totales del WAF en tres horas: 87 peticiones, 81 permitidas y 6 bloqueadas

Respuesta 401 de la ruta protegida al llamarla sin token, con el mensaje Unauthorized Respuesta 401 de la ruta protegida al llamarla sin token, con el mensaje Unauthorized

Y el panel de CloudWatch que crea el propio Terraform, con una gráfica por nivel: CloudFront, WAF, API Gateway, balanceador, ECS y RDS.

Panel de CloudWatch con seis gráficas: peticiones y errores de CloudFront, peticiones permitidas y bloqueadas por el WAF, API Gateway, tiempos del balanceador, CPU y memoria de ECS, y CPU y conexiones de RDS Panel de CloudWatch con seis gráficas: peticiones y errores de CloudFront, peticiones permitidas y bloqueadas por el WAF, API Gateway, tiempos del balanceador, CPU y memoria de ECS, y CPU y conexiones de RDS

Límites

La API que corre en Fargate es un marcador de posición en TypeScript, con el esquema de base de datos del proyecto original portado de MySQL a PostgreSQL. Todavía no hay dominio propio, la aplicación usa el secreto maestro que gestiona RDS en lugar de un usuario con permisos mínimos, y la recuperación ante la caída de una región está en la hoja de ruta.