GitHub での大きいファイルについて

GitHub Enterprise Server でのサイズ制限について

GitHub Enterprise Server では、すべての Git リポジトリへの十分なストレージの提供に努めていますが、ファイルサイズにはハード制限があり、リポジトリには推奨サイズがあります。

ファイルサイズ制限

GitHub Enterprise Server には、リポジトリで許可されるファイルのサイズに制限があります。 50 MBより大きいファイルを追加または更新しようとすると、Gitから警告が表示されます。変更は引き続きリポジトリに正常にプッシュされますが、パフォーマンスへの影響を最小限に抑えるためにコミットを削除することを検討してもよいでしょう。詳しくは、「ファイルをリポジトリの履歴から削除する」をご覧ください。

注: ブラウザーからリポジトリにファイルを追加する場合、そのファイルは 25 MB 以下でなければなりません。詳しくは、「ファイルをリポジトリに追加する」を参照してください。

既定では、GitHub Enterprise Server は 100 MB を超えるファイルをブロックします。ただし、サイト管理者は、お使いの GitHub Enterprise Server インスタンスに対して異なる制限を構成できます。詳細については、「Enterprise でリポジトリ管理ポリシーを適用する」を参照してください。

この制限を超えるファイルを追跡するには、Git Large File Storage (Git LFS) を使う必要があります。詳しくは、「Git Large File Storageについて」を参照してください。

リポジトリ内で大きなファイルを配布する必要がある場合は、ファイルを追跡するのではなく、お使いの GitHub Enterprise Server インスタンスでリリースを作成できます。詳しくは、「大きなバイナリを配布する」をご覧ください。

Git は、大きい SQL ファイルを処理するようには設計されていません。大きいデータベースを他の開発者と共有するには、Dropbox を使うことをお勧めします。

リポジトリの推奨サイズ

リポジトリは小さく保ち、理想としては 1GB 未満、および 5GB 未満にすることを強くお勧めします。リポジトリが小さいほど、クローン作成が速く、操作やメンテナンスが簡単になります。

リポジトリのサイズと全体的な正常性を効果的に管理することで、リポジトリがインフラストラクチャに影響を与えないようにすることができます。 github/git-sizer リポジトリには、リポジトリの分析についてのアドバイスとツールがあります。

ファイルをリポジトリの履歴から削除する

警告: これらの手順を実行すると、ファイルはコンピューターのリポジトリとお使いの GitHub Enterprise Server インスタンスから完全に削除されます。ファイルが重要なものである場合は、ローカルバックアップコピーをリポジトリ外にあるディレクトリに作成してください。

プッシュされていない直近のコミットで追加されたファイルを削除する

直近のコミットで追加されたファイルをお使いの GitHub Enterprise Server インスタンスにプッシュしていない場合は、ファイルを削除してコミットを修正することができます。

[ターミナル][ターミナル][Git Bash] を開きます。 1. ワーキングディレクトリをローカルのリポジトリに変更します。

ファイルを削除するには、「git rm --cached」と入力します。

$ git rm --cached GIANT_FILE
# Stage our giant file for removal, but leave it on disk

--amend -CHEAD を使って、この変更をコミットします。

$ git commit --amend -CHEAD
# Amend the previous commit with your change
# Simply making a new commit won't work, as you need
# to remove the file from the unpushed history as well

コミットをお使いの GitHub Enterprise Server インスタンスにプッシュします。
```
$ git push
# Push our rewritten, smaller commit
```

以前のコミットで追加されたファイルを削除する

以前のコミットでファイルを追加した場合は、リポジトリの履歴から削除する必要があります。リポジトリの履歴からファイルを削除するには、BFG Repo-Cleaner または git filter-repo コマンドを使用できます。詳細については、「リポジトリからの機微なデータの削除」を参照してください。

大きなバイナリを配布する

リポジトリ内で大きなファイルを配布する必要がある場合は、お使いの GitHub Enterprise Server インスタンスでリリースを作成できます。リリースでは、他の人が使用できるように、ソフトウェア、リリースノート、バイナリファイルへのリンクをパッケージ化できます。詳しくは、「リリースについて」をご覧ください。