Chaque instantané de sauvegarde est stocké dans un répertoire horodaté (par exemple, YYYYMMDDTHHMMSS) sous le chemin d’accès de la cible de sauvegarde (par exemple, /data/backup/data). Les instantanés comprennent des exports complets des principales bases de données. Les référentiels Git, GitHub Pages et autres composants sont stockés à l’aide de liens physiques afin d’optimiser le stockage et de permettre des restaurations ponctuelles efficaces.
Remarque
Si vous archivez des instantanés de sauvegarde, vous devez conserver les liens symboliques. Le déréférencement ou l’exclusion des liens symboliques, ou encore le stockage d’instantanés sur un système de fichiers qui ne les prend pas en charge, peuvent entraîner des échecs de restauration.
Le lien symbolique current renvoie toujours vers le répertoire du dernier instantané réussi.
Contenu d’un répertoire d’instantanés (<SNAPSHOT_TIMESTAMP>/)
Chaque répertoire de snapshots contient des fichiers et des dossiers relatifs à la configuration de votre instance, aux magasins de données et aux métadonnées opérationnelles. Vous trouverez ci-dessous une structure type.
Paramètres et configuration
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)
Exportations du magasin de données
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)
GitHub données
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 et 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)
Secrets et informations d’identification
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.
Hooks et données de livraison
git-hooks/ # Custom Git hooks (uses hard links)
hookshot/ # Webhook delivery data (uses hard links)
Divers
enterprise.ghl # License file (often restored separately)
live-upgrade/ # Data for live upgrades or migrations (uses hard links)
benchmarks/ # Performance logs for backup steps
Contenu du répertoire racine de sauvegarde (/data/backup/data/)
Le répertoire racine de sauvegarde comprend l’ensemble des dossiers de snapshots ainsi que les métadonnées utilisées pour le suivi et l’élagage des sauvegardes incrémentielles :
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