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.
- Subir la versión semántica de forma coordinada.
- Ejecutar
git pushal repositorio remoto en la rama activa (devymain). - 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:
- 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"
- 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"
- Reiniciar servicios systemd del Backend y Frontend:
ssh root@10.0.0.217 "systemctl restart admin-edu-space-backend admin-edu-space-frontend"
- 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/versionohttp://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