Skip to main content

Grundlegendes zur Struktur der Momentaufnahmedatei

Verstehen sie die Struktur und den Inhalt von Sicherungsmomentaufnahmenverzeichnissen, darunter gespeicherte Inhalte und wie feste Links verwendet werden.

Jede Sicherungsmomentaufnahme wird in einem Zeitstempelverzeichnis (z. B. YYYYMMDDTHHMMSS) unter dem Sicherungszielpfad (z. B. /data/backup/data) gespeichert. Momentaufnahmen umfassen vollständige Exporte wichtiger Datenspeicher. Git-Repositorys, GitHub Pages und andere Komponenten werden mithilfe harter Links gespeichert, um Speicher zu optimieren und effiziente Point-in-Time-Wiederherstellungen zu ermöglichen.

Hinweis

Wenn du Sicherungsmomentaufnahmen archivierst, musst du symbolische Links beibehalten. Die Dereferenzierung oder das Ausschließen symbolischer Links – oder das Speichern von Momentaufnahmen in einem Dateisystem, das sie nicht unterstützt – kann zu Wiederherstellungsfehlern führen.

Der current-Symlink verweist immer auf das neueste erfolgreiche Momentaufnahmeverzeichnis.

Inhalte eines Momentaufnahmeverzeichnisses (/)

Jedes Momentaufnahmeverzeichnis enthält Dateien und Ordner für die Konfiguration, Datenspeicher und Betriebsmetadaten deiner Instanz. Unten ist eine typische Struktur dargestellt.

Einstellungen und Konfiguration

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)

Datenspeicherexporte

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-Daten

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-Features:

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)

Geheimnisse und Anmeldeinformationen

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 und Übermittlungsdaten

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

Verschiedenes

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

Sicherungsstammverzeichnisinhalte (/data/backup/data/)

Das Stammsicherungsverzeichnis enthält alle Momentaufnahmeordner und Metadaten, die für die inkrementelle Sicherungsnachverfolgung und -bereinigung verwendet werden:

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