Nuevos proyectos · 24h
Ir al contenido principal
Metodología de Ingeniería

Cómo trabajamos

Cada proyecto sigue el mismo proceso: evaluar, diseñar, construir, validar, documentar, operar. Los mismos principios se aplican tanto a un módulo Terraform como a un cluster EKS en producción.

El proceso

Modelo de trabajo en 6 fases

Cada fase tiene criterios de entrada, entregables y criterios de salida definidos. No se omite ninguna. Las fases 1–3 son secuenciales; 4–6 son continuas.

01

Discovery y Evaluación

1–2 semanas

Entender la infraestructura actual, identificar gaps, definir criterios de éxito. Sin suposiciones.

Diagrama de arquitectura actual Análisis de gaps vs. estado objetivo Registro de riesgos Documento de alcance del proyecto
02

Diseño de Arquitectura

1–2 semanas

Diseñar la arquitectura objetivo con documentación explícita de trade-offs. Cada decisión está justificada, no asumida.

Diagramas de arquitectura objetivo Diseño de módulos de infraestructura Modelo de seguridad (IAM, red, secretos) Architecture Decision Records (ADRs)
03

Implementación

2–8 semanas

Construir la infraestructura usando principios IaC-first. Cada recurso en Terraform. Cada despliegue de aplicación es GitOps.

Módulos Terraform (por componente) Pipelines CI/CD (GitHub Actions + Jenkins) Manifiestos Kubernetes con entrega GitOps Runbooks para procedimientos operacionales
04

Validación y Testing

Continuo

Cada implementación se prueba contra los requisitos definidos en la Fase 1. Sin despliegue sin pipeline verde.

Suite de tests automatizados (pytest, ShellCheck) Resultados de quality gate SonarCloud Resultados de load testing para rutas críticas Informes de security scan
05

Documentación

Continuo

La documentación se escribe junto al código, no después. Las decisiones de arquitectura, runbooks y guías operacionales son entregables, no añadidos posteriores.

README por módulo con documentación de inputs/outputs Runbooks para cada escenario operacional Architecture Decision Records Guía on-call con rutas de escalado
06

Operaciones y Transferencia

Continuo

Revisión de production readiness, validación de observabilidad, habilitación del equipo. El proyecto termina cuando el equipo cliente puede operar de forma independiente.

Checklist de production readiness (47 puntos) Dashboards de observabilidad (Grafana) Alertas configuradas y probadas Sesiones de transferencia de conocimiento

Principios innegociables

Estándares de ingeniería

No son preferencias. Son el mínimo exigible para cada entregable.

IaC-first

  • Cada recurso AWS en un módulo Terraform
  • Sin ClickOps en producción, nunca
  • Estado remoto S3 + bloqueo DynamoDB en todos los proyectos
  • terraform plan requerido antes de cada apply

Commits semánticos e higiene Git

  • Conventional commits: feat/fix/ci/docs/chore
  • Rama main protegida — PRs requeridos
  • CI debe pasar antes del merge
  • Sin force-push a main

set -euo pipefail en todos los scripts

  • -e: salir ante cualquier error
  • -u: tratar variables no definidas como errores
  • -o pipefail: capturar fallos en pipelines
  • Validación ShellCheck en CI sobre todos los .sh

Cero credenciales estáticas

  • GitHub Actions usa federación OIDC
  • EC2/EKS usa roles IAM (IRSA)
  • SSM Session Manager reemplaza SSH
  • Sin AWS_ACCESS_KEY_ID en ningún store de secretos

Ver la metodología en práctica

Cada proyecto de la cartera está construido con este proceso. Revisa los casos de uso o agenda una conversación para ver cómo aplica a tu infraestructura.