스냅샷 파일 구조 이해

각 백업 스냅샷은 백업 대상 경로(예: /data/backup/data)의 타임스탬프 디렉터리(예: YYYYMMDDTHHMMSS)에 저장됩니다. 스냅샷에는 주요 데이터 저장소의 전체 내보내기가 포함됩니다. Git 리포지토리, GitHub Pages, 기타 구성 요소는 하드 링크를 통해 저장되어 스토리지를 최적화하고 효율적인 특정 시점 복원을 가능하게 합니다.

current 바로 가기 링크는 항상 가장 최근에 성공한 스냅샷 디렉터리를 가리킵니다.

스냅샷 디렉터리의 콘텐츠(<SNAPSHOT_TIMESTAMP>/)

각 스냅샷 디렉터리에는 인스턴스의 구성, 데이터 저장소, 운영 메타데이터에 대한 파일 및 폴더가 포함되어 있습니다. 다음은 일반적인 구조입니다.

설정 및 구성

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)

데이터 저장소 내보내기

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 데이터

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 및 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)

비밀 및 자격 증명

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.

후크 및 전달 데이터

git-hooks/                # Custom Git hooks (uses hard links)
hookshot/                 # Webhook delivery data (uses hard links)

기타

enterprise.ghl            # License file (often restored separately)
live-upgrade/             # Data for live upgrades or migrations (uses hard links)
benchmarks/               # Performance logs for backup steps

루트 디렉터리 콘텐츠 백업(/data/backup/data/)

루트 백업 디렉터리에는 증분 백업 추적 및 정리에 사용되는 모든 스냅샷 폴더와 메타데이터가 포함됩니다.

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