Informationen zu großen Dateien auf GitHub

Informationen zu Größenbeschränkungen für GitHub Enterprise Server

GitHub Enterprise Server versucht, reichlich Speicher für alle Git-Repositorys bereitzustellen, obwohl feste Grenzwerte für Dateigrößen und Empfehlungen für Repositorygrößen bestehen.

Dateigrößenbeschränkungen

GitHub Enterprise Server schränkt die Größe der in Repositorys erlaubten Dateien ein. Wenn du versuchst, eine Datei größer als 50 MB hinzuzufügen oder zu aktualisieren, wirst du von Git eine Warnung erhalten. Die Änderungen werden immer noch erfolgreich in dein Repository übertragen, aber kannst erwägen, den Commit zu entfernen, um die Performance-Auswirkungen zu minimieren. Weitere Informationen findest du unter Entfernen von Dateien aus einem Repositoryverlauf.

Standardmäßig blockiert GitHub Enterprise Server Dateien, die größer als 100 MB sind. Websiteadministratorn können jedoch einen anderen Grenzwert für deine GitHub Enterprise Server-Instanz konfigurieren. Weitere Informationen findest du unter Erzwingen von Repositoryverwaltungsrichtlinien in einem Unternehmen.

Um Dateien über diesen Grenzwert hinaus nachzuverfolgen, musst du Git Large File Storage (Git LFS) verwenden. Weitere Informationen findest du unter Informationen zu Git Large File Storage.

Wenn du große Dateien innerhalb deines Repositorys verteilen musst, kannst du Releases auf deine GitHub Enterprise Server-Instanz erstellen, anstatt die Dateien nachzuverfolgen. Weitere Informationen findest du unter Verteilen großer Binärdateien.

Git ist nicht für die Verarbeitung großer SQL-Dateien konzipiert. Zum Freigeben großer Datenbanken für andere Entwickler*innen wird die Verwendung von Dropbox empfohlen.

Empfehlungen für die Repositorygröße

Wir empfehlen, dass Repositories klein bleiben, idealerweise weniger als 1 GB, und weniger als 5 GB wird dringend empfohlen. Kleinere Repositorys sind schneller zu klonen und einfacher zu bearbeiten und zu pflegen.

Du kannst verhindern, dass dein Repository unsere Infrastruktur beeinträchtigt, indem du die Größe und Integrität deines Repository effektiv verwaltest. Ratschläge und ein Tool zur Repositoryanalyse findest du im Repository github/git-sizer.

Dateien aus dem Verlauf eines Repositorys entfernen

Datei entfernen, die beim letzten noch nicht übertragenen Commit hinzugefügt wurde

Wenn eine Datei bei deinem letzten Commit hinzugefügt wurde und dieses noch nicht per Push auf deine GitHub Enterprise Server-Instanz übertragen wurde, kannst du die Datei löschen und den Commit ändern:

1. Öffne TerminalTerminalGit Bash. 1. Ändere das aktuelle Arbeitsverzeichnis in Dein lokales Repository.
2. Um die Datei zu entfernen, gib git rm --cached ein:

   $ git rm --cached GIANT_FILE
   # Stage our giant file for removal, but leave it on disk

3. Committe diese Änderung mithilfe von --amend -CHEAD:

   $ git commit --amend -CHEAD
   # Amend the previous commit with your change
   # Simply making a new commit won't work, as you need
   # to remove the file from the unpushed history as well

4. Pushe deine Commits auf deine GitHub Enterprise Server-Instanz:

   $ git push
   # Push our rewritten, smaller commit

Entfernen einer Datei, die in einem früheren Commit hinzugefügt wurde

Wenn du eine Datei in einem früheren Commit hinzugefügt hast, musst du sie aus deinem Repository-Verlauf entfernen. Um Dateien aus dem Repositoryverlauf zu entfernen, kannst du den BFG Repo-Cleaner oder den git filter-repo-Befehl verwenden. Weitere Informationen findest du unter Entfernen vertraulicher Daten aus einem Repository.

Große Binärdateien verteilen

Wenn du große Dateien innerhalb deines Repositorys verteilen musst, kannst du Releases auf deine GitHub Enterprise Server-Instanz erstellen. Releases erlauben Dir, Software, Release-Hinweise und Links zu Binärdateien zu paketieren, damit andere Personen diese nutzen können. Weitere Informationen findest du unter Informationen zu Releases.