Bitbucket で Git LFS を使用する

Bitbucket Cloud は、大容量ファイルの処理を高速化する、Git の Large File Storage (LFS) 拡張機能をサポートします。この機能では、Git リポジトリ内の大容量ファイルをテキスト ポインタ ファイルで置き換えます。大容量ファイルはリモート サーバに保存され、ポインタはそれを示します。詳細については、「Bitbucket での Git Large File Storage」をご参照ください。

このページでは、Git LFS の使用を開始するための手順を説明しています。

このページに記載されたステップを完了したら、通常の操作と同様に、Git とリポジトリで作業を続行できます。LFS ファイル処理は自動的に行われるため、特別なアクションは不要です。

Git LFS の検証時は、Bitbucket に新しいリポジトリを用意することをおすすめします。これは、既存のリポジトリのコピーでもかまいません。本番環境で使用しているリポジトリを LFS の検証に使用しないようにしてください。

1. 新しいリポジトリとクローンを作成する 

Bitbucket で自身のアカウントにアクセスし、通常の手順で新しいリポジトリを作成してクローンします。

Bitbucket で Git LFS を検証する際は、本番環境やプロジェクトのリポジトリで予期しない結果が発生することを防ぐために、新しいリポジトリを使用することをおすすめします。

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

Git LFS を使用するすべてのユーザーが、ローカル マシンにクライアントをインストールする必要があります。この操作は一度のみ行います。

git --version コマンドを使用して、Git 1.8.2 以降がインストールされていることを確認します。

Git LFS クライアントをインストールします。

• Linux または Mac OS X の場合、パッケージ マネージャを使用して git-lfs をインストールするか、ここからダウンロードします。 

• Windows の場合、インストーラをここからダウンロードして実行します。 

ターミナルまたはコマンド プロンプトで次のコマンドを実行します。

これにより、ホーム ディレクトリの .gitconfig ファイルに LFS フィルタが追加され、すべてのリポジトリで利用できるようになります。LFS を特定のリポジトリでのみ使用したい場合、git lfs install --local を使用します。

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

Git LFS を使用する各リポジトリでトラッキングをセットアップする必要があります。

ローカル マシンで次の操作を行います。

1. Git LFS を使用したいリポジトリにディレクトリを切り替えて、次のコマンドを実行します。

   1 git lfs track '<pattern>'

   <pattern> には次の内容を設定できます。

   • "path/to/some/folders/*" などの、フォルダへのパス (複数可)

   • bckgrnd.bin、「*.psd」、「*.*」などの、特定のファイル名またはファイル タイプ。ワイルドカードを使用する場合、shell に展開されるのを防ぐために二重引用符で囲む必要があります。

   複数のパターンを追加できます。トラッキングされているすべてのパターンを確認するには、git lfs track コマンドを引数なしで使用します。パターンはリポジトリの .gitattributes ファイルに追加されます。 

2. .gitattributes ファイルへの変更を通常の手順でコミットおよびプッシュします。

   1 2 3 git add .gitattributes git commit -m "add Git LFS to the repo" git push origin main

   変更をプッシュすると、リポジトリをクローンしたすべてのユーザーにトラッキング パターンが適用されます。トラッキングを変更した場合はこの手順を行うことをおすすめします。

4. LFS ファイルを Bitbucket へプッシュする

これで、<pattern> に一致するファイル名のファイルを追加すると、自動的に LFS によって処理されるようになりました。

詳しく知りたい場合、Git LFS と使用方法についての詳細なチュートリアルをご参照ください。