Rails 7 APIモードで本番レベルのTodo APIを作る手順

2026年6月24日

Contents

1 Rails 7 API モードのセットアップ
- 1.1 Rails のインストールと --api オプションの意味
- 1.2 Zeitwerk と Hotwire の取り扱い（Rails 7.1 の変更点）
2 本番環境で必要なミドルウェアと CORS／HTTPS 設定
3 API 用コントローラと名前空間ルーティングの設計
- 3.1 名前空間ディレクトリと BaseController の作成
- 3.2 ルーティングベストプラクティス
4 JSON シリアライザの選択肢と実装例
5 認証・テスト・デプロイの実践フロー
6 まとめ

スポンサードリンク

Rails 7 API モードのセットアップ

Rails 7 の API モードは、不要なミドルウェアやビュー関連コードを除外した最小構成でプロジェクトを開始できる点が魅力です。このセクションでは Ruby と Rails のインストールから rails new my_api --api による雛形作成までの手順と、Rails 7.1 で変更されたデフォルト設定について解説します。

Rails のインストールと `--api` オプションの意味

まずは Ruby（3.2 系）と Rails 7 を導入し、API 用プロジェクトを生成します。

gem install rails -v &quot;~&gt;7.0&quot;
rails new my_api --api

gem install rails -v "~>7.0"

rails new my_api --api

--api は ActionController::API ベースのミドルウェアスタックを作成し、HTML ビューや Asset Pipeline の設定を省きます。
生成されるディレクトリは app/controllers, app/models, config/routes.rb だけになるため、軽量かつ起動が速くなります。

Zeitwerk と Hotwire の取り扱い（Rails 7.1 の変更点）

Rails 7 系ではデフォルトコードローダーとして Zeitwerk が採用されており、app/ 以下のファイル名とクラス名が一致すれば自動ロードされます。API モードでも同様に機能します。

重要：Rails 7.1 からは gem 'hotwire-rails' がデフォルト Gemfile から除外されるため、API アプリを作成した直後に Hotwire 関連の設定が残っていることはありません。フロントエンドが別プロセスになるケースでは、特に意識せずにそのまま利用できます。

本番環境で必要なミドルウェアと CORS／HTTPS 設定

本番向け API では、セキュリティ・パフォーマンス確保のために追加ミドルウェアや HTTPS 強制が必須です。この章では除外されるミドルウェアの確認方法と、CORS とレートリミットを実装する手順を示します。

デフォルトで除外されるミドルウェア一覧

rails new --api が生成しない主なミドルウェアは次の通りです。

除外されたミドルウェア	主な役割
`ActionDispatch::Cookies`	Cookie の管理
`ActionDispatch::Session::CookieStore`	セッション管理
`Rack::MethodOverride`	HTTP メソッドの上書き
`Sprockets (Asset Pipeline)`	静的資産配信

API アプリでは Token 認証が主流なため Cookie/Session は不要です。その代わり CORS と レートリミット が重要になります。

rack‑cors と rack‑attack の導入手順

Gemfile に以下を追記し、バンドルします。

gem 'rack-cors'
gem 'rack-attack'

gem 'rack-cors'

gem 'rack-attack'

続いて config/application.rb 内でミドルウェアスタックに組み込みます。

# config/application.rb
module MyApi
  class Application &lt; Rails::Application
    # --- CORS 設定 -------------------------------------------------
    config.middleware.insert_before 0, Rack::Cors do
      allow do
        origins 'https://example.com'   # 必要に応じて複数指定可
        resource '/api/*',
                 headers: :any,
                 methods: %i[get post put patch delete options head],
                 expose:  ['Authorization'],
                 max_age: 600
      end
    end

    # --- Rack::Attack 設定 -----------------------------------------
    config.middleware.use Rack::Attack
  end
end

# config/application.rb

module MyApi

class Application < Rails::Application

# --- CORS 設定 -------------------------------------------------

config.middleware.insert_before 0, Rack::Cors do

