Git Large File Storage

Git LFS — это расширение командной строки и спецификация для управления большими файлами с помощью Git.

Клиент написан на Go, с предварительно скомпилированными бинарниками для Mac, Windows, Linux и FreeBSD. Подробнее о функциональности можно узнать на веб-сайте.

Начало работы

Установка

• Пользователи Linux. Debian и RPM пакеты доступны с PackageCloud.
• Пользователи macOS. Homebrew бутылки распространяются, и могут быть установлены через brew install git-lfs.
• Пользователи Windows. Git LFS включен в дистрибутив Git for Windows. В качестве альтернативы, можно установить последнюю версию Git LFS с помощью менеджера пакетов Chocolatey.
• Бинарные пакеты. Кроме того, бинарные пакеты доступны для Linux, macOS, Windows и FreeBSD.
• Сборка из исходного кода. Этот репозиторий также может быть собран из исходного кода с помощью последней версии Go, и имеющихся инструкций в нашей Wiki.

Установка

Из бинарников

Бинарные пакеты включают скрипт, который выполнит:- Установку бинарников Git LFS на системный $PATH

• Выполнение команды git lfs install для выполнения необходимых глобальных настроек.

$ ./install.sh

Из исходного кода

• Разместите бинарник git-lfs на вашем системном $PATH или эквиваленте.
• Git LFS требует глобальных настроек один раз на машину. Это можно сделать, запустив:

$ git lfs install

Проверка выпусков

Выпуски подписываются с помощью OpenPGP ключа одного из членов команды. Чтобы получить эти ключи, вы можете запустить следующую команду, которая выведет их на стандартный вывод:

$ curl -L https://api.github.com/repos/git-lfs/git-lfs/tarball/core-gpg-keys | tar -Ozxf -

После получения ключей вы можете скачать файл sha256sums.asc и проверить файл, который вы хотите, следуя инструкциям:

$ gpg -d sha256sums.asc | grep git-lfs-linux-amd64-v2.10.0.tar.gz | shasum -a 256 -c

Пример использования

Чтобы начать использование Git LFS в Git-репозитории, который еще не настроен для Git LFS, вы можете указать, какие файлы вы хотите, чтобы Git LFS управлял. Это можно сделать, выполнив следующую команду изнутри Git-репозитория:

$ git lfs track "*.psd"

(Где *.psd — это шаблон имен файлов, которые вы хотите отслеживать. Вы можете узнать больше о синтаксисе этого шаблона здесь).

Примечание: кавычки, окружающие шаблон, важны для предотвращения раскрытия шаблона глобальным поиском оболочки.После любого вызова git-lfs-track(1) или git-lfs-untrack(1) вы должны сделать коммит изменений в вашем файле .gitattributes. Это можно сделать, выполнив:

$ git add .gitattributes
$ git commit -m "track *.psd files using Git LFS"

Теперь вы можете взаимодействовать с вашим Git-репозиторием как обычно, и Git LFS будет управлять вашими большими файлами. Например, изменение файла my.psd (отслеживаемого выше через *.psd):

$ git add my.psd
$ git commit -m "add psd"

Совет: если у вас уже есть большие файлы в истории вашего репозитория, git lfs track не будет отслеживать их ретроспективно. Чтобы перенести существующие большие файлы в вашей истории на использование Git LFS, используйте git lfs migrate. Например:

$ git lfs migrate import --include="*.psd" --everything

Для получения дополнительной информации прочитайте git-lfs-migrate(1).

Вы можете подтвердить, что Git LFS управляет вашим файлом PSD:

$ git lfs ls-files
3c2f7aedfb * my.psd

После того как вы сделали свои коммиты, отправьте файлы на Git-удаленный репозиторий:

$ git push origin master
Загрузка LFS-объектов: 100% (1/1), 810 B, 1.2 KB/s
# ...
К https://github.com/git-lfs/git-lfs-test
   67fcf6a..47b2002  master -> master

Примечание: Git LFS требует версии Git 1.8.2 для Linux или 1.8.5 для macOS.

ОграниченияGit LFS поддерживает список текущих ограничений, который вы можете найти и редактировать здесь.## Нужна помощь?

Вы можете получить помощь по конкретным командам напрямую:

$ git lfs help <подкоманда>

Официальная документация docs содержит справочные материалы и спецификации для инструмента.

Вы всегда можете открыть issue, и один из членов команды будет отвечать на ваш запрос. Пожалуйста, убедитесь, что вы включили:

1. Вывод команды git lfs env, которая отображает полезную информацию о вашем репозитории Git, которая полезна для отладки.
2. Любые неудачные команды, перезапущенные с GIT_TRACE=1 в окружении, что отображает дополнительную информацию, относящуюся к тому, почему команда не сработала.

Вклад

См. CONTRIBUTING.md для информации о работе над Git LFS и отправке патчей. Связанные проекты перечислены на странице вики Implementations.

Основная команда

Это люди, которые составляют основную команду Git LFS, управляющую проектом.

В алфавитном порядке:

@bk2204	@chrisd8088	[@larsxschneider][larsxschneider-user]
		[][larsxschneider-user]

[larsxschneider-user]: https://github.com/larsxschneider### Бывшие участники

Это люди, которые в прошлом составляли основную команду Git LFS или внесли значительный вклад в проект. Без них Git LFS не был бы возможен.

В алфавитном порядке: