Kamalを使ってRailsアプリを本番サーバーにデプロイする方法：複数アプリを1台のサーバーで運用

2 分で読めます

Kamalを使ってRailsアプリを本番サーバーにデプロイする

Kamal Deploy

Rails 8から標準のデプロイツールとなったKamalを使って、複数のRailsアプリケーションを1台のサーバーに本番デプロイする方法をまとめます。

従来のdocker-composeやPaaS（Renderなど）からの移行も含め、実際の構築経験をもとに解説します。

Kamalとは

Kamalは、Dockerコンテナを使ったゼロダウンタイムデプロイツールです。37signals（Basecamp）が開発し、Rails 8からデフォルトのデプロイツールとして採用されました。

従来の方法との比較

項目	docker-compose	PaaS (Render等)	Kamal
デプロイ元	サーバー上で直接操作	Git push	ローカルからコマンド1つ
SSL	手動設定 (nginx等)	自動	自動 (kamal-proxy)
ゼロダウンタイム	手動対応	対応	標準対応
複数アプリ	手動設定	アプリごとに課金	1台で複数運用可能
コスト	サーバー代のみ	従量課金	サーバー代のみ

前提条件

ローカル: macOS、Docker Desktop、Ruby 3.4+
サーバー: Ubuntu 24.04、Docker インストール済み
Docker Hubアカウント
SSHでサーバーにアクセス可能

1. Kamalのインストール

RailsプロジェクトのGemfileにKamalが含まれていない場合：

gem install kamal

バージョン確認：

kamal version
# => 2.11.0

また、ローカルにDocker Buildxプラグインが必要です：

brew install docker-buildx

~/.docker/config.jsonにプラグインパスを追加：

{
  "cliPluginsExtraDirs": [
    "/opt/homebrew/lib/docker/cli-plugins"
  ]
}

2. サーバーの準備

システムアカウントの作成

アプリごとに専用のシステムアカウントを作成し、Dockerグループに追加します：

# サーバー上で実行
sudo useradd -r -m -s /bin/bash myapp
sudo usermod -aG docker myapp

# SSH鍵を設定
sudo mkdir -p /home/myapp/.ssh
sudo cp ~/.ssh/authorized_keys /home/myapp/.ssh/
sudo chown -R myapp:myapp /home/myapp/.ssh
sudo chmod 700 /home/myapp/.ssh

ポイント: アカウントのUIDは2000以上を推奨します。PostgreSQLコンテナ内部のpostgresユーザー（UID 999）とのUID衝突を避けるためです。

sudo usermod -u 2001 myapp
sudo groupmod -g 2001 myapp
sudo chown -R myapp:myapp /home/myapp

3. Kamalの設定

config/deploy.yml

service: myapp

image: your-dockerhub-user/myapp

servers:
  web:
    - 192.168.x.x

proxy:
  ssl: false  # 内部ネットワークの場合
  host: myapp.example.com

registry:
  username: your-dockerhub-user
  password:
    - KAMAL_REGISTRY_PASSWORD

env:
  secret:
    - RAILS_MASTER_KEY
    - DATABASE_PASSWORD
  clear:
    SOLID_QUEUE_IN_PUMA: true
    DB_HOST: myapp-db

volumes:
  - "myapp_storage:/rails/storage"

asset_path: /rails/public/assets

builder:
  arch: amd64

ssh:
  user: myapp  # 先ほど作成したアカウント

accessories:
  db:
    image: postgres:17
    host: 192.168.x.x
    port: "127.0.0.1:5432:5432"
    env:
      clear:
        POSTGRES_USER: myapp
        POSTGRES_DB: myapp_production
      secret:
        - POSTGRES_PASSWORD
    volumes:
      - myapp_postgres_data:/var/lib/postgresql/data

.kamal/secrets

KAMAL_REGISTRY_PASSWORD=$KAMAL_REGISTRY_PASSWORD
RAILS_MASTER_KEY=$(cat config/master.key)
DATABASE_PASSWORD=your_secure_password
POSTGRES_PASSWORD=your_secure_password

重要: .kamal/secretsは必ず.gitignoreに追加してください。平文のシークレットが含まれるため、Gitにコミットしてはいけません。

# .gitignore に追加
/.kamal/secrets

database.yml（production）

production:
  primary: &primary_production
    <<: *default
    database: myapp_production
    username: myapp
    password: <%= ENV["DATABASE_PASSWORD"] %>
    host: <%= ENV.fetch("DB_HOST", "localhost") %>

DB_HOSTのデフォルト値をlocalhostにすることで、ローカル開発とDocker環境の両方に対応できます。

4. Dockerビルド時の注意点

ENV.fetchのエラー回避

