Сведения о больших файлах на GitHub

О ограничениях размера на GitHub

GitHub пытается обеспечить достаточное хранилище для всех репозиториев Git, хотя существуют жесткие ограничения для файла и размеров репозиторияостальных %} размеров и рекомендаций для размеров репозитория. Чтобы обеспечить производительность и надежность для наших пользователей, мы активно отслеживаем сигналы о общей работоспособности репозитория. Работоспособность репозитория — это функция различных факторов взаимодействия, включая размер, частоту фиксации, содержимое и структуру.

Ограничения размера файла

GitHub ограничивает размер файлов, разрешенных в репозиториях. При попытке добавить файл размером более 50 MiB или увеличить существующий файл сверх этого размера GIT выдаст предупреждение. Изменения будут успешно отправлены в репозиторий, но, возможно, будет лучше удалить фиксацию, чтобы свести к минимуму влияние на производительность. Дополнительные сведения см. в статье об удалении файлов из журнала репозитория.

GitHub блокирует файлы размером больше 100 МиБ.

Для отслеживания файлов размером более этого предела необходимо использовать Хранилище больших файлов Git (Git LFS). Дополнительные сведения см. в разделе Сведения о хранилище больших файлов Git Large File Storage.

Если вам нужно распространять большие файлы в репозитории, можно создавать выпуски на GitHub.com вместо отслеживания файлов. Дополнительные сведения см. в разделе "Распространение больших двоичных файлов".

В GIT не предусмотрена обработка больших файлов SQL. Чтобы совместно использовать большие базы данных с другими разработчиками, рекомендуется использовать службу общего доступа к файлам.

Ограничения на размер репозиториев

Рекомендуется, чтобы репозитории оставались небольшими, в идеале менее 1 ГБ, и крайне нежелательно, чтобы их размер превышал 5 ГБ. Небольшие репозитории быстрее клонируются и проще в работе и поддержке. Если ваш репозиторий чрезмерно влияет на нашу инфраструктуру, вы можете получить сообщение электронной почты от Служба поддержки GitHub с просьбой принять корректирующие меры. Мы стараемся находить гибкий подход, особенно в случае с крупными проектами со множеством участников совместной работы. По возможности мы попробуем вместе с вами найти решение. Вы можете предотвратить воздействие репозитория на нашу инфраструктуру, эффективно управляя его размером и общей работоспособностью. Советы и средство для анализа репозиториев можно найти в репозитории github/git-sizer.

Из-за внешних зависимостей репозитории GIT могут стать очень большими. Чтобы избежать заполнения репозитория внешними зависимостями, рекомендуется использовать диспетчер пакетов. К популярным диспетчерам пакетов для распространенных языков относятся Bundler, диспетчер пакетов Node и Maven. Эти диспетчеры пакетов поддерживают работу с репозиториями GIT напрямую, поэтому предварительно упакованные источники не нужны.

GIT не предназначен для использования в качестве средства резервного копирования. Однако существует множество решений, специально предназначенных для создания резервных копий, такие как Arq, Carbonite и CrashPlan.

Удаление файлов из журнала репозитория

Удаление файла, добавленного в рамках последней неотправленной фиксации

Если файл был добавлен с последней фиксацией, и вы не выполнили отправку в GitHub.com, вы можете удалить файл и изменить фиксацию:

1. Откройте ТерминалТерминалGIT Bash.

2. Измените текущий рабочий репозиторий на локальный проект.

3. Чтобы удалить файл, введите команду git rm --cached:

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

4. Зафиксируйте это изменение с помощью параметров --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
   

5. Отправка фиксаций в GitHub.com:

   $ git push
   # Push our rewritten, smaller commit
   

Удаление файла, добавленного в рамках более ранней фиксации

Если вы добавили файл в рамках предыдущей фиксации, его необходимо удалить из журнала репозитория. Чтобы удалить файлы из журнала репозитория, рекомендуется git filter-repo выполнить команду. Дополнительные сведения см. в разделе Удаление конфиденциальных данных из репозитория.

Кроме того, если вы не хотите установить дополнительное средство, можно использовать интерактивную перебазу для удаления проблемных фиксаций. Для этого:

• Необходимо знать, какие фиксации добавлены или изменены в этом файле.
• Фиксации должны быть частью только одной ветви.
• Одна ветвь, к которой принадлежат фиксации, не должна иметь слияний, так как были применены фиксации.

Дополнительные сведения об интерактивных перебазах см. в разделе Перемещений изменений из одной ветви в другую в GIT в командной строке. Если вы не уверены в соответствии с необходимыми условиями для исправления с помощью интерактивной повторной базы, следует использовать git filter-repo.

Распространение больших двоичных файлов

Если необходимо распространить большие файлы в репозитории, можно создать выпуски на GitHub.com. Выпуски позволяют упаковывать программное обеспечение, заметки о выпуске и ссылки на двоичные файлы для использования другими людьми. Дополнительные сведения см . в AUTOTITLE.

Мы не ограничиваем общий размер двоичных файлов в выпуске или пропускную способность для их доставки. Однако каждый отдельный файл должен быть меньше 2 ГиБ.