0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

【図解でわかるGit 第4回】リモートとローカル ― push/pull/fetchの裏側

0
Posted at

はじめに

株式会社Good Labでエンジニアをしている コータロー です。
日々、Java・SQL・Gitなどの技術情報や、新人エンジニア向けの学習ノウハウ、
AI活用についての情報を発信しています。

Good Labについて気になった方は、コーポレートサイトもぜひご覧ください。
▶コーポレートサイト


この記事は 「図解でわかるGitの仕組み」シリーズ の第4回です。
Gitの内部構造を、1テーマ1記事で図解していきます。

チーム開発で Git を使い始めると、git push や git pull を何気なく実行する場面が増えます。しかし、「これらのコマンドが実際に何をしているのか」を正確に理解している人は意外と少ないのではないでしょうか。

この記事では、以下のポイントを図解で解説します。

  • ローカルリポジトリとリモートリポジトリの関係
  • origin とは何か
  • git push / git fetch / git pull の仕組み
  • リモート追跡ブランチ(origin/main)の役割
  • git clone の裏側で起きていること

対象読者

  • git add / git commit / git push は使ったことがある
  • 「origin って何?」と聞かれると自信がない
  • fetch と pull の違いがあいまい
  • リモートリポジトリの仕組みを正確に理解したい

1. ローカルリポジトリとリモートリポジトリ

全体像

Git は 分散型バージョン管理システム です。各開発者のマシンに完全なリポジトリのコピー(ローカルリポジトリ)があり、GitHub 等のサーバー上にあるリポジトリ(リモートリポジトリ)と同期して共同作業を行います。

【図解: ローカルとリモートの全体像】

┌──────────────────────────────────────────────┐
│          リモートリポジトリ(GitHub)           │
│                                              │
│   main: A ── B ── C ── D                     │
│                                              │
└─────────────┬────────────────┬───────────────┘
              │                │
         push / fetch     push / fetch
              │                │
┌─────────────▼──────┐ ┌──────▼───────────────┐
│  ローカル(開発者A) │ │  ローカル(開発者B)    │
│                    │ │                      │
│  main: A ── B ── C │ │  main: A ── B ── C   │
│  (作業中)           │ │  feature: A ── B ── E │
└────────────────────┘ └──────────────────────┘

重要なポイントは以下の通りです。

  • ローカルリポジトリは完全なコピー であり、コミット履歴をすべて持っている
  • ネットワーク接続がなくても commit、log、branch 等の操作が可能
  • リモートとの同期は push / fetch / pull で 明示的に 行う

リモートリポジトリの実体

リモートリポジトリは特別なものではなく、Git リポジトリの一種です。GitHub や GitLab はこのリポジトリをホスティングし、Web UI やアクセス制御を提供しているにすぎません。

技術的には、リモートリポジトリは ベアリポジトリ(bare repository) として構成されています。これはワークツリーを持たず、.git/ ディレクトリの中身だけで構成されたリポジトリです。

# ベアリポジトリの作成(参考)
git init --bare my-project.git

2. origin とは何か

リモートの名前

origin は リモートリポジトリに付けられたデフォルトの名前(エイリアス) です。URL そのものではありません。

# リモートの一覧を表示
git remote
# 出力: origin

# URL も含めて表示
git remote -v
# 出力:
# origin  https://github.com/user/my-project.git (fetch)
# origin  https://github.com/user/my-project.git (push)
【図解: origin はリモートの名前】

「origin」= リモートリポジトリの URL に付けた名前

┌─────────────────────────────────────┐
│ ローカルリポジトリ                     │
│                                     │
│  リモート設定(.git/config):          │
│  ┌─────────────────────────────────┐│
│  │ [remote "origin"]               ││
│  │ url = https://github.com/...git ││
│  │ fetch = +refs/heads/*:          ││
│  │         refs/remotes/origin/*   ││
│  └─────────────────────────────────┘│
└─────────────────────────────────────┘
         │
         │  "origin" という名前で
         │  この URL を参照
         ▼
┌─────────────────────────────────────┐
│ https://github.com/user/my-project  │
│ (リモートリポジトリ)                  │
└─────────────────────────────────────┘

origin は変更可能

origin は慣例的なデフォルト名であり、変更や追加が可能です。

# リモートの名前を変更
git remote rename origin github

# 複数のリモートを登録
git remote add upstream https://github.com/original/project.git
git remote add origin   https://github.com/my-fork/project.git

フォークして開発する場合、origin(自分のフォーク)と upstream(元のリポジトリ)の2つを登録するのが一般的です。


3. リモート追跡ブランチ

origin/main とは何か

origin/main は リモート追跡ブランチ(remote-tracking branch) と呼ばれ、「リモートの main ブランチが最後に確認した時点でどこを指していたか」を記録したものです。

【図解: 3種類のブランチ】

┌──────────────────────────────────────────────┐
│ ローカルリポジトリ内の3種類の参照               │
│                                              │
│  1. ローカルブランチ        : main             │
│     → 自分で commit すると進む                 │
│                                              │
│  2. リモート追跡ブランチ    : origin/main       │
│     → fetch / pull で更新される               │
│     → 直接 commit できない(読み取り専用)       │
│                                              │
│  3. リモートのブランチ(実体): GitHub 上の main  │
│     → push で更新される                       │
└──────────────────────────────────────────────┘

重要な性質は以下の通りです。

  • リモート追跡ブランチは自動的に管理される --- git fetch や git pull 実行時に Git が自動で更新する
  • 直接コミットはできない --- チェックアウトしようとすると detached HEAD になる
  • ローカルブランチとリモートの橋渡し役 として機能する

確認方法

# リモート追跡ブランチの一覧
git branch -r
# 出力例:
# origin/main
# origin/develop
# origin/feature/login

# ローカルブランチとリモート追跡ブランチの両方を表示
git branch -a
# 出力例:
# * main
#   develop
#   remotes/origin/main
#   remotes/origin/develop
#   remotes/origin/feature/login

ローカルブランチとの追跡関係

ローカルブランチは、対応するリモート追跡ブランチを 上流ブランチ(upstream branch) として設定できます。

# 上流ブランチの設定(push 時に -u オプション)
git push -u origin main

# 追跡関係の確認
git branch -vv
# 出力例:
# * main    a1b2c3d [origin/main] 最新のコミットメッセージ
#   develop e4f5g6h [origin/develop: ahead 2] ローカルが2コミット先行

ahead 2 は「ローカルにリモートより2つ多くコミットがある(まだ push していない)」ことを意味します。behind 3 なら「リモートに3つ新しいコミットがある(まだ pull していない)」を意味します。


4. git fetch --- リモートの情報を取得する

仕組み

git fetch は リモートリポジトリから最新のコミットやブランチ情報を取得し、リモート追跡ブランチを更新する コマンドです。ローカルブランチやワークツリーには一切影響しません。

【図解: git fetch の動作】

[実行前]

リモート(GitHub)             ローカル
main: A ── B ── C ── D        main:        A ── B ── C
                               origin/main: A ── B ── C

               git fetch
        ─────────────────→

[実行後]

リモート(GitHub)             ローカル
main: A ── B ── C ── D        main:        A ── B ── C    ← 変化なし
                               origin/main: A ── B ── C ── D  ← 更新された

ポイントを整理します。

  • リモートの新しいコミット(D)がダウンロードされる
  • origin/main が更新される(C → D)
  • ローカルの main は変化しない
  • ワークツリーのファイルも変化しない

コマンド例

# すべてのリモート追跡ブランチを更新
git fetch

# 特定のリモートだけ fetch
git fetch origin

# 特定のブランチだけ fetch
git fetch origin main

# リモートで削除されたブランチの参照もクリーンアップ
git fetch --prune

fetch 後の確認

# リモートとの差分を確認
git log main..origin/main --oneline
# → ローカルの main にはないが origin/main にはあるコミット一覧

git log origin/main..main --oneline
# → origin/main にはないがローカルの main にはあるコミット一覧

# 差分の内容を確認
git diff main origin/main

5. git push --- ローカルの変更をリモートに送る

仕組み

git push は ローカルブランチのコミットをリモートリポジトリに送信し、リモートのブランチを更新する コマンドです。

【図解: git push の動作】

[実行前]

ローカル                       リモート(GitHub)
main:        A ── B ── C ── D  main: A ── B ── C
origin/main: A ── B ── C

             git push origin main
        ──────────────────────→

[実行後]

ローカル                       リモート(GitHub)
main:        A ── B ── C ── D  main: A ── B ── C ── D  ← 更新された
origin/main: A ── B ── C ── D  ← 同時に更新される

push 成功時、リモート追跡ブランチ(origin/main)も自動で更新されます。

push が拒否されるケース

リモートにローカルにないコミットがある場合、push は 拒否(rejected) されます。

【図解: push が拒否されるケース】

ローカル                       リモート(GitHub)
main: A ── B ── D              main: A ── B ── C
                                          ↑
                                   他の開発者が push した

             git push origin main
        ──────────────────────→  ❌ rejected!
                                   (fast-forward できない)

解決策: 先に fetch + merge(または pull)してから push する

ローカル
main: A ── B ── D
              ↘
               merge ← git pull で C を取り込む
              ↗
         C ──
main: A ── B ── D ── C ── M(マージコミット)

             git push origin main
        ──────────────────────→  ✅ 成功

コマンド例

# 基本的な push
git push origin main

# 上流ブランチを設定しつつ push(初回推奨)
git push -u origin main

# 上流ブランチ設定済みなら省略可能
git push

# 新しいブランチをリモートに作成
git push -u origin feature/login

6. git pull --- fetch + merge

仕組み

git pull は、内部的に git fetch + git merge を実行するコマンドです。

【図解: git pull = git fetch + git merge】

[実行前]

リモート(GitHub)             ローカル
main: A ── B ── C ── D        main:        A ── B ── C
                               origin/main: A ── B ── C

             git pull origin main
        ←─────────────────────

[ステップ1: fetch(内部処理)]

                               main:        A ── B ── C     ← まだ変化なし
                               origin/main: A ── B ── C ── D ← 更新

[ステップ2: merge(内部処理)]

                               main:        A ── B ── C ── D ← マージされた
                               origin/main: A ── B ── C ── D

上の例は fast-forward マージ のケースです。ローカルに独自のコミットがない場合、ポインタが単純に前に進みます。

ローカルにも独自コミットがある場合

【図解: pull でマージコミットが発生するケース】

[実行前]

リモート(GitHub)             ローカル
main: A ── B ── C ── D        main:        A ── B ── C ── E
                               origin/main: A ── B ── C

             git pull origin main
        ←─────────────────────

[実行後]

                               origin/main: A ── B ── C ── D
                               main:        A ── B ── C ── E
                                                        ↘  ↗
                                                     D ── M(マージコミット)

この場合、D と E を統合するマージコミット M が自動生成されます。コンフリクトが発生した場合は手動で解決が必要です。

git pull --rebase

マージコミットを作らずにリモートの変更を取り込みたい場合は、--rebase オプションを使います。

【図解: git pull --rebase】

[実行前]

リモート                       ローカル
main: A ── B ── C ── D        main: A ── B ── C ── E

             git pull --rebase origin main
        ←─────────────────────

[実行後]

                               main: A ── B ── C ── D ── E'
                                                         ↑
                                               E を D の後ろに付け替え
                                              (コミットハッシュは変わる)

--rebase は履歴が一直線になるため見やすくなりますが、コミットハッシュが変わる点に注意が必要です。

コマンド例

# 基本的な pull(fetch + merge)
git pull

# 特定のリモート・ブランチを指定
git pull origin main

# rebase で pull
git pull --rebase

# デフォルトで rebase にする設定
git config --global pull.rebase true

7. git clone の裏側

clone で何が起きているか

git clone は単にファイルをダウンロードしているだけではありません。内部では複数の処理が実行されています。

【図解: git clone の内部処理】

git clone https://github.com/user/my-project.git

内部で行われる処理:

1. mkdir my-project && cd my-project
2. git init
   → 空のローカルリポジトリを作成

3. git remote add origin https://github.com/user/my-project.git
   → リモート "origin" を登録

4. git fetch origin
   → すべてのブランチ・タグ・コミットをダウンロード
   → リモート追跡ブランチ(origin/main, origin/develop ...)を作成

5. git checkout main
   → デフォルトブランチをチェックアウト
   → ローカルブランチ "main" を作成し、origin/main を上流に設定

結果:
┌──────────────────────────────────┐
│ my-project/                      │
│ ├── .git/                        │
│ │   ├── config   ← origin の URL │
│ │   ├── objects/ ← 全コミット     │
│ │   └── refs/                    │
│ │       ├── heads/main           │
│ │       └── remotes/origin/main  │
│ ├── src/                         │
│ └── README.md                    │
└──────────────────────────────────┘

clone のオプション

# 基本的な clone
git clone https://github.com/user/my-project.git

# ディレクトリ名を指定
git clone https://github.com/user/my-project.git my-app

# 最新のコミットだけ取得(CI/CD で高速化したい場合)
git clone --depth 1 https://github.com/user/my-project.git

# 特定のブランチだけ clone
git clone --branch develop --single-branch https://github.com/user/my-project.git

8. git remote コマンド

リモートの管理

git remote コマンドで、ローカルリポジトリに登録されたリモートを管理します。

# リモート一覧
git remote
# 出力: origin

# URL 付きで表示
git remote -v
# 出力:
# origin  https://github.com/user/my-project.git (fetch)
# origin  https://github.com/user/my-project.git (push)

# リモートの詳細情報
git remote show origin
# 出力例:
# * remote origin
#   Fetch URL: https://github.com/user/my-project.git
#   Push  URL: https://github.com/user/my-project.git
#   HEAD branch: main
#   Remote branches:
#     develop tracked
#     main    tracked
#   Local branch configured for 'git pull':
#     main merges with remote main
#   Local ref configured for 'git push':
#     main pushes to main (up to date)

リモートの追加・変更・削除

# リモートを追加
git remote add upstream https://github.com/original/project.git

# リモートの URL を変更
git remote set-url origin https://github.com/user/new-repo.git

# リモートの名前を変更
git remote rename origin github

# リモートを削除
git remote remove upstream

複数リモートの活用例

フォークして開発する場合、2つのリモートを使い分けます。

【図解: 複数リモートの運用(フォーク開発)】

┌──────────────────────────────┐
│ upstream(元のリポジトリ)      │
│ https://github.com/org/repo  │
│ main: A ── B ── C ── D ── E  │
└──────────┬───────────────────┘
           │ fork
┌──────────▼───────────────────┐
│ origin(自分のフォーク)        │
│ https://github.com/me/repo   │
│ main: A ── B ── C            │
└──────────┬───────────────────┘
           │
┌──────────▼───────────────────┐
│ ローカル                      │
│ main: A ── B ── C            │
│ feature: A ── B ── C ── F    │
│                              │
│ リモート設定:                  │
│   origin   → 自分のフォーク    │
│   upstream → 元のリポジトリ    │
└──────────────────────────────┘

# 元のリポジトリの最新を取り込む
git fetch upstream
git merge upstream/main

# 自分のフォークに push
git push origin main

9. 全体像のまとめ

最後に、各コマンドがどこからどこへデータを移動させるかをまとめます。

【図解: push / fetch / pull の全体像】

┌───────────────────────────────────────────────────────────────┐
│                    リモートリポジトリ(GitHub)                  │
│                         origin/main                          │
└──────────┬──────────────────────┬────────────────┬───────────┘
           │                      │                │
      git push              git fetch         git clone
     (ローカル→リモート)    (リモート→ローカル)    (初回コピー)
           │                      │                │
           │                      ▼                │
           │          ┌───────────────────┐        │
           │          │ リモート追跡ブランチ  │        │
           │          │   origin/main     │        │
           │          └────────┬──────────┘        │
           │                   │                   │
           │              git merge                │
           │            (追跡→ローカル)             │
           │                   │                   │
           │                   ▼                   │
┌──────────┴───────────────────────────────────────┴───────────┐
│                    ローカルブランチ                              │
│                         main                                 │
└──────────────────────────────────────────────────────────────┘

  git pull  =  git fetch  +  git merge
コマンド データの流れ ローカルブランチへの影響
git fetch リモート → リモート追跡ブランチ なし
git push ローカルブランチ → リモート なし
git pull リモート → リモート追跡ブランチ → ローカルブランチ あり(merge される)
git clone リモート → 新しいローカルリポジトリ 初回作成

よくある疑問

Q1. fetch と pull はどちらを使うべき?

安全性を重視するなら fetch → 差分確認 → merge の2ステップがおすすめです。pull は便利ですが、予期しないマージコンフリクトが発生する可能性があります。

# 安全な手順
git fetch
git log main..origin/main --oneline  # 何が変わったか確認
git merge origin/main                # 問題なければマージ

Q2. push が rejected されたらどうする?

先にリモートの変更を取り込んでから再度 push します。

# 方法1: pull してから push
git pull origin main
git push origin main

# 方法2: fetch + rebase してから push(履歴を一直線にしたい場合)
git fetch origin
git rebase origin/main
git push origin main

git push --force は原則使わないでください。 他の開発者の作業を破壊する危険があります。

Q3. origin/main と main がずれているか確認するには?

# 上流ブランチとの比較
git status
# 出力例: Your branch is behind 'origin/main' by 3 commits

# 詳細な差分
git log --oneline --left-right main...origin/main
# < はローカルのみ、> はリモートのみのコミット

次回予告

第5回: コンフリクト解消

次回は、マージやリベース時に発生する コンフリクト の仕組みと解消方法を図解します。コンフリクトが「なぜ起きるのか」「何が起きているのか」を理解すると、落ち着いて対処できるようになります。


シリーズ目次

# テーマ
1 Gitの全体像 ― ワークツリー・ステージ・リポジトリの3層構造
2 ブランチとHEAD ― 「枝分かれ」の正体を理解する
3 マージとリベース ― 統合戦略の違いを図で比較
4 リモートとローカル ― push/pull/fetchの裏側(この記事)
5 コンフリクト解消 ― なぜ起きるのか、どう直すのか
6 reset/revert/checkout ― 「戻す」操作を正しく使い分ける
7 stash/cherry-pick/rebase -i ― 実務で頼れる便利コマンド
8 .gitignore・フック・設定 ― Gitをカスタマイズする
9 Git Flow vs GitHub Flow ― ブランチ戦略の選び方
10 トラブルシューティング ― 「やらかした!」を救うコマンド集

参考


「この記事が役に立った」と思ったら、LGTM とストックをお願いします。

@kotaro_ai_lab
AI活用や開発効率化について発信しています。フォローお気軽にどうぞ!

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?