Files
apps-registry/workloads/docs-portal/docs/guia-estudiante/README.md
devops fb5cf8bc98 feat(docs-portal): pipeline GitOps y manifiestos K8s para el portal MkDocs
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.
2026-08-13 21:08:04 -05:00

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

  1. Conceptos básicos — qué es un contenedor, qué es Kubernetes, qué problema resuelve.
  2. Glosario — términos clave (GitOps, tunnel, Argo CD, manifest) explicados en una frase antes del detalle técnico.
  3. Visión general de arquitectura — el diagrama completo: cómo llega una petición desde el navegador hasta la aplicación real.
  4. Flujo GitOps — qué pasa exactamente entre que alguien hace git push y el cambio queda corriendo.
  5. 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.
  6. 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?).