Cada instantâneo de backup é armazenado em um diretório com carimbo de data/hora (por exemplo, YYYYMMDDTHHMMSS) no caminho de destino de backup (por exemplo, /data/backup/data). Os instantâneos incluem exportações completas dos principais repositórios de dados. Repositórios Git, GitHub Pages e outros componentes são armazenados usando links rígidos para otimizar o armazenamento e habilitar restaurações pontuais eficientes.
Observação
Se você arquivar instantâneos de backup, deverá preservar links simbólicos. Desfazer a referência ou excluir links simbólicos — ou armazenar instantâneos em um sistema de arquivos que não dá suporte a eles—pode causar falhas de restauração.
O symlink current sempre aponta para o diretório de instantâneo bem-sucedido mais recente.
Conteúdo de um diretório de instantâneo (/
Cada diretório de instantâneo contém arquivos e pastas para a configuração, os armazenamentos de dados e os metadados operacionais da instância. Abaixo está uma estrutura típica.
Definições e configuração
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)
Exportações de armazenamento de dados
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)
Dados do GitHub
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 e 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)
Segredos e credenciais
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 e dados de entrega
git-hooks/ # Custom Git hooks (uses hard links)
hookshot/ # Webhook delivery data (uses hard links)
Diversos
enterprise.ghl # License file (often restored separately)
live-upgrade/ # Data for live upgrades or migrations (uses hard links)
benchmarks/ # Performance logs for backup steps
Conteúdo do diretório raiz de backup (/data/backup/data/)
O diretório de backup raiz inclui todas as pastas de instantâneo e os metadados usados para acompanhamento e remoção de backup incremental:
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