既存の Bitbucket リポジトリで Git LFS を使用する

このページでは、既存の Bitbucket Cloud リポジトリで Git LFS (Large File Storage) 拡張機能を使用する方法について説明します。

Bitbucket にリポジトリがない場合、開始方法について「Bitbucket で Git LFS を使用する」ページをご参照ください。


既存のリポジトリで Git LFS の利用を開始する

1. ローカル マシンに Git LFS クライアントをインストールする

手順については、「Bitbucket で Git LFS を使用する」をご参照ください。

2. Git LFS ファイルのトラッキングをローカルにセットアップする

手順については、「Bitbucket で Git LFS を使用する」をご参照ください。

3. Git 履歴を変更する

大容量ファイルのトラッキングを行うことと、それらを LFS ファイルに変換することは異なる点にご注意ください。大容量ファイルは引き続き Git リポジトリの一部であるため、それらのファイルを変換するには、履歴を書き換える必要があります。 

既存の Git リポジトリを、Git LFS を使用できるように変換するには、bfg-repo-cleaner をご利用ください。手順については「BFG を使用してリポジトリを Git LFS に移行する」をご参照ください。


リポジトリから Git LFS ファイルを削除する

Bitbucket アカウントで LFS スペースを確保するなどの目的のために、リポジトリから Git LFS ファイルを削除する必要がある場合があります。Bitbucket の新しい料金モデルが開始されると、より多くのストレージ容量を使用できるようなる点にご注意ください。

リポジトリから個々の LFS ファイルを削除する

次の点を理解しておく必要があります。

  • The delete operation described here is destructive – there's no way to recover the LFS files referenced by the deleted LFS pointer files (it's not like the git remove command!) – so you'll want to back up the LFS files first.
  • LFS ファイルの削除を行うと、そのファイルはリモート ストレージからのみ削除されます。Git リポジトリに保存されているすべての参照ポインタはそのまま残ります。 
  • 今後、ブランチ、タグ、またはリビジョンで LFS ファイルを参照することはできません。削除された LFS ファイルを参照しているポインタ ファイルを含むブランチ、タグ、またはリビジョンをチェックアウトしようとした場合、ダウンロード エラーが表示され、チェックアウトは失敗します。 

リポジトリ管理者は次の手順でリポジトリから Git LFS ファイルを削除できます。

  1. リポジトリの設定ページに移動し、[Git LFS] をクリックして、リポジトリ内のすべての LFS ファイルの一覧を表示します。
  2. アクション メニューを使用して LFS ファイルを削除します。


LFS ファイルを含むリポジトリごと削除する

  • リポジトリを削除する前に、LFS ファイルを含んだ状態のリポジトリの完全なバックアップを作成しておくことをおすすめします。
  • リポジトリ管理者はリポジトリ設定から LFS ファイルを含むリポジトリを削除することができます。
  • 各リポジトリで使用されている LFS ストレージ量を確認するには、Bitbucket のアカウント設定で [Git LFS] に移動します。


ダウンロード エラーを防止する方法...

You can skip download errors by changing your .gitconfig file or by adding a variable. This causes Git LFS not to abort the smudge filter when a download error is encountered, which allows actions such as a checkout to work when you are unable to download the LFS content. LFS files which could not download will contain pointer content instead.

この手順では、smudge filter を呼び出す Git コマンドに、LFS ダウンロードが失敗した場合にも成功を返すように設定するため、スクリプトやビルド システムに影響を与える可能性があることにご注意ください。

.gitconfig ファイルを変更する

Add the following line to your .gitconfig file:


lfs.skipdownloaderrors= true


変数

You can also set the variable GIT_LFS_SKIP_DOWNLOAD_ERRORS=1 to get the same effect.

最終更新日 2018 年 11 月 23 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.