Bitbucket での Git LFS の現在の制限事項

現在、Git LFS ファイルを含むリポジトリの譲渡は無効化されています。

リポジトリの譲渡では、Git LFS ファイルにアクセスするための権限が新しい所有者に付与されないため、リポジトリ内のこれらのファイルへのすべての参照が破損します。さらに、課題やプル リクエストなどの一部のメタデータは、新しいリポジトリに正しく譲渡されません。

ユーザーが最初の LFS ファイルをリポジトリにプッシュすると、そのリポジトリの譲渡は無効化されます。

リポジトリを譲渡するのではなく、リポジトリのクローンをローカル マシンに作成し、Bitbucket でリポジトリを作成してそこにプッシュします。

このとき、すべてのファイルと Git 履歴は新しいリポジトリで利用可能ですが、課題やプル リクエストなどのメタデータはコピーされません。さらに、新しいリポジトリのユーザーとアクセス権をセットアップする必要があります。

手順は以下のとおりです。

1. 通常の手順で、ローカル マシンに Git LFS リポジトリのクローンを作成します。

2. Git LFS 履歴をフェッチします。

   git lfs fetch --all origin

3. Bitbucket に新しいリポジトリを作成します。 

4. 新しいリポジトリを参照するリモートをローカルに追加します。

   git remote add new-origin <URL to new repo>

5. 新しいリポジトリにプッシュします。
   

   git push -u new-origin --all

   これによって、リポジトリとその参照の初回プッシュが行われます。

6. 新しいリポジトリに Git LFS データをプッシュします。

   git lfs push --all new-origin

7. 最後に、新しいリポジトリ用にリモートを更新します。
   

   git remote set-url origin <URL to new repo> git remote set-url --push origin <URL to new repo>

    

現在、Git LFS ファイルを含むリポジトリをフォークすると、新しいリモート ストアに LFS ファイルがコピーされません。

Git LFS ファイルを含むリポジトリのフォークでは、通常どおり、LFS ポインター ファイルを含むすべてのファイルがフォークにコピーされます。ただし、ポインター ファイルは元のリモート ストアを参照したままで、新しいリポジトリにはそこへのアクセス権がありません。

ユーザーが最初の Git LFS ファイルをリポジトリにプッシュすると、この制限がそのリポジトリのフォークに適用されます。

同じ理由でクロスフォーク プル リクエストが影響を受けることに注意してください。プル リクエストがマージされる際に、LFS ファイルがリモート ストアにコピーされません。

リポジトリをフォークするときに、以下のようにコマンド ラインを使用して Git LFS ファイルを新しいリポジトリにコピーできます。

1. Bitbucket で通常の手順でリポジトリをフォークします。

2. ローカル マシンに新しいリポジトリのクローンを作成します。

   git clone <clone URL for forked repo>

   エラーが表示される場合があります。これは以降で修正します。

3. 元のリポジトリを参照するリモートを追加します。

   git remote add old-origin <URL to original repo>

4. 元のリポジトリから Git LFS データをフェッチします。

   git lfs fetch --all old-origin

5. 新しいリポジトリに Git LFS データをプッシュします。

   git lfs push --all origin

6.  新しいリポジトリからプルして、クローンを更新します。

   git lfs pull

   これで完了です。

現在、リポジトリ、タグ、またはブランチのアーカイブをダウンロードした場合に、Git LFS ファイルが含まれません。通常のソース ファイルのほかに、LFS ファイル用のポインター参照ファイルのみが含まれます。これは、アーカイブではフル バックアップが作成されるわけではないことを意味します。

Git LFS ポインター ファイルはアーカイブに含まれますが、LFS ファイルは現在追加されません。

ユーザーが最初の LFS ファイルをリポジトリにプッシュすると、そのリポジトリで作成されたアーカイブにこの制限が適用されます。

回避策は、リポジトリのクローンを手動で作成し、ローカルでアーカイブすることです。

1. リポジトリのクローンを作成します。

   git clone <URL for repo>

2. 任意のツールを使用して、ローカルでリポジトリ ディレクトリを手動でアーカイブします。

3. (オプション) Bitbucket の [ダウンロード] ページにアーカイブをアップロードします。

これによって、メイン ブランチの先頭にあるファイルのみがアーカイブされることにご注意ください。Git 履歴で参照されたすべての LFS ファイルを取得するには、アーカイブを作成する前に git fetch --all を使用する必要があります。

 回避策は、手動でリポジトリのクローンを作成し、ブランチをチェックアウトして、ローカルでアーカイブすることです。

1. リポジトリのクローンを作成します。

   git clone <URL for repo>

2. ブランチをチェックアウトします。

   git checkout <branch_name>

3. 任意のツールを使用して、ローカルでリポジトリ ディレクトリを手動でアーカイブします。

4. (オプション) Bitbucket の [ダウンロード] ページにアーカイブをアップロードします。

 回避策は、手動でリポジトリのクローンを作成し、タグをチェックアウトして、ローカルでアーカイブすることです。

1. リポジトリのクローンを作成します。

   git clone <URL for repo>

2. タグをチェックアウトします。

   git checkout tags/<tag_name>

3. 任意のツールを使用して、ローカルでリポジトリ ディレクトリを手動でアーカイブします。

4. (オプション) Bitbucket の [ダウンロード] ページにアーカイブをアップロードします。