🚀 Fase de Implementación - Despliegue y Soporte

Esta sección proporciona las instrucciones necesarias para desplegar el sistema PTMD-BDB en entornos de desarrollo y producción, asegurando la reproducibilidad de la PoC.


Despliegue Local (Docker Compose)

La forma más rápida de ejecutar el sistema completo (Frontend + Backend + DB) es mediante Docker Compose.

Requisitos Previos

  • Docker y Docker Compose instalados.
  • Token de GitHub (opcional, para validación real).
  • Credenciales de Mailtrap (para notificaciones por email).

Pasos para el Despligue

  1. Configuración: Clonar el repositorio y configurar el archivo .env con las variables de entorno necesarias (ofuscadas en esta demo).
  2. Construcción: Ejecutar el comando de construcción para generar las imágenes de los microservicios.
    docker-compose build
    
  3. Ejecución: Levantar los servicios en segundo plano.
    docker-compose up -d
    
  4. Acceso:
    • Frontend: http://localhost:4200
    • API Gateway: http://localhost:3003

Despliegue en AWS (Infraestructura como Código)

El despliegue en producción se realiza mediante Terraform, automatizando la creación de los recursos en la nube.

Flujo de Despliegue IaC

  1. Inicialización: Preparar el backend de estado en S3.
    terraform init
    
  2. Validación: Revisar el plan de ejecución para detectar cambios.
    terraform plan
    
  3. Aplicación: Desplegar la infraestructura completa (VPC, ECS, RDS).
    terraform apply
    

Verificación Post-Instalación

Una vez desplegado, realizar las siguientes comprobaciones para asegurar la salud del sistema:

  • Health Checks: Verificar que el endpoint /health de los microservicios retorne 200 OK.
  • Conectividad DB: Confirmar que el Release Manager puede conectarse exitosamente a PostgreSQL.
  • Integración GitHub: Ejecutar una prueba de creación de release con una URL de PR válida para validar la comunicación con la API externa.
  • Logs: Monitorear los logs mediante docker logs -f o AWS CloudWatch para detectar errores tempranos en el motor de reglas.

Soporte y Mantenimiento

  • Audit Log: Consultar la tabla audit_log para cualquier investigación sobre decisiones de aprobación automática.
  • Escalabilidad: Para aumentar la capacidad, ajustar el parámetro desired_count en las tareas de ECS Fargate mediante Terraform.

[!NOTE] Para cualquier duda técnica o reporte de fallos en esta PoC, por favor contactar al equipo de Optimización de Ciclo de Vida a través de los canales oficiales.


Volver arriba

© 2026 Banco de Bogotá - Optimización de Ciclo de Vida de Software

This site uses Just the Docs, a documentation theme for Jekyll.