allow do

origins 'https://example.com' # 必要に応じて複数指定可

resource '/api/*',

headers: :any,

methods: %i[get post put patch delete options head],

expose: ['Authorization'],

max_age: 600

end

# --- Rack::Attack 設定 -----------------------------------------

config.middleware.use Rack::Attack

end

rack-attack の具体的なルールは config/initializers/rack_attack.rb に記述します。

# config/initializers/rack_attack.rb
class Rack::Attack
  throttle('req/ip', limit: 100, period: 1.minute) { |req| req.ip }

  self.blocklisted_response = lambda do |_env|
    [429, { 'Content-Type' =&gt; 'application/json' },
     [{ error: 'Too Many Requests' }.to_json]]
  end
end

# config/initializers/rack_attack.rb

class Rack::Attack

throttle('req/ip', limit: 100, period: 1.minute) { |req| req.ip }

self.blocklisted_response = lambda do |_env|

[429, { 'Content-Type' => 'application/json' },

[{ error: 'Too Many Requests' }.to_json]]

end

production.rb における HTTPS 強制設定例

本番環境では force_ssl を有効にし、HSTS ヘッダーを付与します。

# config/environments/production.rb
Rails.application.configure do
  config.force_ssl = true
  config.ssl_options = { hsts: { expires: 30.days, preload: true } }
  config.log_level = :info   # ログノイズ削減
end

# config/environments/production.rb

Rails.application.configure do

config.force_ssl = true

config.ssl_options = { hsts: { expires: 30.days, preload: true } }

config.log_level = :info # ログノイズ削減

end

force_ssl が有効になると HTTP リクエストは自動的に HTTPS にリダイレクトされるため、クライアント側でも https:// エンドポイントを使用してください。

API 用コントローラと名前空間ルーティングの設計

大規模な API ではバージョニングや機能ごとの分割が保守性の鍵になります。この章では Api::V1 名前空間の作り方と、実務で推奨されるルーティング構造を示します。

名前空間ディレクトリと BaseController の作成

まずは名前空間用フォルダと共通ロジックを持つベースコントローラを生成します。

mkdir -p app/controllers/api/v1
rails g controller api/v1/base --skip-template-engine --skip-assets

mkdir -p app/controllers/api/v1

rails g controller api/v1/base --skip-template-engine --skip-assets

BaseController は ActionController::API を継承し、認証やエラーハンドリングの共通処理を配置します。

# app/controllers/api/v1/base_controller.rb
module Api
  module V1
    class BaseController &lt; ActionController::API
      before_action :authenticate_user!

      rescue_from ActiveRecord::RecordNotFound, with: :render_not_found
      rescue_from JWT::DecodeError,          with: :render_unauthorized

      private

      def render_not_found(exception)
        render json: { error: exception.message }, status: :not_found
      end

      def render_unauthorized
        render json: { error: 'Invalid token' }, status: :unauthorized
      end
    end
  end
end

# app/controllers/api/v1/base_controller.rb

module Api

module V1

class BaseController < ActionController::API

before_action :authenticate_user!

rescue_from ActiveRecord::RecordNotFound, with: :render_not_found

rescue_from JWT::DecodeError, with: :render_unauthorized

private

def render_not_found(exception)

render json: { error: exception.message }, status: :not_found

end

def render_unauthorized

render json: { error: 'Invalid token' }, status: :unauthorized

end

ルーティングベストプラクティス

config/routes.rb に名前空間とバージョニングを明示すると、将来的な拡張が楽になります。

# config/routes.rb
Rails.application.routes.draw do
  namespace :api, defaults: { format: :json } do
    namespace :v1 do
      # 認証系エンドポイント
      post   'auth/login',   to: 'authentication#login'
      post   'auth/refresh', to: 'authentication#refresh'

      # Todo リソース（例）
      resources :todos, only: %i[index show create update destroy]
    end
  end

  # ヘルスチェック用エンドポイント（任意）
  get '/up', to: proc { [200, {}, ['OK']] }
