Ubuntu 24.04にRabbitMQ Serverをインストール・設定する完全ガイド:高負荷対応メッセージブローカーの構築とWeb UIによるキュー管理

Ubuntu tutorial - IT technology blog
Ubuntu tutorial - IT technology blog

あるECサイトの注文処理システムが、ピーク時間帯になると突然重くなる——サーバーのスペックが低いせいではなく、各サービスが互いに直接呼び合っているのが原因だ。Payment serviceはinventory serviceを待ち、inventory serviceはemail serviceを待つ……どこか一つが詰まれば、連鎖全体が止まる。RabbitMQはまさにその問題を解決する:直接呼び出す代わりに、メッセージをキューに積んで、処理できる側が取り出して実行する仕組みだ。

これまでUbuntu上でRabbitMQをさまざまなプロジェクトに導入してきた——1日数千メッセージを処理する小規模サービスから、ピーク時に80k+メッセージ/時を捌く決済パイプラインまで。以下の手順は実際に自分が使っているもので、形式だけのステップは一切ない。

5分でRabbitMQを起動する

Ubuntu 24.04でサクッとテスト環境が欲しいだけなら、これが最短の方法だ:

# ErlangとRabbitMQを公式リポジトリからインストール
curl -s https://packagecloud.io/install/repositories/rabbitmq/rabbitmq-server/script.deb.sh | sudo bash
sudo apt-get install -y rabbitmq-server

# 起動と自動起動を有効化
sudo systemctl enable --now rabbitmq-server

# Web Management UIを有効化
sudo rabbitmq-plugins enable rabbitmq_management

# adminユーザーを作成(本番環境ではパスワードを必ず変更すること)
sudo rabbitmqctl add_user admin StrongPass123!
sudo rabbitmqctl set_user_tags admin administrator
sudo rabbitmqctl set_permissions -p / admin ".*" ".*" ".*"

ブラウザで http://<IP-server>:15672 を開き、先ほど作成した admin ユーザーでログインする。ダッシュボードがすぐに使える。次のセクションでは各ステップとその理由を詳しく説明する。

正しいインストール方法——Ubuntuのデフォルトリポジトリは使わない

Ubuntu 24.04のaptには rabbitmq-server が含まれているが、upstreamより数バージョン遅れていることが多く、quorum queueやstreamの重要な改善が欠けている場合がある。RabbitMQチームの公式リポジトリを使えば、Erlang/OTPのバージョンが正確に一致する。

ステップ1:GPGキーとリポジトリを追加する

# 必要なツールをインストール
sudo apt-get update
sudo apt-get install -y curl gnupg apt-transport-https

# RabbitMQの署名キーを追加
curl -1sLf 'https://keys.openpgp.org/vks/v1/by-fingerprint/0A9AF2115F4687BD29803A206B73A36E6026DFCA' | sudo gpg --dearmor -o /usr/share/keyrings/com.rabbitmq.team.gpg

# Cloudsmith(ミラー)の署名キーを追加
curl -1sLf 'https://github.com/rabbitmq/signing-keys/releases/download/3.0/cloudsmith.rabbitmq-erlang.E495BB49CC4BBE5B.key' | sudo gpg --dearmor -o /usr/share/keyrings/rabbitmq.E495BB49CC4BBE5B.gpg
curl -1sLf 'https://github.com/rabbitmq/signing-keys/releases/download/3.0/cloudsmith.rabbitmq-server.9F4587F226208342.key' | sudo gpg --dearmor -o /usr/share/keyrings/rabbitmq.9F4587F226208342.gpg

# ErlangとRabbitMQのリポジトリを追加
sudo tee /etc/apt/sources.list.d/rabbitmq.list <<EOF
deb [arch=amd64 signed-by=/usr/share/keyrings/rabbitmq.E495BB49CC4BBE5B.gpg] https://ppa1.novemberain.com/rabbitmq/rabbitmq-erlang/deb/ubuntu noble main
deb [arch=amd64 signed-by=/usr/share/keyrings/rabbitmq.9F4587F226208342.gpg] https://ppa1.novemberain.com/rabbitmq/rabbitmq-server/deb/ubuntu noble main
EOF

