Aquesta és una revisió antiga del document
borg
repositorio
- creación repositorio:
borg init --encryption=[none|repokey] [--make-parent-dirs] [--storage-quota QUOTA ] /path/to/repo
- backup repokey:
borg key export [--paper] [--qr-html] <REPO> /path/to/repokey.export
- información del repositorio o archivo:
borg info /path/to/repo
archivo (de backup)
- creación archivo de copia:
borg create [--stats] /path/to/repo::<archivo> /path/files/tobe/backuped1 [path/files/tobe/backuped2]
- parámetros:
- --list: muestra información de los ficheros que va evaluando. Por defecto no muestra nada
- --filter=<CHARS>: filtra los archivos que se muestran en
–list:‘A’ = regular file, added ‘M’ = regular file, modified ‘U’ = regular file, unchanged ‘E’ = regular file, an error happened while accessing/reading this file A lowercase character means a file type other than a regular file, borg usually just stores their metadata: ‘d’ = directory ‘b’ = block device ‘c’ = char device ‘h’ = regular file, hardlink (to already seen inodes) ‘s’ = symlink ‘f’ = fifo Other flags used include: ‘i’ = backup data was read from standard input (stdin) ‘-‘ = dry run, item was not backed up ‘x’ = excluded, item was not backed up ‘?’ = missing status code (if you see this, please file a bug report!)
- --exclude-caches: ignora directorios con la firma CACHEDIR.TAG (https://bford.info/cachedir/)
- --exclude-from <EXCLUDE_FILE>: ignora los ficheros/directorios según el patrón
- --exclude-if-present <NAME>: nombre del fichero que hace ignorar la copia de directorios y subdirectorios incluidos
- --keep-exclude-tags invierte el uso del exclude a include (solo se haría copia de los que incluyen el fichero-tag)
listar
- listar archivos en repositorio:
borg list /path/to/repo
- listar contenido de un archivo:
borg list /path/to/repo::<archivo>
recuperación
- extraer un archivo:
borg extract /path/to/repo::<archivo>
montar
- montar el repo:
borg mount /path/to/repo /mount/point
- hay un parámetro experimental (y versión 1.1.14?) que mezcla todos los archivos del repo en una «vista»: -o versions
- –glob-archives '*-my-home': «include» archivos
- –last 10
- –exclude ''
- montar un archivo del repo:
borg mount::<archivo> /path/to/repo /mount/point
- desmontar:
borg umount /mount/point
- fuse.borgfs (uso en /etc/fstab)
exportar
borg export-tar /path/to/repo::<archivo> fichero.tar
borrado
- borrado de repositorio y archivos:
borg delete /path/to/repo::<archivo>
automatización
- especificar el repositorio:
export BORG_REPO=ssh://username@example.com:2022/~/backup/main
- especificar la contraseña:
export BORG_PASSPHRASE='XYZl0ngandsecurepa_55_phrasea&&123'
- si el comando borg se lanza con sudo, usar –preserve-env si se está exportando el repositorio o la contraseña
- se pueden usar placeholders
- {hostname}, {fqdn}, {reverse-fqdn}
- {now}, {now:%Y-%m-%d}, {utcnow}
- {user}, {pid}
- {borgversion}, {borgmajor}, {borgminor}, {borgpatch}
- variables de entorno: https://borgbackup.readthedocs.io/en/1.1.11/usage/general.html#environment-variables