Skip to main content

Git Large File Storageについて

GitHub には、リポジトリで許可されるファイルのサイズに制限があります。 この制限を超えるファイルを追跡するには、Git Large File Storage を使います。

Git Large File Storageについて

Git LFSは、リポジトリに実際のファイルではなく、ファイルへの参照を保存することで大きなファイルを扱います。 Git のアーキテクチャを回避するため、Git LFS では実際のファイル (どこか別の場所に格納されています) への参照として働くポインター ファイルが作成されます。 GitHubはこのポインタファイルをリポジトリ中で管理します。 リポジトリをクローンすると、GitHubはこのポインタファイルを大きなファイルを見つけるための地図として使います。

GitHub プランに応じて、Git LFS の異なる最大サイズ制限が適用されます。

製品ファイルの最大サイズ
GitHub Free2 GB
GitHub Pro2 GB
GitHub Team4 GB
GitHub Enterprise Cloud5 GB

ファイルあたりの制限である 5 GB を超えると、ファイルは Git LFS によって拒否され、エラー メッセージが表示されます。

Git LFSをGitHub Desktopと共に使うこともできます。 GitHub Desktop で Git FLS リポジトリをクローンする方法の詳細については、「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 はテンプレートリポジトリでは使用できません。

参考資料