sudo apt-get update

ステップ2:ErlangをインストールしてからRabbitMQをインストールする

# 先にErlangをインストール(RabbitMQ 3.13+対応バージョン)
sudo apt-get install -y erlang-base \
  erlang-asn1 erlang-crypto erlang-eldap erlang-ftp erlang-inets \
  erlang-mnesia erlang-os-mon erlang-parsetools erlang-public-key \
  erlang-runtime-tools erlang-snmp erlang-ssl erlang-syntax-tools \
  erlang-tftp erlang-tools erlang-xmerl

# 次にRabbitMQをインストール
sudo apt-get install -y rabbitmq-server

2つのコマンドに分けた理由:aptに任せると、追加したリポジトリではなくUbuntuのリポジトリからErlangを引っ張ってくることがある。Erlangを明示的に先にインストールしておけば、バージョン競合でRabbitMQが起動しないという問題を回避できる——最初にこれを踏んで2時間デバッグした経験がある。

ステップ3:サービスを確認する

sudo systemctl status rabbitmq-server
# 期待される結果: Active: active (running)

# ノードの詳細情報を表示
sudo rabbitmqctl status | head -30

セキュリティ設定——最初にやるべきこと

RabbitMQをインストールすると、デフォルトで guest ユーザー(パスワード:guest)が存在するが、localhost からのみログイン可能になっている。外部にポートを開放する前に、このユーザーを削除して独自のユーザーを作成すること。

# デフォルトのguestユーザーを削除
sudo rabbitmqctl delete_user guest

# アプリ専用のvhostを作成('myapp'はプロジェクト名に置き換えること)
sudo rabbitmqctl add_vhost myapp

# 制限付き権限でアプリ用ユーザーを作成
sudo rabbitmqctl add_user appuser SecretPass456!
sudo rabbitmqctl set_permissions -p myapp appuser ".*" ".*" ".*"

# Web UI管理用の専用adminユーザーを作成
sudo rabbitmqctl add_user admin AdminPass789!
sudo rabbitmqctl set_user_tags admin administrator
sudo rabbitmqctl set_permissions -p / admin ".*" ".*" ".*"
sudo rabbitmqctl set_permissions -p myapp admin ".*" ".*" ".*"

ファイアウォールの設定

# Port 5672: AMQP(アプリケーション接続用)
# Port 15672: Web Management UI
# 信頼できるIPのみ許可、不要であればパブリックには開放しない
sudo ufw allow from 192.168.1.0/24 to any port 5672
sudo ufw allow from YOUR_ADMIN_IP to any port 15672
sudo ufw reload

Web UIによる管理——思っている以上に強力

http://server:15672 を開くと、フル機能のダッシュボードがすぐに使える——キューの作成、ユーザー権限の設定、リアルタイムのメッセージレートの確認、ブラウザ上でのテストメッセージの直接パブリッシュまで。日常的なタスクのほとんどはターミナル不要だ:

  • Overview:メッセージレート、接続数、アクティブなチャンネルの全体概要
  • Queues:各キューの待機メッセージ数を確認、テスト用にメッセージを手動でパブリッシュ/コンシュームできる
  • Exchanges:exchangeとルーティングルールを管理
  • Admin:ユーザー・vhostの追加・削除、権限設定

Queues タブはデバッグ時に最初に開くべき場所だ——Ready が増え続けているのに Unacked が動かない場合は、consumerが死んでいるかブロックされている。

Pythonアプリケーションとの統合

pika を使った基本的なproducerとconsumer——新プロジェクト開始時に使うスケルトンだ:

pip install pika
import pika

# RabbitMQに接続
credentials = pika.PlainCredentials('appuser', 'SecretPass456!')
params = pika.ConnectionParameters(
    host='localhost',
    virtual_host='myapp',
    credentials=credentials
)
connection = pika.BlockingConnection(params)
channel = connection.channel()

