Configuring Git Large File Storage for your enterprise

关于 Git Large File Storage

Git Large File Storage (Git LFS) 是 Git 的开源扩展，使您能够像处理其他文本文件一样处理大文件。 您可以将 Git Large File Storage 与单一仓库、所有个人或组织仓库、您的 GitHub Enterprise Server 实例 中的每一个仓库结合使用。 您需要先为设备启用 Git LFS，然后才能为特定仓库或组织启用 Git LFS。

默认情况下， Git Large File Storage 客户端在托管 Git 仓库的同一服务器上存储大型资产。 当 Git LFS 在 GitHub Enterprise Server 设备上启用时，大型资产将存储在 /data/user/storage 中的数据分区中。 如果在设备或仓库上禁用了 Git LFS，则用户无法将 Git LFS 资产推送到 GitHub Enterprise Server 。

更多信息请参阅“关于 Git Large File Storage”、“大文件版本管理”以及 Git Large File Storage 项目站点。

为设备配置 Git Large File Storage

1. 在任何页面的右上角，单击 。
   
2. 在左侧边栏中，单击 Enterprise（企业）。
   
3. 在企业帐户侧边栏中，单击 Settings（设置）。
   
4. 在“ Settings（设置）”下，单击 Options（选项）。
   
5. 在“Git LFS 访问权限”下，使用下拉菜单，然后单击 Enabled（已启用）或 Disabled（已禁用）。
   

为各个仓库配置 Git Large File Storage

1. 在任何页面的右上角，单击 。
   
2. 在搜索字段中，输入仓库的名称，然后单击 Search（搜索）。
   
3. 在搜索结果中，单击仓库名称。
   
4. 在页面的右上角，单击 Admin（管理员）。
   
5. 在左侧边栏中，单击 Admin（管理员）。
   
6. 在“Git LFS”下，单击 Enable（启用）或 Disable（禁用）。
   

为用户帐户或组织拥有的每个仓库配置 Git Large File Storage

1. 在任何页面的右上角，单击 。
   
2. 在搜索字段中，输入用户或组织的名称，然后单击 Search（搜索）。
   
3. 在搜索结果中，单击用户或组织的名称。
   
4. 在页面的右上角，单击 Admin（管理员）。
   
5. 在左侧边栏中，单击 Admin（管理员）。
   
6. 在“Git LFS”下，单击 Enable（启用）或 Disable（禁用）。
   

将 Git Large File Storage 配置为使用第三方服务器

默认情况下， Git Large File Storage 客户端在托管 Git 仓库的同一服务器上存储大型资产。 当 Git LFS 在 GitHub Enterprise Server 设备上启用时，大型资产将存储在 /data/user/storage 中的数据分区中。 如果在设备或仓库上禁用了 Git LFS，则用户无法将 Git LFS 资产推送到 GitHub Enterprise Server 。

1. 在 GitHub Enterprise Server 设备上禁用 Git LFS。 更多信息请参阅“配置 Git Large File Storage”。

2. 创建指向第三方服务器的 Git LFS 配置文件。

   # Show default configuration
   $ git lfs env
   > git-lfs/1.1.0 (GitHub; darwin amd64; go 1.5.1; git 94d356c)
   > git version 2.7.4 (Apple Git-66)
    
   > Endpoint=https://GITHUB-ENTERPRISE-HOST/path/to/repo/info/lfs (auth=basic)
    
   # Create .lfsconfig that points to third party server.
   $ git config -f .lfsconfig remote.origin.lfsurl https://THIRD-PARTY-LFS-SERVER/path/to/repo
   $ git lfs env
   > git-lfs/1.1.0 (GitHub; darwin amd64; go 1.5.1; git 94d356c)
   > git version 2.7.4 (Apple Git-66)
    
   > Endpoint=https://THIRD-PARTY-LFS-SERVER/path/to/repo/info/lfs (auth=none)
    
   # Show the contents of .lfsconfig
   $ cat .lfsconfig
   [remote "origin"]
   lfsurl = https://THIRD-PARTY-LFS-SERVER/path/to/repo

3. 为使各用户的 Git LFS 配置相同，请向仓库提交自定义 .lfsconfig 文件。

   $ git add .lfsconfig
   $ git commit -m "Adding LFS config file"

4. 迁移任何现有的 Git LFS 资源。 For more information, see "Migrating to a different Git Large File Storage server."

迁移到其他 Git Large File Storage 服务器

迁移到其他 Git Large File Storage 服务器之前，您必须将 Git LFS 配置为使用第三方服务器。 For more information, see "Configuring Git Large File Storage to use a third party server."

1. 使用第二个远端配置仓库。

   $ git remote add NEW-REMOTE https://NEW-REMOTE-HOSTNAME/path/to/repo
    
   $ git lfs env
   > git-lfs/1.1.0 (GitHub; darwin amd64; go 1.5.1; git 94d356c)
   > git version 2.7.4 (Apple Git-66)
    
   > Endpoint=https://GITHUB-ENTERPRISE-HOST/path/to/repo/info/lfs (auth=basic)
   > Endpoint (NEW-REMOTE)=https://NEW-REMOTE-HOSTNAME/path/to/repo/info/lfs (auth=none)

2. 从旧远端提取所有对象。

   $ git lfs fetch origin --all
   > Scanning for all objects ever referenced...
   > ✔ 16 objects found
   > Fetching objects...
   > Git LFS: (16 of 16 files) 48.71 MB / 48.85 MB

3. 将所有对象推送到新远端。

   $ git lfs push NEW-REMOTE --all
   > Scanning for all objects ever referenced...
   > ✔ 16 objects found
   > Pushing objects...
   > Git LFS: (16 of 16 files) 48.00 MB / 48.85 MB, 879.10 KB skipped

延伸阅读

• Git Large File Storage 项目站点