# A03 - Ámbito dtic-BKPs

> Manifiesto de Ámbito | Referencia: [`adn/01_ontologia.md`](../../../adn/01_ontologia.md)

## Identificación

| Campo | Valor |
| :--- | :--- |
| **Código** | A03 |
| **Nombre** | Backups de Servidores — dtic-BKPs |
| **Estado** | ⏳ En Ejecución |
| **Inicio** | 06/04/2026 |
| **Fin Estimado** | Recurrente (operación continua) |

## Objetivo

El ámbito **dtic-BKPs** engloba todas las operaciones de respaldo (backup), procesamiento y sincronización de máquinas virtuales y datos críticos de la infraestructura DTIC. Esto incluye:

1. **Procesamiento de backups de VMs** (XenServer y Proxmox) desde orígenes locales y remotos.
2. **Sincronización y descarga** de archivos de respaldo entre nodos de almacenamiento.
3. **Upload a la nube** (OneDrive) de backups procesados para resguardo offsite.

## Herramientas

| Herramienta | Uso |
| :--- | :--- |
| **ADN CLI `bkps`** | `./adn/tools/run bkps <subcomando>` — interfaz unificada |
| **bkps.yml** | Configuración declarativa de tareas y comandos (`adn/tools/bkps/bkps.yml`) |
| **rclone** | Sincronización de archivos local ↔ remoto ↔ nube |
| **VZDump** | Respaldos offline de VMs Proxmox (stop mode) |
| **screen** | Sesiones desatendidas para operaciones largas |
| **ADN CLI `dron`** | `./adn/tools/run dron` — vigía de tareas largas con auto-cierre de bitácora |

## Nodos Involucrados

| Nodo | Rol en el Ámbito |
| :--- | :--- |
| **srv-ns8** | Almacenamiento central (ns8Disco2/ns8Disco3), procesamiento de backups |
| **pve_PMOX3** | Origen de dumps Proxmox (zfsDISCO1) |
| **srvv-maurik** | Origen de backups XenServer |

## Tareas Configuradas

| ID | Descripción | Tipo |
| :--- | :--- | :--- |
| `proc_syncXen1` | Procesar BKPs de VMs XEN01 | xva |
| `proc_syncPmox` | Procesar BKPs de VMs Proxmox | proxmox |
| `sinc_pmox_ns8` | Descargar BKPs de zfsDISCO1 | rclone |
| `sync_BkpAntiguos_nube` | Upload bkps-ANTIGUOS a OneDrive | rclone |
| `sync_BkpsSERVIDORes_nube` | Upload bkps-SERVIDORes a OneDrive | rclone |
| `sync_BkpUsers_nube` | Upload bkps-USERs a OneDrive | rclone |

## Comandos Compuestos

| ID | Descripción | Tareas |
| :--- | :--- | :--- |
| `descargar_y_procesar_pmox` | Descargar y Procesar BKPs de PMOX | sinc_pmox_ns8 → proc_syncPmox |
| `full_procesamiento` | Procesar TODOS los BKPs | proc_syncXen1 → proc_syncPmox |
| `full_upload` | Subir todos los BKPs a la Nube | sync_BkpAntiguos, sync_BkpsSERVIDORes, sync_BkpUsers |
| `full_full` | Procesar y Subir todo | Todas las tareas |
| `dasuten_full` | 🔄 Pipeline COMPLETO DASUTEN (semanal) | dasuten_export_full → transferir → upload → download → restaurar_full → verificar |
| `dasuten_diferencial` | 🔄 Pipeline DIFERENCIAL DASUTEN (diario) | dasuten_export_dif → transferir → upload → download → restaurar_dif → verificar |

## Flujo de Trabajo Típico

```
1. Registrar evento en bitácora (inicio de jornada de backups)
2. Ejecutar: ./adn/tools/run bkps run <T1|C1|ID>
3. Monitorear progreso (screen -r si es desatendido)
4. Cerrar evento en bitácora con hora de fin
```

### Subcomandos ADN disponibles

```bash
./adn/tools/run bkps help              # Ayuda
./adn/tools/run bkps list              # Listar tareas y comandos
./adn/tools/run bkps run T1            # Ejecutar tarea individual
./adn/tools/run bkps run C4 --batch    # Pipeline completo sin interacción
./adn/tools/run bkps run T1 --dry-run  # Simulación
./adn/tools/run bkps status            # Estado del sistema + espacio disco
./adn/tools/run bkps estados           # Estado Proxmox en tiempo real
./adn/tools/run bkps backup <nodo>     # Backup remoto individual (vzdump)
./adn/tools/run bkps buscar <nodo>     # Buscar backups en 3 tiers
./adn/tools/run bkps sanear            # Sanear 3 tiers (Proxmox+Local+Nube)
./adn/tools/run bkps sanear --tier 2   # Sanear solo tier específico
./adn/tools/run bkps menu              # Menú interactivo (auto-screen)
```

## Planes Asociados

| Código | Nombre | Estado |
| :--- | :--- | :--- |
| [A03.P001](A03.P001_Migracion_ADN.md) | Migración a Tools ADN | ✅ |
| [A03.P002](A03.P002_Automatizacion_Backups.md) | Automatización de Backups | ✅ |
| [A03.P003](A03.P003_Optimizacion_SysAcadWeb.md) | Optimización de Backup SysAcadWeb | ⏳ |

## 🛸 Sistema de Drones (Operación Autónoma)

**Herramienta:** `./adn/tools/run dron <subcomando>`

| Subcomando | Función |
| :--- | :--- |
| `dron lanzar --evento ID/AUTO --nota "X" -- <cmd>` | Lanzar tarea en background con auto-bitácora |
| `dron flota` | Dashboard compacto de la flota |
| `dron salud` | Health check activo (detecta zombies/estancados) |
| `dron estado` | Estado detallado de cada dron |
| `dron limpiar` | Limpiar tareas completadas/fallidas |

**Estado actual (2026-04-09 08:40):** Dron activo procesando XEN01 (srv-MauriK, srv-SysACADWeb)

**Evento AUTO:** Crea evento de bitácora automáticamente y lo cierra al finalizar. Ideal para cron jobs y tareas desatendidas.

**Ejemplo cron:**
```bash
./adn/tools/run dron lanzar --evento AUTO --nota "Backup nocturno C4" -- ./adn/tools/run bkps run C4 --batch
```

## 🔄 Armonía Integral

**Última actualización:** 2026-04-06 (reestructuración completada)

| Documento | Estado | Notas |
| :--- | :--- | :--- |
| `docs/contexto/IA.md` | ✅ Actualizado | Procedimiento de Armonía Integral agregado |
| `A03_dtic-BKPs.md` | ✅ Actualizado | Manifiesto con drones y estructura estándar |
| `A03.P002_Automatizacion_Backups.md` | ✅ Actualizado | Versión 1.2, estado de drones |

---

## Referencias

- **CLI ADN**: `./adn/tools/run bkps help`
- **Código fuente**: [`adn/tools/bkps/bkps.rb`](../../../adn/tools/bkps/bkps.rb)
- **Configuración**: [`adn/tools/bkps/bkps.yml`](../../../adn/tools/bkps/bkps.yml)
- **Legacy (archivado)**: [`_hist/dtic-BKPs/`](../../../_hist/dtic-BKPs/) — versión standalone pre-migración
- **ADN Ontología**: [`adn/01_ontologia.md`](../../../adn/01_ontologia.md)
- **Bitácoras**: `./adn/tools/run db evento:listar --ambito dtic-BKPs`