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

レッスン一覧 › Lesson 09

リモートリポジトリと push / pull

GitHub 役のリモートに push し、同僚の変更を pull で取り込む。push が拒否される理由と対処も体験します。

難易度: 基本 ・ 所要時間: 約 15 分 ・ 学ぶコマンド: remote / push / fetch / pull

このページはブラウザ上のターミナルで実際にコマンドを打ちながら進めるレッスンです(JavaScript を有効にしてください)。手順は次のとおりです。

STEP 1: リモートとは

ここまでのリポジトリはあなたのパソコンの中(ローカル)だけにありました。チームで共有したり、バックアップにしたりするために、GitHub などのサーバー上に置く複製を リモートリポジトリ と呼びます。

右の「リモート (GitHub)」タブを開いてください。空のリポジトリ github.com/team/recipe-app が用意されています(GitHub で「New repository」を押した直後の状態です)。

まず、ローカルにリモートの場所を登録します。

git remote add origin https://github.com/team/recipe-app.git
git remote -v

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

STEP 2: push する

ローカルのコミットをリモートに送るのが push です。

git push

…エラーになります。has no upstream branch:「このブランチの送り先がまだ決まっていない」という意味です。メッセージの中に答えが書いてあります。

git push -u origin main

-u(--set-upstream)は「今後 main は origin の main とペアにする」という設定です。最初の 1 回だけ 付ければ、以降は git push だけで済みます。

リモートタブを見てください。コミットが GitHub 側に現れました。

STEP 3: origin/main という名札

git log --oneline --graph --all

origin/main という名札が増えています。これは リモート追跡ブランチ:「最後に確認したとき、リモートの main はここだった」という記憶です。あなたが直接動かすものではなく、push や fetch のたびに Git が更新します。

git status を打つと Your branch is up to date with 'origin/main' と出ます。ローカルとリモートが同じ位置、という意味です。

STEP 4: 同僚が push した

ここで、同僚の Hanako さんが同じリポジトリに変更を push しました(ターミナルに通知が出ています。リモートタブでも確認できます)。

あなたのローカルはまだそれを知りません。git status を打っても up to date のままです。リモートの最新情報を取ってくるのが fetch です。

git fetch
git status

Your branch is behind 'origin/main' by 1 commit:「あなたは origin/main より 1 コミット遅れている」。fetch は 情報を取ってくるだけ で、あなたのファイルは変えません。git log --oneline --graph --all で origin/main が先に進んでいるのが見えます。

STEP 5: pull で取り込む

リモートの変更を自分のブランチに取り込むのが pull です。pull = fetch + merge です。

git pull
ls

CONTRIBUTING.md が手元に現れました。今回は fast-forward で済んでいます(あなたはリモートの真後ろにいたので)。

STEP 6: push が拒否される

今度は、あなたと同僚が 同時に 作業した状況です。まずあなたがローカルでコミットします。

echo "## 開発の始め方" >> README.md
git commit -am "README に開発の始め方を追加"

その間に Hanako さんもまた push しました(通知を見てください)。この状態で push すると…

git push

! [rejected]。リモートには、あなたが持っていないコミットがある ので、上書きになってしまう push は拒否されます。これは Git があなたを守ってくれている安全装置です。

STEP 7: pull してから push

対処法もエラーメッセージに書いてあります: 'git pull' before pushing again。

git pull

あなたのコミットと Hanako さんのコミットは別々のファイルなので、マージコミットが自動で作られます(同じ行を変えていたらコンフリクトになり、前のレッスンの手順で解消します)。

本物の Git では、このように分岐した状態の git pull は、設定がないと fatal: Need to specify how to reconcile divergent branches. で止まります。最初に一度 git config --global pull.rebase false(merge で取り込む)を設定しておくと、ここと同じ動きになります。

git push
git log --oneline --graph --all

これで両方の作業がリモートに揃いました。pull → 解決 → push が、チーム開発の基本リズムです。

まとめ

このレッスンでやったこと

コマンド意味
git remote add origin <URL>リモートを登録(最初の 1 回)
git push -u origin main送り先を設定して push(最初の 1 回)
git pushローカルのコミットをリモートへ
git fetchリモートの情報を取得(ファイルは変えない)
git pullfetch + merge。リモートの変更を取り込む
  • origin/main は「最後に見たリモートの位置」を示す リモート追跡ブランチ
  • push が rejected されたら、pull してから push し直す
  • fetch は安全、pull は自分のブランチを変える

次は、チーム開発の中心になる プルリクエスト の流れを体験します。

関連する解説

次のレッスン: プルリクエストでチーム開発