How danielpg25/fct-openshift works
Para dibujar un diagrama de arquitectura claro y detallado de este proyecto (Despliegue Continuo de Aplicaciones Web usando OpenShift), sigue estos pasos:
Identificar el tipo y propósito del proyecto
• Es un proyecto de introducción y práctica para desplegar aplicaciones web en un entorno PaaS (OpenShift) con despliegue continuo (CI/CD).
• No es una aplicación tradicional con frontend/backend propio, sino un entorno y flujo de despliegue que integra: máquina local (VM), cluster OpenShift (CRC), repositorios GitHub, Webhooks y herramientas de construcción (Source2Image, Dockerfile, Templates).
Analizar la estructura de componentes
• Entorno anfitrión: tu máquina (o VM CentOS 8), con CRC instalado.
• Cluster OpenShift: nodo único, gestiona Pods, DeploymentConfigs, Services, Routes, PersistentVolumes.
• Registro interno de imágenes: OpenShift ImageStream y registro integrado.
• Repositorios GitHub: alojan el código de las aplicaciones (Flask, PHP, WordPress template).
• Herramienta Ngrok: expone la API de OpenShift local a Internet para recibir Webhooks de GitHub.
• Canal de CI/CD:
a. Push en GitHub → Webhook (vía Ngrok) → BuildConfig/OpenShift → (S2I o Docker Build o Template) → ImageStream → DeploymentConfig → Pods → Service → Route.
Componentes principales a incluir en el diagrama
A. Desarrollador
• VSCode / línea de comandos → hace git push
B. GitHub
• Repositorio remoto
• Webhook configurado apuntando a la URL pública de Ngrok + ruta de buildconfig
C. Ngrok
• Túnel HTTP(s) que redirige solicitudes externas al API server de OpenShift (localhost:6443)
D. OpenShift Cluster (CRC)
1. API Server
2. Auth/Zones (namespaces/proyectos)
3. BuildConfigs (S2I, Dockerfile, Template)
4. ImageStreams
5. DeploymentConfigs / ReplicaSets
6. Pods
7. Services
8. Routes
9. PersistentVolumes / Claims
E. Contenedores de ejemplo
• Aplicación Flask (Python) mediante S2I
• Aplicación PHP (bookmedik) mediante Dockerfile
• WordPress + MySQL mediante plantilla YAML
Relaciones e interacciones
• Flechas direccionales que muestren:
1. git push → GitHub
2. GitHub Webhook (via Ngrok) → OpenShift API (BuildConfig trigger)
3. OpenShift BuildConfig → Source2Image / Docker Build / Template → construye imagen → almacena en ImageStream
4. ImageStream → despliegue (DeploymentConfig) → crea Pods
5. Pods → Service interno → Route → acceso externo
6. Template → crea a la vez recursos de base de datos y aplicación, con PersistentVolumeClaims
Patrones y principios presentes
• CI/CD pipeline: build automático tras push
• Container-as-a-Service: abstraer infraestructura con OpenShift
• Inmutabilidad y reproducibilidad: construcción de contenedores vía S2I/Dockerfile/Templates
• Separación de responsabilidades:
· Fuente de verdad (Git)
· Orquestación (OpenShift)
· Exposición pública (Routes, Ngrok)
· Almacenamiento persistente (PVC)
Guía para adaptar el diagrama a este caso
• Usa formas distintas (rectángulos, cilindros, nube) para:
· Componentes locales vs. remotos vs. cluster
· Tipos de build (S2I, Dockerfile, Template)
· Azul: desarrollo/git
· Verde: OpenShift core (API, Builds, Pods)
· Naranja: network/exposición (Ngrok, Routes)
· Marrón: almacenamiento persistente
Elementos obligatorios en el diagrama
• Etiquetas claras de cada elemento (ej. “BuildConfig: flask-temperaturas-s2i”)
• Flechas dirigidas con anotaciones de protocolo/evento (HTTP POST Webhook, oc start, etc.)
• Leyenda de colores y formas para distinguir capas:
· Capa de CI/CD
· Capa de orquestación de contenedores
· Capa de red (exposición externa)
· Capa de almacenamiento
Conclusión
El diagrama debe reflejar el flujo completo desde el git push hasta la entrega del contenedor en producción simulada sobre CRC, destacando las tres alternativas de build (S2I, Dockerfile, Template) y mostrando cómo se integra Ngrok para CI/CD local. Con estos elementos claros, el principal software engineer tendrá una visión precisa de la arquitectura end-to-end del proyecto.