feat: release v3.5.0 - formal MVP Bedelia closure, SDD harness, cartelera export, docs cleanup & model fixes
This commit is contained in:
@@ -0,0 +1,75 @@
|
||||
---
|
||||
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 (Principio 9 de la Constitución)
|
||||
Toda tarea concluida que modifique funcionalidad, corrija errores o altere la interfaz debe:
|
||||
1. **Subir la versión semántica** de forma coordinada.
|
||||
2. **Ejecutar `git push`** al repositorio remoto en la rama activa (`dev`).
|
||||
3. **Desplegar inmediatamente en producción** en el servidor institucional utilizando las credenciales registradas en `.credenciales`.
|
||||
|
||||
---
|
||||
|
||||
## 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`
|
||||
Reference in New Issue
Block a user