end

# config/routes.rb

Rails.application.routes.draw do

namespace :api, defaults: { format: :json } do

namespace :v1 do

# 認証系エンドポイント

post 'auth/login', to: 'authentication#login'

post 'auth/refresh', to: 'authentication#refresh'

# Todo リソース（例）

resources :todos, only: %i[index show create update destroy]

end

# ヘルスチェック用エンドポイント（任意）

get '/up', to: proc { [200, {}, ['OK']] }

end

defaults: { format: :json } により拡張子が省略されたリクエストでも JSON が返ります。
認証は専用コントローラに分離し、ビジネスロジックと切り分けて保守性を高めます。

JSON シリアライザの選択肢と実装例

JSON の生成方法として代表的なのは ActiveModelSerializers (AMS) と Jbuilder です。ここでは両者の特徴比較と、シンプルな実装サンプルを示します。

AMS と Jbuilder の比較表

以下の観点で違いを整理しました。

項目	ActiveModelSerializers (AMS)	Jbuilder
宣言的 DSL	あり（`serializer` クラス）	なし（Ruby スクリプト）
再利用性	高い（同一 serializer を複数で使用可）	中程度（部分テンプレートで対応）
パフォーマンス	大量データ時に若干遅くなることがある	ビュー側ロジックなので高速
カスタム属性	`attributes` メソッドで簡単追加	Ruby で自由記述可能
学習コスト	DSL に慣れが必要	基本的な Rails ビューと同等

選択指針：共通レスポンスや入れ子構造が頻繁に出る中規模以上の API では AMS、シンプル CRUD のみであれば Jbuilder が手軽です。

AMS のシンプル実装例

Gemfile に AMS を追加し、シリアライザを生成します。

# Gemfile
gem 'active_model_serializers', '~&gt; 0.14.0'

# Gemfile

gem 'active_model_serializers', '~> 0.14.0'

rails g serializer todo

1 2	rails g serializer todo

生成された app/serializers/todo_serializer.rb は次のようになります。

class TodoSerializer &lt; ActiveModel::Serializer
  attributes :id, :title, :completed, :created_at, :updated_at
  belongs_to :user, serializer: UserSerializer   # 必要に応じてネスト
end

class TodoSerializer < ActiveModel::Serializer

attributes :id, :title, :completed, :created_at, :updated_at

belongs_to :user, serializer: UserSerializer # 必要に応じてネスト

end

コントローラ側では render json: だけで自動的に適用されます。

module Api::V1
  class TodosController &lt; BaseController
    def index
      render json: Todo.all
    end

    def show
      render json: Todo.find(params[:id])
    end
  end
end

module Api::V1

class TodosController < BaseController

def index

render json: Todo.all

end

def show

render json: Todo.find(params[:id])

end

Jbuilder の基本例

Jbuilder は Rails に標準同梱されているため追加依存がありません。テンプレートは app/views/api/v1/todos/index.json.jbuilder に作成します。

# app/views/api/v1/todos/index.json.jbuilder
json.array! @todos do |todo|
  json.id        todo.id
  json.title     todo.title
  json.completed todo.completed
  json.created_at todo.created_at.iso8601
  json.updated_at todo.updated_at.iso8601

  json.user do
    json.id   todo.user.id
    json.name todo.user.name
  end
end

# app/views/api/v1/todos/index.json.jbuilder

json.array! @todos do |todo|

json.id todo.id

json.title todo.title

json.completed todo.completed

json.created_at todo.created_at.iso8601

json.updated_at todo.updated_at.iso8601

json.user do

json.id todo.user.id

json.name todo.user.name

end

コントローラはインスタンス変数を設定して render するだけです。

def index
  @todos = Todo.includes(:user).all
  render :index
end

def index

@todos = Todo.includes(:user).all

render :index

end

認証・テスト・デプロイの実践フロー

