Files

85 lines
3.7 KiB
Markdown

---
name: deploy
description: 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:
```powershell
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:
```bash
ssh root@10.0.0.217 "cd /opt/admin-edu-space && git fetch && git checkout dev && git pull origin dev"
```
2. Si hubo cambios en dependencias o esquema:
```bash
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"
```
3. Reiniciar servicios systemd del Backend y Frontend:
```bash
ssh root@10.0.0.217 "systemctl restart admin-edu-space-backend admin-edu-space-frontend"
```
4. Verificar estado del servicio:
```bash
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`