$Git Simulator
壊しても大丈夫。全部ブラウザの中だけで動いています

リモートリポジトリ

ローカルとリモート

  • ローカルリポジトリ — あなたのパソコンの中の .git。ここまでのレッスンで使ってきたもの
  • リモートリポジトリ — GitHub などのサーバー上にある、同じリポジトリの複製

Git は 分散型 で、ローカルにも完全な履歴があります。ネットがなくてもコミットでき、あとでまとめてリモートと同期します。

   あなたのPC                    GitHub                    同僚のPC
┌────────────┐   push    ┌────────────────┐   pull    ┌────────────┐
│  ローカル    │ ───────▶ │   リモート       │ ───────▶ │  ローカル    │
│  リポジトリ  │ ◀─────── │  (origin)       │ ◀─────── │  リポジトリ  │
└────────────┘   pull    └────────────────┘   push    └────────────┘

origin

リモートには あだ名 を付けて登録します。最初のリモートは慣習的に origin と呼びます。

git remote add origin https://github.com/team/app.git
git remote -v         # 登録一覧

git clone すると、clone 元が自動で origin として登録されます。

3 つの同期コマンド

コマンド方向何をするか
git pushローカル → リモート自分のコミットを送る
git fetchリモート → ローカルリモートの情報を 取ってくるだけ。自分のブランチやファイルは変えない
git pullリモート → ローカルfetch + merge。リモートの変更を自分のブランチに取り込む

push

git push -u origin main    # 最初の 1 回。-u で送り先(upstream)を記憶
git push                   # 2 回目以降

-u(--set-upstream)を付けると、「このブランチは origin の main と対応する」と記憶されます。以降は git push / git pull だけで済みます。

新しいブランチを初めて push するときも -u を付けます。

git push -u origin feature/login

fetch と pull

fetch は安全です。何度打っても自分の作業は変わりません。「リモートで何が起きたか知りたい」ときに使います。

git fetch
git status               # behind / ahead が分かる
git log --oneline --graph --all   # origin/main の位置が見える

pull は fetch のあと、自分のブランチに マージ します。ファイルが変わります。コンフリクトすることもあります(解消方法は コンフリクト と同じ)。

リモート追跡ブランチ(origin/main)

git log や git branch -a に出てくる origin/main は、「最後に fetch/push したとき、リモートの main はここだった」という記憶 です。

  • あなたが直接コミットして動かすものではない
  • fetch / pull / push のたびに Git が更新する
  • リモートの「本当の今」とはズレていることがある(誰かが push した直後など)

git status の Your branch is ahead of 'origin/main' by 1 commit は、「ローカルの main は origin/main より 1 コミット進んでいる = まだ push していないコミットが 1 つある」という意味です。

push が rejected される

 ! [rejected]        main -> main (fetch first)
error: failed to push some refs to 'https://github.com/team/app.git'
hint: Updates were rejected because the remote contains work that you do not
hint: have locally. This is usually caused by another repository pushing to
hint: the same ref. If you want to integrate the remote changes, use
hint: 'git pull' before pushing again.

リモートに、あなたが持っていないコミットがある ときに出ます。誰かが先に push したのです。そのまま push するとその人の作業を上書きしてしまうので、Git が止めています。

対処は決まっています。

git pull      # リモートの変更を取り込む(必要ならコンフリクト解消)
git push      # 改めて送る

本物の Git での注意: ローカルとリモートの両方にコミットがある(分岐している)状態で git pull すると、最近の Git では設定がないと次のように止まります。

hint: You have divergent branches and need to specify how to reconcile them.
fatal: Need to specify how to reconcile divergent branches.

「merge で取り込むか rebase で取り込むか」を決めていないためです。一度だけ次のどちらかを設定しておけば、以降は git pull だけで済みます(このシミュレーターでは設定なしで merge します)。

git config --global pull.rebase false   # merge で取り込む(このサイトの説明どおり)
git config --global pull.rebase true    # rebase で取り込む

その場だけなら git pull --no-rebase / git pull --rebase でも構いません。チームに決まりがあればそれに従います。

git push --force で無理やり上書きすることもできますが、他人のコミットを消す可能性がある ので、共有ブランチでは使わないでください。

clone

リモートリポジトリを丸ごと手元に複製します。

git clone https://github.com/team/app.git

これで

  • 全コミット履歴がローカルに入る
  • origin が登録される
  • デフォルトブランチ(main)が checkout され、upstream も設定される

チームに参加するとき、最初にやるのがこれです。

典型的な 1 日

git switch main
git pull                        # 朝イチで最新にする
git switch -c feature/xxx       # 作業ブランチ
# ... 編集・コミット ...
git push -u origin feature/xxx  # push して PR を出す

手を動かして確かめる

このトピックは レッスンで実際に試せます。自由に試したい場合は プレイグラウンドへ。