本番レベルの API に求められるトークン認証、テスト自動化、Docker 化と CI/CD の流れを具体例で示します。JWT を手書きするパターンと devise_token_auth で簡易化するパターンの両方を紹介します。

カスタム JWT 実装（自前実装）

まずは JWT 用 gem を追加し、認証ロジックとトークンサービスクラスを作ります。

# Gemfile
gem 'jwt'

# Gemfile

gem 'jwt'

認証コントローラ例

module Api::V1
  class AuthenticationController &lt; BaseController
    skip_before_action :authenticate_user!, only: %i[login]

    def login
      user = User.find_by(email: params[:email])
      if user&amp;.valid_password?(params[:password])
        token = JwtService.encode(user_id: user.id)
        render json: { token: token }, status: :ok
      else
        render json: { error: 'Invalid credentials' }, status: :unauthorized
      end
    end

    def refresh
      payload   = JwtService.decode(request.headers['Authorization'].split.last)
      new_token = JwtService.encode(user_id: payload[:user_id])
      render json: { token: new_token }
    rescue JWT::DecodeError
      render json: { error: 'Invalid token' }, status: :unauthorized
    end
  end
end

module Api::V1

class AuthenticationController < BaseController

skip_before_action :authenticate_user!, only: %i[login]

def login

user = User.find_by(email: params[:email])

if user&.valid_password?(params[:password])

token = JwtService.encode(user_id: user.id)

render json: { token: token }, status: :ok

else

render json: { error: 'Invalid credentials' }, status: :unauthorized

end

def refresh

payload = JwtService.decode(request.headers['Authorization'].split.last)

new_token = JwtService.encode(user_id: payload[:user_id])

render json: { token: new_token }

rescue JWT::DecodeError

render json: { error: 'Invalid token' }, status: :unauthorized

end

JwtService 実装

# app/services/jwt_service.rb
class JwtService
  HMAC_SECRET = Rails.application.credentials.jwt_secret
  EXPIRATION_TIME = 24.hours.from_now.to_i

  def self.encode(payload)
    payload[:exp] = EXPIRATION_TIME
    JWT.encode(payload, HMAC_SECRET)
  end

  def self.decode(token)
    decoded = JWT.decode(token, HMAC_SECRET).first
    HashWithIndifferentAccess.new(decoded)
  end
end

# app/services/jwt_service.rb

class JwtService

HMAC_SECRET = Rails.application.credentials.jwt_secret

EXPIRATION_TIME = 24.hours.from_now.to_i

def self.encode(payload)

payload[:exp] = EXPIRATION_TIME

JWT.encode(payload, HMAC_SECRET)

end

def self.decode(token)

decoded = JWT.decode(token, HMAC_SECRET).first

HashWithIndifferentAccess.new(decoded)

end

BaseController に認証フィルタを追加

def authenticate_user!
  header = request.headers['Authorization']
  token  = header.split.last if header.present?
  decoded = JwtService.decode(token)
  @current_user = User.find(decoded[:user_id])
rescue JWT::DecodeError, ActiveRecord::RecordNotFound
  render json: { error: 'Unauthorized' }, status: :unauthorized
end

def authenticate_user!

header = request.headers['Authorization']

token = header.split.last if header.present?

decoded = JwtService.decode(token)

@current_user = User.find(decoded[:user_id])

rescue JWT::DecodeError, ActiveRecord::RecordNotFound

render json: { error: 'Unauthorized' }, status: :unauthorized

end

`devise_token_auth` を利用する場合

認証を外部ライブラリに委託したいときは以下の手順でセットアップします。

# Gemfile
gem 'devise'
gem 'devise_token_auth'

# Gemfile

gem 'devise'

gem 'devise_token_auth'

rails generate devise:install
rails generate devise User
rails generate devise_token_auth:install User auth
rails db:migrate

rails generate devise:install

rails generate devise User

rails generate devise_token_auth:install User auth

rails db:migrate