Dockerビルド中のassets:precompileステップでは環境変数が存在しません。ENV.fetchを使う初期化ファイル（SMTP設定など）は、環境変数の存在チェックを入れてください：

# config/initializers/smtp.rb
if ENV["SMTP_HOST"].present?
  Rails.application.config.action_mailer.smtp_settings = {
    address: ENV.fetch("SMTP_HOST"),
    port: ENV.fetch("SMTP_PORT").to_i,
    # ...
  }
end

force_sslの設定

SSL終端をKamal proxyやCloudflareに任せる場合、Railsのforce_sslは無効にします：

# config/environments/production.rb
config.assume_ssl = false
config.force_ssl = false

5. デプロイの実行

初回デプロイ（setup）

KAMAL_REGISTRY_PASSWORD=your_token kamal setup

kamal setupは以下を自動実行します：

サーバーにDockerがインストールされているか確認
kamal-proxyコンテナを起動
Dockerイメージをビルド＆Docker Hubにプッシュ
PostgreSQLアクセサリーを起動
アプリコンテナを起動＆ヘルスチェック

2回目以降のデプロイ

KAMAL_REGISTRY_PASSWORD=your_token kamal deploy

データベースのシード

KAMAL_REGISTRY_PASSWORD=your_token kamal app exec "bin/rails db:seed"

6. 複数アプリの運用

Kamalのkamal-proxyは、Hostヘッダーベースでリクエストをルーティングします。nginxは不要です。

クライアント → kamal-proxy (ポート80)
                ├─ Host: app1.example.com → app1コンテナ
                ├─ Host: app2.example.com → app2コンテナ
                └─ Host: app3.example.com → app3コンテナ

各アプリのdeploy.ymlで異なるproxy.hostを設定するだけで、1台のサーバーで複数アプリを運用できます。

ポート番号の管理

複数のPostgreSQLアクセサリーを使う場合、ホストポートを分けます：

アプリ	内部ポート	ホストポート
app1-db	5432	5432
app2-db	5432	5433
app3-db	5432	5434

アプリコンテナはDockerネットワーク内でコンテナ名（例：app1-db）で接続するため、内部ポート5432を使います。ホストポートは外部からの直接接続用です。

7. Solid Queue/Cache/Cable の対応

Rails 8のSolid Queue、Solid Cache、Solid Cableを使う場合、別データベースが必要です。

init-db.sqlで追加データベースを作成

CREATE DATABASE myapp_production_cache OWNER myapp;
CREATE DATABASE myapp_production_queue OWNER myapp;
CREATE DATABASE myapp_production_cable OWNER myapp;

deploy.ymlのアクセサリー設定で、このファイルをマウントします：

accessories:
  db:
    files:
      - config/init-db.sql:/docker-entrypoint-initdb.d/init-db.sql

docker-entrypointの修正

デフォルトのdb:prepareは主データベースのみ処理します。全データベースを処理するには：

# bin/docker-entrypoint
if [ "${@: -2:1}" == "./bin/rails" ] && [ "${@: -1:1}" == "server" ]; then
  ./bin/rails runner 'ActiveRecord::Tasks::DatabaseTasks.prepare_all'
fi

8. サーバー再起動時の自動復旧

Kamalは全コンテナにrestart: unless-stoppedポリシーを設定します。Dockerサービスがenabledであれば、サーバー再起動後に自動的に全コンテナが起動します。

# 確認
sudo systemctl is-enabled docker
# => enabled

9. トラブルシューティング

コンテナのログ確認

kamal app logs -f

コンテナ内でコマンド実行

kamal app exec "bin/rails console"
kamal app exec "bin/rails db:migrate"

ヘルスチェック失敗時

デプロイ時に「target failed to become healthy」エラーが出る場合：

kamal app logsでエラー内容を確認
データベース接続エラー → DB_HOST環境変数を確認
Solid Queueテーブル不足 → docker-entrypointでprepare_allを使用

まとめ

Kamalを使えば、docker-composeの複雑さやPaaSのコストを避けつつ、ローカルからコマンド1つで本番デプロイが可能です。

kamal-proxyがnginxの代わりにリバースプロキシ・SSL・ルーティングを担当
アプリごとのシステムアカウントでセキュリティを確保
Docker Hubを経由してイメージを管理（無料プランではPublicリポジトリを活用）
サーバー再起動後も自動復旧

特に複数のRailsアプリを1台のサーバーで運用したい場合、Kamalは非常に効率的な選択肢です。

この記事は、実際に3つのRailsアプリケーション（CRM、見積システム、ホスティング管理）を1台のUbuntu 24.04サーバーにKamalでデプロイした経験をもとに執筆しました。

X Facebook LinkedIn Bluesky

TOYO Dev Team