Proyecto hilo conductor: API + base contenerizadas, entregadas con CI

Proyecto hilo conductor — API + base contenerizadas, entregadas con CI

Objetivo: contenerizar una API con su base de datos, entregarla como un stack Compose fiable y automatizar su publicación con CI.
Material: la carpeta de ejemplo siguiente (API Node mínima + compose + workflow).
Método: termina un nivel de la guía y realiza la etapa correspondiente del proyecto.

⬇️ Descargar el compose de ejemplo (YML) ⬇️ Descargar el Dockerfile de ejemplo ⬇️ Chuleta Docker (TXT)

Etapa 0 · Nivel 0 — Entorno listo

Instala Docker, valida hello-world, crea la carpeta projet/mon-app con api/, compose.yml y .github/workflows. El ritual run/ps/stop/rm debe ser fluido.

Etapa 1 · Nivel 1 — Servicios del Hub conectados

Lanza postgres:16.4 con el volumen pgdata en la red monapp (sin publicar la base). Lanza adminer en el perfil dev. Demuestra rm + relanzamiento sin pérdida y resolución por nombre.

Etapa 2 · Nivel 2 — Imagen propia reforzada

Escribe el Dockerfile de la api (slim, dependencias primero, USER node, .dockerignore), construye mon-app:1.0, escanea y corrige hasta cero críticas.

Etapa 3 · Nivel 3 — Stack Compose completo

Ensambla api (build) + bdd (volumen) + adminer (perfil dev) con DATABASE_URL como variable, depends_on simple y luego retry aplicativo. Valida config, up --build, down/up sin pérdida.

Etapa 4 · Nivel 4 — Fiable y entregado con CI

Añade restart + healthcheck bdd + condición healthy, proxy publicado solo, copia dump + snapshot probada, workflow CI que construye + sube el SHA hacia GHCR.

Etapa 5 · Nivel 5 — Listo para lo siguiente

Audita con la checklist 5.4 (8 síes), prueba Swarm en un solo nodo (3 réplicas), despliega el K8s mínimo en kind. Planifica la DCA.

Criterios de éxito

La api y la base funcionan con un solo compose up, datos persistidos.
Ningún latest en prod, ningún secreto en git, USER non-root.
down/up sin pérdida, copia reproducida en un volumen de prueba.
La CI sube cada commit (SHA) sin intervención manual.