生成されたエンドポイントは次の通りです。

メソッド	パス	内容
POST	`/auth`	ユーザー登録
POST	`/auth/sign_in`	ログイン（トークン発行）
DELETE	`/auth/sign_out`	ログアウト

この方法はセッション管理・トークンリフレッシュまで自動処理してくれるため、実装コストが大幅に削減できます。

RSpec と FactoryBot による API エンドポイントテスト例

テスト用 gem を追加し、認証付きリクエストスペックを作成します。

# Gemfile (test group)
group :test do
  gem 'rspec-rails'
  gem 'factory_bot_rails'
  gem 'database_cleaner-active_record'
end

# Gemfile (test group)

group :test do

gem 'rspec-rails'

gem 'factory_bot_rails'

gem 'database_cleaner-active_record'

end

リクエストスペック

# spec/requests/api/v1/todos_spec.rb
require 'rails_helper'

RSpec.describe &quot;Todos API&quot;, type: :request do
  let(:user)    { create(:user) }
  let(:headers) {
    token = JwtService.encode(user_id: user.id)
    { 'Authorization' =&gt; &quot;Bearer #{token}&quot;, 'Content-Type' =&gt; 'application/json' }
  }

  describe &quot;GET /api/v1/todos&quot; do
    before { create_list(:todo, 3, user: user) }

    it &quot;returns all todos of the authenticated user&quot; do
      get '/api/v1/todos', headers: headers
      expect(response).to have_http_status(:ok)
      json = JSON.parse(response.body)
      expect(json.size).to eq(3)
    end
  end
end

# spec/requests/api/v1/todos_spec.rb

require 'rails_helper'

RSpec.describe "Todos API", type: :request do

let(:user) { create(:user) }

let(:headers) {

token = JwtService.encode(user_id: user.id)

{ 'Authorization' => "Bearer #{token}", 'Content-Type' => 'application/json' }

}

describe "GET /api/v1/todos" do

before { create_list(:todo, 3, user: user) }

it "returns all todos of the authenticated user" do

get '/api/v1/todos', headers: headers

expect(response).to have_http_status(:ok)

json = JSON.parse(response.body)

expect(json.size).to eq(3)

end

FactoryBot 定義例

# spec/factories/users.rb
FactoryBot.define do
  factory :user do
    email    { Faker::Internet.unique.email }
    password { 'password123' }
  end
end

# spec/factories/todos.rb
FactoryBot.define do
  factory :todo do
    title     { Faker::Lorem.sentence }
    completed { false }
    association :user
  end
end

# spec/factories/users.rb

FactoryBot.define do

factory :user do

email { Faker::Internet.unique.email }

password { 'password123' }

end

# spec/factories/todos.rb

FactoryBot.define do

factory :todo do

title { Faker::Lorem.sentence }

completed { false }

association :user

end

テストは bundle exec rspec で実行し、CI パイプラインに組み込めばコードプッシュ時に自動検証が走ります。

Docker 化と GitHub Actions による CI/CD 構成

本番デプロイを自動化するための最小構成として Dockerfile、docker‑compose、GitHub Actions ワークフローを提示します。

Dockerfile（production 用）

# ---- ベースイメージ ----
FROM ruby:3.2-slim

# 必要パッケージインストール
RUN apt-get update -qq &amp;&amp; \
    apt-get install -y build-essential libpq-dev nodejs &amp;&amp; \
    rm -rf /var/lib/apt/lists/*

WORKDIR /app
COPY Gemfile* ./
RUN bundle config set --local without 'development test' &amp;&amp; \
    bundle install --jobs 4 --retry 3

COPY . .

ENV RAILS_ENV=production
EXPOSE 3000
CMD [&quot;rails&quot;, &quot;server&quot;, &quot;-b&quot;, &quot;0.0.0.0&quot;]

# ---- ベースイメージ ----

FROM ruby:3.2-slim

# 必要パッケージインストール

RUN apt-get update -qq && \

apt-get install -y build-essential libpq-dev nodejs && \

rm -rf /var/lib/apt/lists/*

WORKDIR /app

COPY Gemfile* ./

RUN bundle config set --local without 'development test' && \

bundle install --jobs 4 --retry 3

COPY . .

ENV RAILS_ENV=production

EXPOSE 3000

CMD ["rails", "server", "-b", "0.0.0.0"]

docker‑compose（開発・テスト環境）

version: '3.8'
services:
  db:
    image: postgres:15-alpine
    environment:
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: password
      POSTGRES_DB: my_api_development
    volumes:
      - pg_data:/var/lib/postgresql/data

  web:
    build: .
    command: bundle exec rails s -p 3000 -b '0.0.0.0'
    environment:
      DATABASE_URL: postgres://postgres:password@db:5432/my_api_development
      RAILS_MASTER_KEY: ${RAILS_MASTER_KEY}
    ports:
      - &quot;3000:3000&quot;
    depends_on:
      - db

volumes:
  pg_data:

version: '3.8'

services:

db:

image: postgres:15-alpine

environment:

POSTGRES_USER: postgres

POSTGRES_PASSWORD: password

POSTGRES_DB: my_api_development

volumes:

- pg_data:/var/lib/postgresql/data

web:

build: .

command: bundle exec rails s -p 3000 -b '0.0.0.0'

environment:

DATABASE_URL: postgres://postgres:password@db:5432/my_api_development

RAILS_MASTER_KEY: ${RAILS_MASTER_KEY}

ports:

- "3000:3000"

depends_on:

- db

volumes:

pg_data:

GitHub Actions（CI／CD）概要

name: CI

on:
  push:
    branches: [ main ]
  pull_request:

jobs:
  test:
    runs-on: ubuntu-latest
    services:
      postgres:
        image: postgres:15-alpine
        env:
          POSTGRES_USER: postgres
          POSTGRES_PASSWORD: password
          POSTGRES_DB: my_api_test
        ports: ['5432:5432']
        options: &gt;-
          --health-cmd &quot;pg_isready&quot;
          --health-interval 10s
          --health-timeout 5s
          --health-retries 5

    steps:
      - uses: actions/checkout@v3
      - name: Set up Ruby
        uses: ruby/setup-ruby@v1
        with:
          ruby-version: '3.2'
      - name: Install dependencies
        run: |
          gem install bundler
          bundle config set without 'development'
          bundle install --jobs 4 --retry 3
      - name: Prepare DB
        env:
          RAILS_ENV: test
          DATABASE_URL: postgres://postgres:password@localhost:5432/my_api_test
        run: |
          bin/rails db:create db:schema:load
      - name: Run RSpec
        run: bundle exec rspec

  deploy:
    needs: test
    runs-on: ubuntu-latest
    if: github.ref == 'refs/heads/main'
    steps:
      - uses: actions/checkout@v3
      - name: Build &amp; push Docker image
        uses: docker/build-push-action@v5
        with:
          context: .
          push: true
          tags: ghcr.io/${{ github.repository }}:latest

name: CI

on:

push:

branches: [ main ]

pull_request:

jobs:

test:

runs-on: ubuntu-latest

services:

postgres:

image: postgres:15-alpine

env:

POSTGRES_USER: postgres

POSTGRES_PASSWORD: password

POSTGRES_DB: my_api_test

ports: ['5432:5432']

options: >-

--health-cmd "pg_isready"

--health-interval 10s

--health-timeout 5s

--health-retries 5

steps:

- uses: actions/checkout@v3

- name: Set up Ruby

uses: ruby/setup-ruby@v1

with:

ruby-version: '3.2'

- name: Install dependencies

run: |

gem install bundler

bundle config set without 'development'

bundle install --jobs 4 --retry 3

- name: Prepare DB

env:

RAILS_ENV: test

DATABASE_URL: postgres://postgres:password@localhost:5432/my_api_test

run: |

bin/rails db:create db:schema:load

- name: Run RSpec

run: bundle exec rspec

deploy:

needs: test

runs-on: ubuntu-latest

if: github.ref == 'refs/heads/main'

steps:

- uses: actions/checkout@v3

- name: Build & push Docker image

uses: docker/build-push-action@v5

with:

context: .

push: true

tags: ghcr.io/${{ github.repository }}:latest

このワークフローはプッシュ時にテストを実行し、全テストが成功したら Docker イメージをビルド・プッシュします。Render、Fly.io などの PaaS にデプロイすれば、本番環境へ自動的に反映できます。

まとめ

rails new my_api --api で最小構成の API アプリが即座に生成でき、Rails 7.1 では hotwire-rails が除外される点を意識すれば不要な設定は省けます。
本番環境では CORS (rack-cors) とレートリミット (rack-attack) を追加し、HTTPS は force_ssl + HSTS で強制します。
名前空間 (Api::V1) と namespace :api ルーティングを採用すればバージョニングと保守性が向上します。
JSON の生成は AMS（再利用性重視）か Jbuilder（シンプルさ重視）のどちらでも実装可能です。
認証は自前 JWT で柔軟に、または devise_token_auth で迅速に構築できます。
RSpec + FactoryBot によるテストと Docker + GitHub Actions の CI/CD パイプラインを整えることで、コード品質とデプロイの安全性が確保されます。

これらの手順を踏めば、Rails 7 API モードで本番レベルのバックエンドサービスを短時間で構築・運用できるようになります。次は実際に「Todo API」サンプルを作成し、GitHub に公開してみましょう！

スポンサードリンク

-RubyonRails

comment コメントをキャンセル

: RubyonRails

Rails 8 と Rails 7.3 の比較と導入ガイド – No‑Build・No‑Redis 時代の全体像

Rails 8 は外部依存とデプロイ工程を削減する No‑Build・No‑Redis コンセプトを採用し、Ruby 3.2 の FiberScheduler と連携して I/O 処理を高速化します。

: RubyonRails

2026年Ruby on Railsエンジニア市場の現状と需要動向

2026年現在、Ruby on Railsエンジニアの需要はスタートアップやWeb企業を中心に継続。技術スタックの多様化の中でも開発スピードと保守性が重視され、経験年数に応じた年収相場やフリーランス市場の現状も解説。

2026年Ruby on Railsエンジニア市場の現状と需要動向

DeNAのKaggle社内ランク制度とAI人材育成戦略

Rails 7 APIモードで本番レベルのTodo APIを作る手順

Rails 7 API モードのセットアップ

Rails のインストールと --api オプションの意味

Zeitwerk と Hotwire の取り扱い（Rails 7.1 の変更点）

本番環境で必要なミドルウェアと CORS／HTTPS 設定

デフォルトで除外されるミドルウェア一覧

rack‑cors と rack‑attack の導入手順

production.rb における HTTPS 強制設定例

API 用コントローラと名前空間ルーティングの設計

名前空間ディレクトリと BaseController の作成

ルーティングベストプラクティス

JSON シリアライザの選択肢と実装例

AMS と Jbuilder の比較表

AMS のシンプル実装例

Jbuilder の基本例

認証・テスト・デプロイの実践フロー

カスタム JWT 実装（自前実装）

認証コントローラ例

JwtService 実装

BaseController に認証フィルタを追加

devise_token_auth を利用する場合

RSpec と FactoryBot による API エンドポイントテスト例

リクエストスペック

FactoryBot 定義例

Docker 化と GitHub Actions による CI/CD 構成

Dockerfile（production 用）

docker‑compose（開発・テスト環境）

GitHub Actions（CI／CD）概要

まとめ

Rails 7 API モードのセットアップ

Rails のインストールと `--api` オプションの意味

Zeitwerk と Hotwire の取り扱い（Rails 7.1 の変更点）

`devise_token_auth` を利用する場合