リモートリポジトリ
ローカルとリモート
- ローカルリポジトリ — あなたのパソコンの中の
.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/loginfetch と 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 を出す手を動かして確かめる
このトピックは レッスンで実際に試せます。自由に試したい場合は プレイグラウンドへ。