docs: guía de migración vault v3 en sección de actualización del bot
Agrega nota en sección 18 de DEPLOY.md sobre correr migrar_vault_v3.py al actualizar desde versiones anteriores a v0.4.0 con tenants existentes. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
21
DEPLOY.md
21
DEPLOY.md
@@ -1069,6 +1069,27 @@ docker compose logs --tail=20
|
||||
> diff .env.example .env
|
||||
> ```
|
||||
|
||||
### Actualización especial: migración de credenciales a vault v3 (v0.4.0+)
|
||||
|
||||
Si el servidor tenía abogados registrados **antes de la versión v0.4.0**, sus credenciales en la DB
|
||||
están en formato v1 (cifrado simple). Hay que migrarlas a v3 (PBKDF2 + envelope encryption) **una sola vez**.
|
||||
|
||||
Hacerlo después del `git pull` y **antes** del `docker compose up -d`:
|
||||
|
||||
```bash
|
||||
# Dentro del contenedor (o con uv si no usás Docker):
|
||||
docker compose run --rm pedrito uv run python scripts/migrar_vault_v3.py --dry-run
|
||||
# Verificar que lista los tenants esperados, luego migrar de verdad:
|
||||
docker compose run --rm pedrito uv run python scripts/migrar_vault_v3.py
|
||||
```
|
||||
|
||||
El script:
|
||||
- Verifica que puede descifrar todos los tenants antes de tocar la DB
|
||||
- Hace backup automático de la DB (`data/pasante.db.bak`)
|
||||
- Si algo falla, no escribe nada — la DB original queda intacta
|
||||
|
||||
Si todos los tenants registrados son nuevos (post v0.4.0), este paso no es necesario.
|
||||
|
||||
---
|
||||
|
||||
## 19. Troubleshooting
|
||||
|
||||
Reference in New Issue
Block a user