Cada instantánea de copia de seguridad se almacena en un directorio con marca de tiempo (por ejemplo, YYYYMMDDTHHMMSS) en la ruta de acceso de destino de copia de seguridad (por ejemplo, /data/backup/data). Las instantáneas incluyen exportaciones completas de almacenes de datos clave. Los repositorios de Git, GitHub Pages y otros componentes se almacenan mediante vínculos físicos para optimizar el almacenamiento y habilitar restauraciones a un momento dado eficaces.
Nota:
Si archivas instantáneas de copia de seguridad, debes conservar los vínculos simbólicos. Desreferenciar o excluir vínculos simbólicos (o almacenar instantáneas en un sistema de archivos que no los admita) puede provocar errores de restauración.
El vínculo simbólico current siempre apunta al directorio de instantáneas más reciente.
Contenido de un directorio de instantáneas (<SNAPSHOT_TIMESTAMP>/)
Cada directorio de instantáneas contiene archivos y carpetas para la configuración de la instancia, los almacenes de datos y los metadatos operativos. A continuación se muestra una estructura típica.
Opciones y configuración
settings.json # Main appliance settings
manage-password # Management console password hash
uuid # Appliance UUID
version # GHES version at backup time
strategy # Backup strategy used (e.g., rsync, cluster)
cluster.conf # Cluster configuration (if applicable)
Exportaciones de almacén de datos
mysql.sql.gz # Logical database dump (default) OR
xtrabackup_checkpoints # Binary backup metadata (if binary backups used)
xtrabackup-export.log # Log snippet from binary backup
mysql-binary-backup-sentinel # Indicates binary backup type
# May include other files related to logical or binary MySQL backups
Redis
redis.rdb # Redis database dump
Elasticsearch
audit-log/ # Audit log indices (uses hard links)
elasticsearch/ # Search indices (if not skipped, uses hard links)
Datos de GitHub data
repositories/ # Git repositories (uses hard links)
pages/ # GitHub Pages content (uses hard links)
storage/ # Alambic-managed storage: avatars, attachments, etc. (uses hard links)
GitHub Actions y CI/CD
actions/ # GitHub Actions blob storage (uses hard links)
mssql/ # MS SQL Server backups (.bak, .diff, .log) (uses hard links)
minio/ # MinIO object storage (if Actions or Packages enabled, uses hard links)
Secretos y credenciales
authorized-keys.json # SSH keys authorized for administrative access
github-secrets.tar # Tarball of various exported instance secrets
saml-keys.tar # SAML IdP keys (if applicable)
ssh-host-keys.tar # SSH host keys
ssl-ca-certificates.tar # Custom CA certificates (if applicable)
# Includes other internal secrets and keys necessary for instance operation.
Enlaces y datos de entrega
git-hooks/ # Custom Git hooks (uses hard links)
hookshot/ # Webhook delivery data (uses hard links)
Varios
enterprise.ghl # License file (often restored separately)
live-upgrade/ # Data for live upgrades or migrations (uses hard links)
benchmarks/ # Performance logs for backup steps
Contenido del directorio raíz de copia de seguridad (/data/backup/data/)
El directorio de copia de seguridad raíz incluye todas las carpetas de instantáneas y los metadatos usados para el seguimiento incremental de copias de seguridad y la eliminación:
YYYYMMDDTHHMMSS/ # Snapshot directory (one per backup)
... # Other snapshot directories
current # Symlink to the most recent successful snapshot
inc_full_backup # Tracks base for MySQL incremental backups
inc_snapshot_data # Tracks incremental MySQL snapshots
prune_* # Temporary directories marked for deletion
inc_previous_* # Renamed snapshot directories during pruning cycle