VFS for Git

Notice: С выходом VFS for Git 2.32, VFS for Git находится в режиме поддержки. Только необходимые обновления в ответ на критические уязвимости безопасности приведут к выпуску новой версии.

Branch	Unit Tests	Functional Tests	Large Repo Perf	Large Repo Build
master
shipped

Что такое VFS для Git?

VFS означает виртуальную файловую систему. VFS for Git виртуализирует файловую систему под вашим репозиторием Git, так что Git и все инструменты видят то, что кажется обычным рабочим каталогом, но VFS for Git загружает объекты только по мере необходимости. VFS for Git также управляет файлами, которые будет рассматривать Git, чтобы гарантировать, что операции Git, такие как status, checkout и т. д., могут быть максимально быстрыми, поскольку они будут учитывать только файлы, к которым пользователь обращался, а не все файлы в репозитории.

Примечание: для новых развёртываний мы настоятельно рекомендуем вам рассмотреть Scalar вместо VFS for Git. Объединив уроки эксплуатации VFS for Git в масштабе с новыми разработками в Git, Scalar предлагает более ясный путь вперёд для всех больших монорепозиториев.

Установка VFS for Git

Для работы VFS for Git требуется Windows 10 Anniversary Update (Windows 10 версии 1607) или более поздняя версия.

Чтобы установить, используйте winget для установки форка Microsoft/git Git (https://github.com/microsoft/git) и VFS for Git с помощью:

winget install --id Microsoft.Git
winget install --id Microsoft.VFSforGit

Вам нужно будет продолжать использовать версию Git от Microsoft/git, и она сообщит вам, когда станут доступны новые версии.

Сборка VFS for Git

Если вы хотите собрать собственный установщик Windows для VFS for Git:

• Установите Visual Studio 2017 Community Edition или выше (https://www.visualstudio.com/downloads/).

  • Включите следующие рабочие нагрузки:
    • .NET desktop development
    • Desktop development with C++
    • .NET Core cross-platform development
  • Включите следующие дополнительные компоненты:
    • .NET Core runtime
    • Windows 10 SDK (10.0.10240.0)

• Установите .NET Core 2.1 SDK (https://www.microsoft.com/net/download/dotnet-core/2.1)

• Установите nuget.exe (https://www.nuget.org/downloads)

• Создайте папку для клонирования, например Клонирование репозитория в подпапку src

• Клонируйте этот репозиторий в подпапку src, например, C:\Repos\VFSForGit\src.

• Запустите \src\Scripts\BuildGVFSForWindows.bat.

Вы также можете выполнить сборку в Visual Studio, открыв src\GVFS.sln (не обновляйте проекты) и выполнив сборку. Однако первая сборка завершится неудачно, а вторая и последующие сборки будут успешными. Это связано с тем, что для сборки требуется этап предварительной генерации кода. Подробнее см. сценарий сборки на предыдущем шаге.

Использование Visual Studio 2019

Есть несколько вариантов получения всех зависимостей:

1. Вы можете установить Visual Studio 2017 рядом с Visual Studio 2019 и убедиться, что у вас установлены все зависимости из Visual Studio 2017.

2. Если вы хотите установить только Visual Studio 2019, установите следующие дополнительные зависимости:

• MSVC v141 VS 2017 C++ build tools через дополнительные компоненты в установщике Visual Studio 2019. Он находится в разделе «Разработка классических приложений на C++».
• Windows 10 SDK (10.0.10240.0) через страницу заархивированных SDK: https://developer.microsoft.com/en-us/windows/downloads/sdk-archive.

Visual Studio 2019 автоматически предложит вам установить эти зависимости при открытии решения. Файл .vsconfig, который находится в корне репозитория, указывает все необходимые компоненты, кроме Windows 10 SDK (10.0.10240.0), поскольку этот компонент больше не поставляется с VS2019 — вам всё равно нужно будет установить его отдельно.

Установщик теперь можно найти по адресу C:\Repos\VFSForGit\BuildOutput\GVFS.Installer.Windows\bin\x64\[Debug|Release]\SetupGVFS.<version>.exe.

Тестирование VFS for Git

• VFS for Git требует службы Git, которая поддерживает протокол GVFS. Например, вы можете создать репозиторий в Azure DevOps и отправить в него некоторые данные. Есть два ограничения:

  • Ваш репозиторий не должен включать какие-либо фильтры очистки/загрязнения.
  • В вашем репозитории должен быть файл .gitattributes в корне, который включает строку * -text.

• gvfs clone <URL репозитория, который вы только что создали>.

  • Пожалуйста, выберите опцию «Клонировать с HTTPS» в диалоговом окне «Клонировать репозиторий» в Azure Repos, а не «Клонировать с SSH».

• Перейдите в каталог <root>\src и запустите команды Git как обычно.

• Когда закончите, выполните команду gvfs unmount.

Примечание о наименовании

Этот проект ранее назывался GVFS (Git Virtual File System). Вы можете иногда видеть материалы, включая имена кодов и протоколов, которые относятся к предыдущему названию.

Лицензии

Исходный код VFS for Git в этом репозитории доступен под лицензией MIT. См. License.md.

VFS for Git использует драйвер фильтра PrjFlt, ранее известный как драйвер фильтра GvFlt, доступный в виде предварительного выпуска пакета NuGet.