Git Large File Storageについて
Git LFSは、リポジトリに実際のファイルではなく、ファイルへの参照を保存することで大きなファイルを扱います。 Git のアーキテクチャを回避するため、Git LFS では実際のファイル (どこか別の場所に格納されています) への参照として働くポインター ファイルが作成されます。 GitHubはこのポインタファイルをリポジトリ中で管理します。 リポジトリをクローンすると、GitHubはこのポインタファイルを大きなファイルを見つけるための地図として使います。
GitHub プランに応じて、Git LFS の異なる最大サイズ制限が適用されます。
製品 | ファイルの最大サイズ |
---|---|
GitHub Free | 2 GB |
GitHub Pro | 2 GB |
GitHub Team | 4 GB |
GitHub Enterprise Cloud | 5 GB |
ファイルあたりの制限である 5 GB を超えると、ファイルは Git LFS によって拒否され、エラー メッセージが表示されます。
Git LFSをGitHub Desktopと共に使うこともできます。 GitHub Desktop で Git LFS リポジトリをクローンする方法の詳細については、「GitHubからのGitHub Desktopへのリポジトリのクローン方法」を参照してください。
GitHub がリポジトリ用に作成する ZIP ファイルや tarball などのソース コード アーカイブに Git LFS オブジェクトが含まれるかどうかを選択できます。 詳しくは、「リポジトリのアーカイブで Git LFS オブジェクトを管理する」を参照してください。
ポインタファイルのフォーマット
Git LFSのポインタファイルは以下のようになっています。
version https://git-lfs.github.com/spec/v1
oid sha256:4cac19622fc3ada9c0fdeadb33f88f367b541f38b89102a3f1261ac81fd5bcb5
size 84977953
使われている Git LFS の version
の後にファイルの一意識別子 (oid
) が付いたものが追跡されます。 また、最終的なファイルの size
も格納されます。
Note
- Git LFS は GitHub Pages サイトでは使用できません。
- Git LFS はテンプレートリポジトリでは使用できません。