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?

@harapeco-mgn

第8章｜今さら学ぶ「Gem / Bundler / 依存管理」

0
Last updated at Posted at 2026-02-19

第8章｜今さら学ぶ「Gem / Bundler / 依存管理」

📚 シリーズ目次はこちら → 「今さら学ぶ」シリーズ — はじめに
🗺️ KnowledgeNoteの設計を確認 → 設計マップ

この章でわかること

  • Gemとは何か — Rubyの世界の「パーツ」
  • GemfileとGemfile.lockの役割の違い
  • バージョン指定（~> / >=）の意味
  • bundle install と bundle update の使い分け
  • KnowledgeNoteで使うGemの全体像

🏠 たとえ話で掴む「Gem / Bundler」

Gemとは何か。これを 料理のレシピと食材 にたとえて整理します。

KnowledgeNoteというWebアプリを作ることは、「フルコースの料理を作る」ようなものです。全部をゼロから手作りすることもできますが、ソースは既製品を使ったり、パスタは乾麺を買ってきたりします。

料理のたとえ Rubyの世界
既製品のソース、乾麺 Gem （誰かが作った便利なライブラリ）
レシピの「材料リスト」 Gemfile （このアプリに必要なGemの一覧）
実際に買ってきた食材と産地・賞味期限の記録 Gemfile.lock （実際にインストールされたバージョンの記録）
スーパーで買い出しする bundle install
食材を新しいものに買い替える bundle update
スーパーのカタログ RubyGems.org （Gemの公開リポジトリ）

大事なのは、 材料リスト（Gemfile）と買い出し記録（Gemfile.lock）は別のもの ということです。材料リストには「トマトソース」とだけ書いてあっても、実際に買ったのは「カゴメ基本のトマトソース 2024年製造」かもしれない。この「実際に買ったもの」の記録が Gemfile.lock です。

Gem / Bundler とは何か — 技術的な定義

パッケージ管理という仕組み

現代のソフトウェア開発では、すべてをゼロから書くことはまずありません。認証、ページネーション、メール送信など、多くの機能は先人が作ったライブラリとして公開されています。こうしたライブラリの 取得・バージョン管理・依存関係の解決 を行う仕組みが「パッケージ管理」です。

Rubyでは、ライブラリを Gem（ジェム） という形式でパッケージ化し、 RubyGems.org という公開リポジトリで配布しています。JavaScriptのnpm、Pythonのpipに相当するものです。

Bundlerの役割

Bundler は、アプリケーション単位でGemのバージョンを管理するツールです。Gem単体は gem install devise でインストールできますが、Bundlerを使うと「このアプリではdevise 4.9.3を使う」と固定できます。

Bundlerが解決する問題は 依存関係の衝突 です。Gem Aが「railties 7.x」を要求し、Gem Bが「railties 8.x」を要求している場合、両方を同時にインストールすることはできません。Bundlerは全Gemの依存関係をツリー状に解析し、矛盾のないバージョンの組み合わせを自動で算出します。その結果が Gemfile.lock に記録されます。

💎 Gemとは何か

Gem は、Rubyのライブラリ（再利用可能なコードの塊）をパッケージにしたものです。「こういう機能が欲しい」と思ったとき、ゼロから書く代わりに、誰かが作って公開してくれたGemをインストールして使えます。

# 例：KnowledgeNoteで使うGem
gem "devise"        # ユーザー認証の機能一式
gem "kaminari"      # ページネーション（一覧のページ送り）
gem "pundit"        # 認可（権限チェック）
gem "redcarpet"     # Markdownのパース（記事本文の変換）

Deviseを使えば、ログイン・ログアウト・パスワードリセットなどの機能を自分でイチから書かなくて済みます。これがGemの力です。

Gemの探し方

サイト 用途
RubyGems.org Gemの検索・詳細情報の確認
The Ruby Toolbox 目的別にGemを比較できる
GitHub ソースコード・Issue・更新頻度の確認

Gemを選ぶときは、 ダウンロード数・ 最終更新日・ GitHubのスター数 を見ます。更新が止まっているGemは、セキュリティリスクや互換性の問題を抱えている可能性があります。

📋 Gemfile — 材料リスト

Gemfile は、「このアプリでどのGemを使うか」を宣言するファイルです。Railsプロジェクトのルートディレクトリに置かれます。

# Gemfile（KnowledgeNoteの例）
source "https://rubygems.org"   # Gemのダウンロード元

ruby "3.2.2"                    # Rubyのバージョンを指定

gem "rails", "~> 8.0.0"        # Rails本体
gem "pg"                        # PostgreSQLアダプタ
gem "puma"                      # Webサーバ

# 認証・認可
gem "devise"
gem "pundit"