# キューを宣言(存在しなければ自動作成)
channel.queue_declare(queue='orders', durable=True)

# メッセージを送信
channel.basic_publish(
    exchange='',
    routing_key='orders',
    body='Order #12345 - TシャツサイズL x2',
    properties=pika.BasicProperties(delivery_mode=2)  # 永続化
)
print('注文をキューに送信しました')
connection.close()
import pika

# Consumer — メッセージを受信して処理する
credentials = pika.PlainCredentials('appuser', 'SecretPass456!')
params = pika.ConnectionParameters(host='localhost', virtual_host='myapp', credentials=credentials)
connection = pika.BlockingConnection(params)
channel = connection.channel()

channel.queue_declare(queue='orders', durable=True)
channel.basic_qos(prefetch_count=1)  # 一度に1メッセージのみ受信

def process_order(ch, method, properties, body):
    print(f'処理中: {body.decode()}')
    # ... 注文処理のロジック ...
    ch.basic_ack(delivery_tag=method.delivery_tag)  # 処理完了を確認

channel.basic_consume(queue='orders', on_message_callback=process_order)
print('注文を待機中...')
channel.start_consuming()

delivery_mode=2 を指定して送信し、キュー宣言時に durable=True を設定すること:RabbitMQの再起動時にメッセージを失いたくなければ、この2つはセットで必須だ。どちらか一方でも欠けると、メッセージがすべて消える。

運用経験から学んだ実践的なTips

定期的な監視

# すべてのキューとメッセージ数を表示
sudo rabbitmqctl list_queues name messages consumers

# 接続中のコネクションを表示
sudo rabbitmqctl list_connections user vhost state

# メモリ使用量を確認(RAMの40%を超えたら要注意)
sudo rabbitmqctl status | grep -A5 memory

リソース制限の設定

/etc/rabbitmq/rabbitmq.conf ファイルを作成する:

# メモリ制限(デフォルトはRAMの40%、小規模サーバーでは下げること)
vm_memory_high_watermark.relative = 0.3

# ディスク制限(最低1GB空き、これを下回るとRabbitMQが自動でスロットリング)
disk_free_limit.absolute = 1GB

# ファイルディスクリプタの上限を増やす
handle_limit = 65536
sudo systemctl restart rabbitmq-server

Dead Letter Queueの処理

consumerが連続して失敗し、requeue=True で nack を使うと、メッセージは即座にキューの先頭に戻ってしまう——再受信、再失敗の繰り返しだ。このループは数秒でconsumerのCPUを食い尽くす。DLXがそれを防ぐ:壊れたメッセージは永遠にループする代わりに、専用のキューに転送される:

# DLXとエラーメッセージ用キューを宣言
channel.exchange_declare(exchange='dlx', exchange_type='direct')
channel.queue_declare(queue='orders.failed', durable=True)
channel.queue_bind(queue='orders.failed', exchange='dlx', routing_key='orders')

# メインキューにDLXをアタッチ
channel.queue_declare(
    queue='orders',
    durable=True,
    arguments={
        'x-dead-letter-exchange': 'dlx',
        'x-dead-letter-routing-key': 'orders'
    }
)

requeue=False で basic_nack されたメッセージは、消えてなくなる代わりに自動的に orders.failed に転送される。そこからWeb UIで確認し、デバッグして、手動で処理することができる。

設定のバックアップ

# 全設定をエクスポート:vhost、ユーザー、キュー、exchange、バインディング
sudo rabbitmqctl export_definitions /backup/rabbitmq-definitions.json

# 必要なときにリストア
sudo rabbitmqctl import_definitions /backup/rabbitmq-definitions.json

このexportコマンドはcronで毎晩自動実行している。ディスク障害でサーバーを再構築しなければならなかったとき——あのJSONファイルのおかげで午後を丸ごと設定作業から救われた。バックアップは2秒、しなかった場合の結末は言わずもがなだ。

Share: