Cómo configurar Borg Prune y Compact sin largas interrupciones entre copias de seguridad

Eva Wong es la redactora técnica y manitas residente en ZimaSpace. Es una geek de toda la vida apasionada por los laboratorios domésticos y el software de código abierto, y se especializa en traducir conceptos técnicos complejos en guías prácticas y fáciles de seguir. Eva cree que alojar servicios propios debería ser divertido, no intimidante. A través de sus tutoriales, ayuda a la comunidad a desmitificar la configuración del hardware, desde montar su primer NAS hasta dominar los contenedores Docker.

Para evitar largos intervalos sin copias de seguridad con Borg, ejecuta la depuración de retención después de una copia de seguridad completada correctamente, pero programa la compactación del repositorio con menos frecuencia y fuera de la ventana principal de copias de seguridad. Borg 1.4 separa la eliminación de archivos de la recuperación física de espacio, por lo que no es necesario ejecutar borg compact después de cada borg prune.

Esta guía está dirigida al modelo actual de comandos estables de Borg 1.4.x. Borg 2 cambia la semántica de los repositorios y archivos en varios aspectos, así que comprueba la versión instalada antes de copiar automatizaciones de otra versión principal.

Confirma la versión de Borg y el repositorio

borg --version
borg info /mnt/backup/borg-repo
borg list /mnt/backup/borg-repo

Las preguntas frecuentes de Borg señalan que Borg utiliza un bloqueo para todo el repositorio y que solo un proceso puede tener acceso de escritura a la vez. Si una compactación prolongada coincide con la siguiente copia de seguridad programada, esta espera a que se libere el bloqueo o falla cuando vence el tiempo de espera del bloqueo.

Define la retención con una ejecución de prueba primero

borg prune puede destruir el historial de archivos. La documentación de prune de Borg recomienda encarecidamente hacer pruebas con --dry-run y --list.

borg prune   --dry-run   --list   --keep-daily 7   --keep-weekly 4   --keep-monthly 6   --glob-archives '{hostname}-*'   /mnt/backup/borg-repo

Si un repositorio contiene copias de seguridad de varios equipos o conjuntos de datos, el filtro de archivos es esencial. Sin un filtro restrictivo, Borg 1.4 considera todos los archivos del repositorio como candidatos para las mismas reglas de retención.

Ejecuta la depuración solo después de una copia de seguridad completada correctamente

#!/bin/sh
set -eu
REPO=/mnt/backup/borg-repo
ARCHIVE='{hostname}-{now:%Y-%m-%d_%H-%M}'

borg create --stats "$REPO::$ARCHIVE" /srv/data

borg prune   --list   --keep-daily 7   --keep-weekly 4   --keep-monthly 6   --glob-archives '{hostname}-*'   "$REPO"

No depures porque se haya activado una tarea programada; depura porque se completó correctamente una nueva copia de seguridad y la política de retención ya se validó.

Entiende por qué la depuración no libera espacio de inmediato

Desde Borg 1.2, la compactación está separada de los comandos normales de escritura en el repositorio. Las notas sobre la compactación por separado de Borg explican que eliminar o depurar archivos no recupera de inmediato todo el espacio en disco del repositorio.

borg create
    |
nuevo archivo confirmado
    |
borg prune
    |
archivos antiguos eliminados del conjunto de retención
    |
borg compact
    |
espacio de segmentos sin usar recuperado

Esto resulta útil para la programación, porque las copias de seguridad diarias no tienen que asumir el costo completo de reescribir los segmentos del repositorio usados parcialmente.

Programa la compactación con menos frecuencia que la depuración

  • copia de seguridad: todas las noches;
  • depuración: después de cada copia de seguridad completada correctamente o unas cuantas veces por semana;
  • compactación: una vez por semana durante un período de poca actividad;
  • comprobación completa del repositorio: con una programación independiente y menos frecuente.
# Copia de seguridad diaria + depuración
0 1 * * * /usr/local/sbin/borg-backup

# Compactación semanal
0 4 * * 0 /usr/local/sbin/borg-compact

Si las copias de seguridad suelen tardar varias horas, programa la compactación más lejos o usa un temporizador con dependencias explícitas.

Usa el umbral predeterminado de compact antes de forzar reescrituras máximas

La documentación actual de compact establece un umbral predeterminado del 10 %.

borg compact --progress /mnt/backup/borg-repo

Ese valor predeterminado es un buen punto de partida si tu prioridad es una ventana de mantenimiento breve. Evita usar --threshold 0 automáticamente; reescribe siempre que se pueda ahorrar espacio y puede ser considerablemente más lento en un repositorio grande.

Evita que el mantenimiento coincida con la siguiente copia de seguridad

Si es posible que una tarea tenga que esperar legítimamente a otro proceso de Borg, establece un tiempo de espera limitado para el bloqueo:

borg --lock-wait 1800 create   /mnt/backup/borg-repo::'{hostname}-{now}'   /srv/data

No uses una espera de bloqueo muy larga como sustituto de una buena programación. Supervisa cuándo empieza y termina realmente la copia de seguridad.

Si varios clientes comparten un repositorio, intercala sus horarios. La sección de preguntas frecuentes de Borg señala que varios repositorios pueden reducir la contención del bloqueo cuando la deduplicación entre clientes no es importante.

Usa Quick Stats cuando la generación de informes ralentice prune

Borg 1.4.5 añadió --quick-stats a create, delete y prune para evitar estadísticas de todo el repositorio, más lentas, cuando no son necesarias.

borg prune   --quick-stats   --keep-daily 7   --keep-weekly 4   --keep-monthly 6   --glob-archives '{hostname}-*'   /mnt/backup/borg-repo

Mantén espacio libre disponible antes de necesitar compact

No esperes a que el sistema de archivos del repositorio se quede sin espacio libre. Borg no puede realizar de forma fiable las operaciones habituales de escritura en el repositorio cuando el sistema de archivos está completamente lleno.

df -h /mnt/backup
borg info /mnt/backup/borg-repo

Para un plan más amplio de copias de seguridad para NAS, la guía de copias de seguridad 3-2-1 de ZimaOS recuerda que la retención del repositorio es solo una capa del diseño de las copias de seguridad.

Valida la programación antes de confiar en ella

  • ¿Cada copia de seguridad creó un archivo nuevo?
  • ¿Se ejecutó prune solo después de copias de seguridad satisfactorias?
  • ¿Coincidió el conjunto de retención con el plan de ejecución de prueba?
  • ¿Terminó la compactación semanal antes de la siguiente copia de seguridad?
  • ¿Aumentó el espacio libre después de compact?
  • ¿Alguna tarea pasó un tiempo inesperado esperando el bloqueo de Borg?

Si compact se solapa repetidamente con la siguiente copia de seguridad, reduce la frecuencia de compactación, conserva el umbral predeterminado, programa compact para un horario más tranquilo o separa las cargas de trabajo no relacionadas en repositorios distintos.

Un patrón de mantenimiento de Borg con pocas interrupciones

DIARIO
01:00  borg create
        |
        +-- éxito --> borg prune
        |
        +-- fallo --> conservar los archivos antiguos, alertar

SEMANAL
04:00  borg compact

PERIÓDICO
        borg check
        archivos seleccionados de prueba de restauración

La regla principal es sencilla: prune protege la política de retención; compact recupera espacio de almacenamiento; no es necesario ejecutarlos con la misma frecuencia.

Soporte y consejos

Más para leer

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.