# 記事本文
gem "redcarpet"                 # Markdownパーサー
gem "rouge"                     # コードハイライト

# ページネーション
gem "kaminari"

# 開発・テスト環境でだけ使うGem
group :development, :test do
  gem "rspec-rails"             # テストフレームワーク
  gem "factory_bot_rails"       # テストデータ生成
  gem "faker"                   # ダミーデータ生成
  gem "debug"                   # デバッガー（Rails 8.0標準）
end

# 開発環境でだけ使うGem
group :development do
  gem "letter_opener"           # メールをブラウザでプレビュー
  gem "rubocop-rails", require: false  # コードリンター
end

# 本番環境でだけ使うGem
group :production do
  gem "resend"                  # メール配信サービス
end

group の意味

group は「このGemを使う環境」を指定します。テスト用のGemを本番にインストールする必要はないですし、開発用のメールプレビューツールも本番には不要です。

group :development, :test do
  gem "rspec-rails"    # 開発環境とテスト環境でだけ使う
end

group :production do
  gem "resend"         # 本番環境でだけ使う
end

本番デプロイ時には bundle install --without development test のように、不要なグループを除外してインストールします。

🔒 Gemfile.lock — 買い出し記録

Gemfile.lock は、bundle install を実行した結果、 実際にインストールされたGemの正確なバージョン が記録されるファイルです。

# Gemfile.lock（抜粋）
GEM
  remote: https://rubygems.org/
  specs:
    devise (4.9.3)
      bcrypt (~> 3.0)
      orm_adapter (~> 0.1)
      railties (>= 4.1.0)
      warden (~> 1.2.3)
    kaminari (1.2.2)
      activesupport (>= 4.1.0)
      kaminari-actionview (= 1.2.2)
      kaminari-activerecord (= 1.2.2)
      kaminari-core (= 1.2.2)

なぜ Gemfile.lock が必要か

チーム開発を想像してください。AさんとBさんが同じプロジェクトで開発しています。

Gemfileに書いてあること：
  gem "devise"   ← バージョン指定なし（最新版をどうぞ）

Aさんが bundle install した日：
  → devise 4.9.3 がインストールされた

Bさんが1ヶ月後に bundle install した日：
  → devise 4.10.0 がインストールされた（新版がリリースされていた）

結果：AさんとBさんで違うバージョンが動いている！

こうなると「Aさんの環境では動くのにBさんの環境ではエラーが出る」という事態が起きます。Gemfile.lock があれば、 チーム全員が同じバージョン を使うことが保証されます。

⚠️ Gemfile.lock は必ずGitにコミットしてください。 .gitignore に入れてはいけません。このファイルこそが「チーム全員の環境を揃える」鍵です。

📌 バージョン指定の読み方

Gemfileでよく見る ~> や >= は、「どのバージョンまで許容するか」のルールです。

セマンティック・バージョニング（SemVer）

まず、バージョン番号の意味を整理します。多くのGemは メジャー.マイナー.パッチ の3つの数字でバージョンを表現します。

devise 4.9.3
        │ │ └── パッチ：バグ修正（互換性あり）
        │ └──── マイナー：機能追加（互換性あり）
        └────── メジャー：破壊的変更（互換性が壊れる可能性）
バージョン変更 意味 影響
4.9.3 → 4.9.4 パッチ バグ修正のみ。安全
4.9.3 → 4.10.0 マイナー 新機能追加。基本的に安全
4.9.3 → 5.0.0 メジャー 破壊的変更あり。コード修正が必要かも

バージョン指定の記号

gem "rails", "8.0.1"       # ぴったりこのバージョン（厳密指定）
gem "rails", ">= 8.0"      # 8.0以上ならどれでもOK（緩い）
gem "rails", "~> 8.0.0"    # 8.0.x の範囲でOK（8.1.0は不可）
gem "rails", "~> 8.0"      # 8.x の範囲でOK（9.0.0は不可）

~>（悲観的バージョン指定 / twiddle-wakka） が一番よく使われます。「だいたいこのくらい」の約束です。

~> 8.0.0  → 8.0.0 以上 8.1.0 未満（パッチだけ許容）
~> 8.0    → 8.0 以上 9.0 未満（マイナーまで許容）
~> 4.9    → 4.9 以上 5.0 未満（マイナーまで許容）

この記号は「最後の桁だけ上がるのを許す」と覚えると簡単です。

🛒 bundle install と bundle update の違い

bundle install — 買い出し

$ bundle install

bundle install は、Gemfile を読んで必要なGemをインストールします。ただし、 Gemfile.lock が存在する場合は、そこに記録されたバージョンを優先 します。

