Skip to main content

Enterprise Server 3.20 ist derzeit als Release Candidate verfügbar.

Grundlegendes zur Struktur der Momentaufnahmedatei

Verstehen Sie die Struktur und den Inhalt von Verzeichnissen für Sicherungssnapshots, einschließlich dessen, was gespeichert wird und wie feste Links verwendet werden.

Jeder Backupsnapshot wird in einem Zeitstempelverzeichnis (z. B. YYYYMMDDTHHMMSS) unter dem Sicherungszielpfad (z. B. /data/backup/data) gespeichert. Momentaufnahmen umfassen vollständige Exporte zentraler 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 Sie Sicherungs-Snapshots archivieren, müssen Sie 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 Momentaufnahmenverzeichnis.

Inhalte eines Momentaufnahmeverzeichnisses (<SNAPSHOT_TIMESTAMP>/)

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

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 Snapshot-Ordner und Metadaten, die zur Verfolgung und Bereinigung inkrementeller Sicherungen 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