RUNBOOK job-envio-puma¶
| Sintoma | Causa probable | Accion |
|---|---|---|
| exit 2 "Falta la variable..." | .env incompleto |
Completar ATHENAS_DB_URL y PUMA_SFTP_* |
| "Error en la fecha ...: ... no devolvio las columnas esperadas: X" | Cambio de esquema en el SP (en el original: 153 KeyError 'TALLE_PRO') |
Avisar a BI; el envio de ese dia no se hizo. Relanzar con --desde tras corregir el SP |
| "Error en la fecha ...: Ventas y stock no devolvieron sucursales" | Los SP no devolvieron filas | Revisar la carga de ATHENAS; relanzar con --desde |
MemoryError / "Unable to allocate" |
Mucho volumen en ventas/stock (el original lo sufrio con 11,6 M de filas por el producto cruzado del resumen, ya eliminado) | Revisar el tamano de los SP; dimensionar RAM del contenedor |
| "Fallo la subida SFTP: ..." (tras el reintento) | Corte (el original registro 110 timeouts al |
Verificar PUMA_SFTP_* y red; relanzar. Los TXT quedan en output/<aaaammdd>/ |
| "Error en el backup (...)" | PUMA_BACKUP_DIR no montado o sin permiso (el original: 543 Permission denied) |
Revisar el montaje CIFS del share; el envio SI se hizo. Para rehacer solo el backup hay que relanzar el dia (reenvia los TXT) |
| "Error registrando el resumen por sucursal" | BD inaccesible o sin permiso en tbl_Info_Nike_New |
El envio y el backup ya estan hechos; relanzar el dia reenviaria los TXT, por lo que conviene insertar el resumen a mano |
| "Error registrando tbl_control_procesos" | BD inaccesible o sin permiso | Los archivos ya se subieron; revisar BD |
Reproceso: python -m envio_puma --desde AAAA-MM-DD [--hasta AAAA-MM-DD] (--fecha es equivalente a --desde; el boton "Ejecutar ahora" del panel envia --desde/--hasta). Sube de nuevo los mismos nombres (Puma los recibe sobrescritos), por lo que conviene avisarles. El resumen PU de ese dia se reemplaza.
Probar sin enviar: --dry-run (deja los TXT en output/; no sube, no respalda, no registra nada).
Fuente: repositorio job-envio-puma, versión 26f42c3 (con cambios locales). Página generada con tools/publicar_docs.py.