Files
admin-edu-space/.agents/skills/deploy/SKILL.md
T

3.7 KiB

name, description
name description
deploy Procedimiento innegociable de bump semántico de versión, git push y despliegue continuo en producción (LXC 10.0.0.217) utilizando .credenciales.

Skill: Despliegue Continuo, Bump de Versión y Git Push

Esta skill define el protocolo obligatorio para consolidar, versionar, publicar y desplegar cambios en admin-edu-space.


Principio Rector (Principios 9 y 10 de la Constitución)

Toda tarea concluida que modifique funcionalidad, corrija errores o altere la interfaz debe: 0. Tolerancia Cero a Errores en Código (@[current_problems]): Es mandatorio verificar y resolver al 100% cualquier error de linter, compilación, imports o advertencias críticas antes de compilar o empaquetar. Nunca dar una tarea por terminada si hay errores en el código.

  1. Subir la versión semántica de forma coordinada.
  2. Ejecutar git push al repositorio remoto en la rama activa (dev y main).
  3. Desplegar inmediatamente en producción en el servidor institucional utilizando las credenciales registradas en .credenciales.

Paso 0: Verificación de Código Limpio (Zero Errors)

Antes de proceder con el bump de versión:

  • Inspeccionar y limpiar todos los problemas reportados en @[current_problems].
  • Ejecutar suite de pruebas: cd backend && .\venv\Scripts\python.exe -m pytest tests -v.
  • Verificar que el compilador no reporte errores de sintaxis ni de tipos: py_compile.

Paso 1: Bump Semántico de Versión

Incrementar la versión siguiendo SemVer (X.Y.Z) en todos los descriptores del proyecto:

  • frontend/package.json ("version": "X.Y.Z")
  • frontend/src/app.js (APP_VERSION, FRONTEND_VERSION, BACKEND_VERSION)
  • backend/app/__init__.py (__version__ = "X.Y.Z")
  • backend/setup.py (version="X.Y.Z")
  • backend/app/routes/api/openapi.py ("version": "X.Y.Z")
  • CHANGELOG.md (Nueva sección ## [X.Y.Z] - YYYY-MM-DD)
  • MEMORY.md (Registrar hito del sprint)

Paso 2: Git Commit y Push

Ejecutar la suite de pruebas (python -m pytest tests -v en backend). Si está 100% en verde:

git add .
git commit -m "feat/fix: descripción del cambio (vX.Y.Z)"
git push origin dev

Paso 3: Despliegue en Servidor de Producción (LXC Edu-Admin-Space)

Consultar el archivo .credenciales en la raíz del proyecto para obtener la IP, usuario y contraseña del host:

  • Host / IP: 10.0.0.217 (LXC Debian Edu-Admin-Space)
  • Dominio Público: https://eduspace.oemspot.com.ar
  • Usuario SSH: root
  • Acceso: Credenciales de .credenciales

Comandos de Despliegue Remoto:

  1. Conectar vía SSH y sincronizar repositorio en el servidor:
ssh root@10.0.0.217 "cd /opt/admin-edu-space && git fetch && git checkout dev && git pull origin dev"
  1. Si hubo cambios en dependencias o esquema:
ssh root@10.0.0.217 "cd /opt/admin-edu-space/backend && ./venv/bin/pip install -r requirements.txt && ./venv/bin/flask db upgrade"
ssh root@10.0.0.217 "cd /opt/admin-edu-space/frontend && npm install"
  1. Reiniciar servicios systemd del Backend y Frontend:
ssh root@10.0.0.217 "systemctl restart admin-edu-space-backend admin-edu-space-frontend"
  1. Verificar estado del servicio:
ssh root@10.0.0.217 "systemctl status admin-edu-space-backend --no-pager"
ssh root@10.0.0.217 "systemctl status admin-edu-space-frontend --no-pager"

Paso 4: Verificación de Disponibilidad en Vivo (Smoke Test)

Comprobar que el endpoint público responde HTTP 200 con la nueva versión:

  • Backend version: https://eduspace.oemspot.com.ar/api/v1/version o http://10.0.0.217:5000/api/v1/version
  • Frontend version: https://eduspace.oemspot.com.ar/version
  • Pantalla de login accesible: HTTP 200 en https://eduspace.oemspot.com.ar/login