つまり「買い出しリスト（Gemfile）を見て、前に買ったもの（Gemfile.lock）と同じ商品を買ってくる」動作です。

bundle update — 買い替え

$ bundle update devise    # deviseだけを最新版に更新
$ bundle update           # 全Gemを最新版に更新（⚠️ 慎重に）

bundle update は、Gemfile.lock を無視して、Gemfileの指定範囲内で最新バージョンをインストールします。Gemfile.lock も上書きされます。

コマンド やること Gemfile.lock
bundle install lockに従ってインストール（なければ新規作成） 既存を尊重
bundle update 指定範囲内で最新版に更新 上書き

使い分けのルール

■ 普段の開発：bundle install
  → チーム全員が同じバージョンを使うことを保証

■ 特定のGemを更新したいとき：bundle update <gem名>
  → 対象のGemだけを更新（影響範囲を限定）

■ 全Gemを一括更新：bundle update（⚠️ 注意）
  → テストが全部通ることを確認してから
  → 何が変わったか diff を見る

⚠️ bundle update（引数なし）は全Gemが一斉に更新されるため、予期しない不具合が起きるリスクがあります。実務では bundle update <gem名> で1つずつ更新するのが安全です。

🛠️ KnowledgeNoteでの具体例

KnowledgeNoteで使う主要なGemを、役割別に整理します。

# Gemfile（KnowledgeNote — 役割別に整理）

source "https://rubygems.org"
ruby "3.2.2"

# === フレームワーク本体 ===
gem "rails", "~> 8.0.0"
gem "pg"                           # PostgreSQL
gem "puma"                         # Webサーバ

# === フロントエンド ===
gem "importmap-rails"              # JavaScriptのimport管理（Node.js不要）
gem "turbo-rails"                  # Turbo（Hotwire）
gem "stimulus-rails"               # Stimulus（Hotwire）
gem "tailwindcss-rails"            # Tailwind CSS

# === 認証・認可 ===
gem "devise"                       # ユーザー認証（ログイン等）
gem "pundit"                       # 認可（権限チェック）

# === 記事機能 ===
gem "redcarpet"                    # Markdown → HTML変換
gem "rouge"                        # コードハイライト
gem "kaminari"                     # ページネーション

# === Rails 8.0 標準 ===
gem "solid_queue"                  # 非同期ジョブ（Redis不要）
gem "solid_cache"                  # キャッシュ（Redis不要）
gem "solid_cable"                  # WebSocket（Redis不要）

group :development, :test do
  gem "rspec-rails"                # テスト
  gem "factory_bot_rails"          # テストデータ
  gem "faker"                      # ダミーデータ
  gem "debug"                      # デバッガー
end

group :development do
  gem "letter_opener"              # メールプレビュー
  gem "rubocop-rails", require: false
end

group :production do
  gem "resend"                     # メール配信（本番用）
end

このGemfile全体を今すぐ理解する必要はありません。各章でそれぞれのGemを使うときに詳しく解説します。ここでは「KnowledgeNoteで使うGemの全体像」を把握しておいてください。たとえばdevise（認証）は（→ 第21章）、rspec-rails（テスト）は（→ 第22章）、resend（本番メール配信）は（→ 第33章）で詳しく扱います。

💼 面接で聞かれたら？

Q：Gemfile と Gemfile.lock の違いを説明してください。

「Gemfileはアプリに必要なGemと許容するバージョン範囲を宣言するファイルです。Gemfile.lockは bundle install の結果、実際にインストールされたGemの正確なバージョンが記録されるファイルです。Gemfile.lockをGitにコミットすることで、チーム全員が同じバージョンのGemを使えることが保証されます。」

深掘りされたら：

  • 「~> の意味は？」→ 悲観的バージョン指定。~> 8.0.0 は 8.0.x の範囲で最新を使う意味。最後の桁だけ上がるのを許容する。
  • 「bundle install と bundle update の違いは？」→ installはGemfile.lockに従ってインストール。updateはlockを無視して最新版に更新し、lockも上書きする。普段はinstall、更新したいときだけupdateを使う。

🔗 もっと深く知りたい人へ（1次情報リンク）

まとめ

  • ✅ Gemは「既製品の食材」。ゼロから作らずに便利な機能を使い回せる
  • ✅ Gemfileは「材料リスト」、Gemfile.lockは「実際に買ったものの記録」
  • ✅ Gemfile.lockは必ずGitにコミットする。チーム全員の環境を揃える鍵
  • ✅ ~> は「最後の桁だけ上がるのを許す」バージョン指定
  • ✅ bundle install は買い出し（lockに従う）、bundle update は買い替え（lockを上書き）

📚 シリーズ目次：「今さら学ぶ」シリーズ — はじめに

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
Sign upLogin
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?