Agrega lo que faltaba para desplegar workloads/docs-portal/ (ya existente sin commitear): deployment/service/ingress + kustomization siguiendo el patrón de workloads/nginx, Applications de workload y gobernanza separadas, y el workflow de Gitea Actions (build+push a Gitea Registry, bump de versión en el manifiesto) siguiendo el mismo patrón que build.yaml/build-medusa.yaml.
2.3 KiB
Guía del estudiante — ruta de aprendizaje sugerida
Escrita para alguien que nunca ha visto GitOps ni Kubernetes. Si ya conoces estos conceptos, probablemente quieras saltar directo a Arquitectura o Decisiones.
TODO (fase 2+): convertir esto en una ruta paso a paso completa, con ejercicios o preguntas de verificación al final de cada parada. Por ahora es el esqueleto de la ruta.
Antes de empezar
No hace falta saber Kubernetes de antemano. Sí ayuda tener claro qué es un contenedor Docker — si eso todavía no es familiar, empieza por ahí antes de seguir.
Ruta sugerida
- Conceptos básicos — qué es un contenedor, qué es Kubernetes, qué problema resuelve.
- Glosario — términos clave (GitOps, tunnel, Argo CD, manifest) explicados en una frase antes del detalle técnico.
- Visión general de arquitectura — el diagrama completo: cómo llega una petición desde el navegador hasta la aplicación real.
- Flujo GitOps — qué pasa
exactamente entre que alguien hace
git pushy el cambio queda corriendo. - Un playbook real — empieza por el incidente del crashloop de Medusa: es un buen ejemplo de cómo se descarta una hipótesis con evidencia en vez de adivinar.
- Una decisión de arquitectura (ADR) — lee por qué k3d para ver cómo se documenta un trade-off real, no solo la elección final.
Si esto se convierte en proyecto de grado
Este lab es candidato razonable de base para un proyecto de grado porque ya tiene: infraestructura real corriendo, incidentes reales documentados con causa raíz, y decisiones arquitectónicas explícitas en vez de implícitas. La sección de aprendizajes es un buen punto de partida para encontrar preguntas de investigación abiertas (deuda técnica, mejoras pendientes) en vez de inventar un tema desde cero.
TODO: definir aquí, en una sesión futura, el alcance concreto de ese posible proyecto de grado (¿extender el lab? ¿documentar y analizar el patrón? ¿construir sobre él?).