git clone --mirrorとgit clone --bareの違いは何ですか

git cloneのヘルプページには、次のように書かれてい--mirrorます。

リモートリポジトリのミラーをセットアップします。これは意味し--bareます。

ただし、--mirrorクローンとクローンの違いについては詳しく説明しません--bare。

違いは、を使用すると--mirror、すべての参照がそのままコピーされることです。これはすべてを意味します：リモート追跡ブランチ、メモ、refs / originals / *（フィルターブランチからのバックアップ）。複製されたレポはそれをすべて持っています。また、リモート更新ですべてをオリジンから再フェッチするように設定されます（コピーされた参照を上書きします）。アイデアは、実際にはリポジトリをミラーリングし、完全なコピーを作成することです。これにより、たとえば、中央リポジトリを複数の場所でホストしたり、バックアップしたりできます。よりエレガントなgitの方法を除いて、リポジトリをまっすぐにコピーすることを考えてください。

新しいドキュメンテーションはほとんどこれをすべて言っています：

--mirror

ソースリポジトリのミラーをセットアップします。これは意味し--bareます。と比較して--bare、--mirrorソースのローカルブランチをターゲットのローカルブランチにマップするだけでなく、すべてのref（リモートブランチ、ノートなどを含む）をマップし、これらすべてのrefがgit remote updateターゲットリポジトリのによって上書きされるようにrefspec構成を設定します。

私の元の回答では、ベアクローンと通常の（非ベア）クローンの違いも指摘しました。非ベアクローンはリモートトラッキングブランチをセットアップし、のローカルブランチのみを作成HEADしますが、ベアクローンはブランチを直接コピーします。

仮定原点は（いくつかの支店を持っているmaster (HEAD)、next、pu、およびmaint）、いくつかのタグ（v1、v2、v3）、いくつかのリモートブランチ（devA/master、devB/master）、および（他のいくつかの参照文献refs/foo/bar、refs/foo/baz知っているノート、スタッシュ、他の開発者の名前空間、かもしれません）。

• git clone origin-url（非裸）：あなたがコピーされたタグのすべてを取得する、ローカルブランチは、master (HEAD)リモートブランチを追跡origin/masterし、リモートブランチorigin/next、origin/puとorigin/maint。追跡ブランチはgit fetch origin、のようなことをした場合に、期待どおりにフェッチされるように設定されています。リモートブランチ（クローンリモート内）とその他の参照は完全に無視されます。

• git clone --bare origin-url：あなたは、コピーされたすべてのタグ、支店でしょうmaster (HEAD)、next、pu、とmaint、ないリモート追跡ブランチを。つまり、すべてのブランチがそのままコピーされ、完全に独立してセットアップされ、再度フェッチすることは期待されません。リモートブランチ（クローンリモート内）とその他の参照は完全に無視されます。

• git clone --mirror origin-url：これらの参照の最後の1つはそのままコピーされます。あなたはすべてのタグ、支店得るでしょうmaster (HEAD)、next、pu、およびmaint、リモートブランチdevA/masterとdevB/master、他の参考文献refs/foo/barとrefs/foo/baz。すべては、クローンされたリモートの場合とまったく同じです。リモートトラッキングが設定されているので、実行git remote updateすると、ミラーを削除して再クローンしたかのように、すべての参照が元の場所から上書きされます。ドキュメントが最初に言ったように、それは鏡です。機能的には同一のコピーで、オリジナルと交換可能です。

$ git clone --mirror $URL

の略記です

$ git clone --bare $URL
$ (cd $(basename $URL) && git remote add --mirror=fetch origin $URL)

（ここから直接コピー）

現在のマンページはそれをどのように置くか：

と比較して--bare、--mirrorソースのローカルブランチをターゲットのローカルブランチにマップするだけでなく、すべてのref（リモートブランチ、ノートなどを含む）をマップし、これらすべてのrefがgit remote updateターゲットリポジトリのによって上書きされるようにrefspec構成を設定します。

今日のgit-2.0.0でのテストは、-mirrorオプションがフック、設定ファイル、説明ファイル、info / excludeファイルをコピーせず、少なくとも私のテストケースではいくつかの参照をコピーしないことを示しています（これは私が行いません） tは理解します。）私はそれを「オリジナルと交換可能な機能的に同一のコピー」とは呼びません。

-bash-3.2$ git --version
git version 2.0.0
-bash-3.2$ git clone --mirror /git/hooks
Cloning into bare repository 'hooks.git'...
done.

-bash-3.2$ diff --brief -r /git/hooks.git hooks.git
Files /git/hooks.git/config and hooks.git/config differ
Files /git/hooks.git/description and hooks.git/description differ
...
Only in hooks.git/hooks: applypatch-msg.sample
...
Only in /git/hooks.git/hooks: post-receive
...
Files /git/hooks.git/info/exclude and hooks.git/info/exclude differ
...
Files /git/hooks.git/packed-refs and hooks.git/packed-refs differ
Only in /git/hooks.git/refs/heads: fake_branch
Only in /git/hooks.git/refs/heads: master
Only in /git/hooks.git/refs: meta

リポジトリの複製に関するGitHubドキュメントからの微妙な説明：

ベアクローンと同様に、ミラークローンにはすべてのリモートブランチとタグが含まれますが、フェッチするたびにすべてのローカル参照が上書きされるため、常に元のリポジトリと同じになります。

クローンはリモートから参照をコピーし、「これらはリモートが持っている参照です」という名前のサブディレクトリにそれらを詰め込みます。

ミラーはリモートからの参照をコピーし、それらを独自のトップレベルに配置します-ミラーは自身の参照をリモートの参照で置き換えます。

これは、誰かがあなたのミラーからプルして、ミラーのリファレンスをサブディレクトリに詰め込むと、オリジナルのものと同じリファレンスを取得することを意味します。最新のミラーからフェッチした結果は、最初のリポジトリから直接フェッチした場合と同じです。

画像を追加し、configミラーとベアの違いを示します。 左は裸、右は鏡です。あなたは、ミラーのconfigファイルを持って、明確にすることができfetch、あなたはそれを更新することができることを意味し、キーをすることによってgit remote updateか、git fetch --all

$ git clone --bare https://github.com/example

このコマンドは、新しいもの自体を$ GIT_DIRにします。また、リモートのブランチヘッドは、マッピングせずに、対応するローカルブランチヘッドに直接コピーされます。このオプションを使用すると、リモート追跡ブランチも関連する構成変数も作成されません。

$ git clone --mirror https://github.com/example

ベアクローンと同様に、ミラークローンにはすべてのリモートブランチとタグが含まれますが、フェッチするたびにすべてのローカル参照（リモート追跡ブランチ、ノートなどを含む）が上書きされるため、常に元のリポジトリと同じになります。