devops
fb5cf8bc98
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.
53 lines
2.6 KiB
Markdown
53 lines
2.6 KiB
Markdown
# CruzCloud Lab — Plataforma GitOps
|
|
|
|
> **TODO (fase 2+):** reescribir esta portada con la narrativa final. Por
|
|
> ahora describe el propósito y la audiencia para que la navegación y el
|
|
> `nav:` de `mkdocs.yml` tengan un punto de entrada real.
|
|
|
|
Este sitio documenta un laboratorio personal de **Platform Engineering**:
|
|
un cluster Kubernetes (k3d) corriendo sobre un NAS (ZimaOS), gobernado
|
|
100% por GitOps (Gitea + Argo CD), sirviendo una tienda de e-commerce real
|
|
(Medusa + Next.js) como carga de trabajo de referencia.
|
|
|
|
No es un tutorial genérico ni una demo de juguete: cada decisión, cada
|
|
incidente y cada diagrama de este sitio corresponde a un sistema que
|
|
corre de verdad, con los commits, logs y causas raíz reales que lo
|
|
probaron.
|
|
|
|
## Para quién es este sitio
|
|
|
|
Este portal sirve a tres audiencias distintas, y está organizado para
|
|
que cada una pueda entrar por su propia puerta:
|
|
|
|
- **Reclutadores / pares de Platform Engineering** — ver
|
|
[`decisiones/`](decisiones/0001-por-que-k3d.md) para el criterio
|
|
arquitectónico detrás del stack, y [`playbooks/`](playbooks/incidente-crashloop-medusa.md)
|
|
para diagnóstico real de incidentes (no solo "lo arreglé").
|
|
- **Alguien evaluando este patrón para un caso de negocio real**
|
|
(tienda desplegable desde ZimaOS) — ver
|
|
[`arquitectura/`](arquitectura/vision-general.md) para el flujo
|
|
completo y su costo/complejidad real.
|
|
- **Estudiantes empezando con GitOps/Kubernetes** (incluye a mi hijo,
|
|
7mo semestre de Ingeniería de Sistemas) — empezar por
|
|
[`guia-estudiante/`](guia-estudiante/README.md), pensada para alguien
|
|
que nunca ha visto estos conceptos.
|
|
|
|
## Mapa del sitio
|
|
|
|
| Sección | Qué encontrarás |
|
|
|---|---|
|
|
| [Arquitectura](arquitectura/vision-general.md) | Diagramas Mermaid del flujo completo, red/exposición, flujo GitOps, glosario |
|
|
| [Decisiones (ADRs)](decisiones/0001-por-que-k3d.md) | Por qué k3d, por qué Argo CD, por qué HTTP/2 sobre QUIC, etc. |
|
|
| [Playbooks](playbooks/incidente-crashloop-medusa.md) | Incidentes reales, diagnóstico paso a paso, causa raíz, fix |
|
|
| [Aprendizajes](aprendizajes/notas-sueltas.md) | Qué haría distinto, gotchas de Medusa v2 |
|
|
| [Guía del estudiante](guia-estudiante/README.md) | Ruta de aprendizaje desde cero |
|
|
|
|
## Estado de este sitio
|
|
|
|
Este portal se mantiene vivo junto con el lab — cada página muestra su
|
|
última fecha de modificación real (`git-revision-date-localized`). Si
|
|
una página dice "TODO", es contenido pendiente de una fase posterior,
|
|
no una promesa incumplida: la estructura completa se construyó primero
|
|
a propósito, para que el contenido se llene sección por sección con el
|
|
mismo criterio que el resto del lab.
|