egutierrez
7913116a8e
- .claude/agents/fn-analizador/SKILL.md - .claude/agents/fn-constructor/SKILL.md - .claude/agents/fn-executor/SKILL.md - .claude/agents/fn-mejorador/SKILL.md - .claude/agents/fn-orquestador/SKILL.md - .claude/agents/fn-recopilador/SKILL.md - .claude/commands/app.md - .claude/commands/compile.md - .claude/commands/cpp-app.md - .claude/commands/create_functions.md - ... Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
74 lines
2.6 KiB
Markdown
74 lines
2.6 KiB
Markdown
---
|
|
name: backup_all
|
|
kind: pipeline
|
|
lang: bash
|
|
domain: pipelines
|
|
version: "1.0.0"
|
|
purity: impure
|
|
signature: "backup_all(backup_root: string) -> void"
|
|
description: "Backup completo del estado del registry: snapshot atomico de registry.db, snapshot de cada operations.db de cada app, y rsync de todos los vaults declarados en vault.yaml. Aplica retention 7/4/12 (daily/weekly/monthly) con rotate_backups. Idempotente, llamable a diario desde cron o systemd-timer."
|
|
tags: ["backup", "launcher", "pipeline", "retention"]
|
|
uses_functions:
|
|
- backup_sqlite_db_bash_infra
|
|
- rotate_backups_bash_infra
|
|
uses_types: []
|
|
returns: []
|
|
returns_optional: false
|
|
error_type: "error_go_core"
|
|
imports: []
|
|
params:
|
|
- name: backup_root
|
|
desc: "Directorio raiz donde se guardan todos los backups (ej. ~/backups/fn_registry). Se crea si no existe."
|
|
output: "Linea de resumen a stdout: ISO_timestamp, bytes de registry.db, conteo de ops backupeadas, conteo de vaults sincronizados, errores parciales y segundos transcurridos. Misma linea se hace append en backup_root/backup_log.txt."
|
|
tested: false
|
|
tests: []
|
|
test_file_path: ""
|
|
file_path: "bash/functions/pipelines/backup_all.sh"
|
|
---
|
|
|
|
## Ejemplo
|
|
|
|
```bash
|
|
# Backup manual a ~/backups/fn_registry
|
|
export FN_REGISTRY_ROOT=$HOME/fn_registry
|
|
backup_all ~/backups/fn_registry
|
|
|
|
# Salida esperada:
|
|
# 2026-05-07T10:30:00+02:00 registry=4194304B ops=3 vaults=2 partial_errors=0 elapsed=12s
|
|
|
|
# Entrada en crontab (diario a las 02:00)
|
|
# 0 2 * * * FN_REGISTRY_ROOT=$HOME/fn_registry bash $HOME/fn_registry/bash/functions/pipelines/backup_all.sh ~/backups/fn_registry
|
|
```
|
|
|
|
## Estructura de backup_root/
|
|
|
|
```
|
|
registry/
|
|
daily.0 daily.1 ... daily.6
|
|
weekly.0 ... weekly.3
|
|
monthly.0 ... monthly.11
|
|
operations/
|
|
<app_name>/
|
|
daily.0 ... (misma retencion)
|
|
vaults/
|
|
<vault_name>/
|
|
daily.0/ (directorio rsync con hard-links)
|
|
daily.1/ ...
|
|
backup_log.txt
|
|
```
|
|
|
|
## Codigos de salida
|
|
|
|
| Codigo | Significado |
|
|
|--------|-------------|
|
|
| 0 | Exito completo |
|
|
| 1 | FN_REGISTRY_ROOT no localizable |
|
|
| 2 | backup_root no se puede crear/escribir |
|
|
| 3 | Fallo critico en backup de registry.db |
|
|
| 4 | Errores parciales en ops o vaults (no critico, continua) |
|
|
| 5 | Herramientas del sistema faltantes (sqlite3, rsync, find) |
|
|
|
|
## Notas
|
|
|
|
Idempotente: llamar multiples veces el mismo dia solo rota si hay cambios de fecha. Los vaults deducan bloques iguales con rsync --link-dest, por lo que el primer run ocupa el espacio real y los sucesivos solo almacenan los deltas. Operations.db de apps sin dicho archivo se ignoran silenciosamente. Requiere FN_REGISTRY_ROOT seteado o ejecutar desde la raiz del registry.
|