MongoDBのレプリカセットは、同じデータを持つ複数のmongodで1つのデータベースを構成し、プライマリが止まっても残りのメンバーから新しいプライマリを選び直す仕組みです。この記事では、2026年11月時点の現行安定版である9.0系を前提に、Docker Composeで3ノードを起動してrs.initiateで初期化する手順、本番サーバーでのmongod.confとkeyFileの設定、プライマリを止めて選出を確かめる方法を順に示します。後半では、write concern・read concern・read preferenceの設定例と、アービターを入れた構成を避ける理由を扱います。
まとめ:MongoDBレプリカセットを組む前に決める構成と設定値の結論
構成は、データを持つメンバー3台(プライマリ1台とセカンダリ2台)にします。公式の構築手順も3台と奇数の台数を推奨しており、アービターを加えた「プライマリ・セカンダリ・アービター」の3台構成は、セカンダリが1台止まっただけでmajority書き込みが完了しなくなる弱点を抱えます。
初期化は、すべてのmongodを --replSet 付きで起動してから、1台だけで rs.initiate() を1回実行します。ホストはIPアドレスでなくDNS名で書き、メンバー間の通信にはkeyFileかX.509証明書で内部認証を掛けます。
アプリ側は、接続文字列に全メンバーと replicaSet を書きます。書き込みは既定の w: "majority" のまま使い、セカンダリから読む対象は、古いデータを許せる集計などに限定する方針です。選出中の約12秒は書き込みが止まる前提で、エラー処理を用意します。
MongoDBレプリカセットとは:プライマリと選出の仕組みと9.0系の前提
プライマリ1台とセカンダリ2台の役割分担と、oplogで複製される流れ
公式のレプリケーション解説によれば、データを持つメンバーのうちプライマリは1台だけで、すべての書き込みを受け付けます。セカンダリはプライマリのoplog(操作ログ)を複製し、自分のデータに非同期で適用します。
非同期である以上、セカンダリから読んだ値はプライマリより古いことがあります。この性質をどこまで許すかが、後半で扱うread preferenceとread concernの設定を決める判断軸です。同期・非同期の違いをDB横断で整理した内容はデータベースレプリケーションとは?同期・非同期の違いとレプリカ遅延の設計にまとめています。
選出が起きる4つの契機と、新プライマリ決定まで約12秒という目安
選出の公式ページが挙げる契機は、メンバーの追加、rs.initiate() による初期化、rs.stepDown() や rs.reconfig() による保守、そしてセカンダリがプライマリと連絡できない状態が既定10秒(settings.electionTimeoutMillis)を超えた場合の4つです。
メンバーは2秒ごとにハートビートを送り合い、10秒応答が無い相手を到達不能とみなします。既定の設定なら、プライマリの停止を検知して新しいプライマリが決まるまでの中央値は通常12秒を超えないと公式は説明しています。この間、書き込みは受け付けられません。
メンバーは最大50台、そのうち投票できるのは7台までです。選出に勝てるのは、見えているメンバーの中で最新の操作時刻(optime)を持つメンバーに限られます。過半数の投票メンバーと通信できなくなったプライマリは、自分からセカンダリへ降ります。2台構成で1台が止まると過半数を作れず、残った1台もプライマリになれません。
アービターを入れるPSA構成を避ける理由:majority書き込みが詰まる条件
アービターはデータを持たず、投票だけをするメンバーです。write concernの公式ページには、プライマリ・セカンダリ・アービター(PSA)の構成で、データを持つ投票メンバーが1台止まると "majority" の書き込みがタイムアウトするか確認されない可能性があると書かれています。
理由は過半数の計算にあります。majorityは「全投票メンバーの過半数」と「データを持つ投票メンバー数」の小さいほうで決まり、PSAではどちらも2です。セカンダリが止まると、確認できるのはプライマリ1台だけになります。
公式は、PSAのように非アービターが投票の過半数以下の構成では、暗黙の既定write concernを w: 1 にする計算式も示しています。既定が変わるため、障害時にロールバックされる書き込みが生まれる構成です。アービターの公式ページも、アービターは1台までとし、データを持つメンバーと同じホストで動かさないよう求めています。新規構築ではアービターを使わず、データを持つ3台で組みます。
Docker Composeで3ノードのMongoDBレプリカセットを起動する手順
compose.yamlの全体:レプリカセット指定とヘルスチェックによる初期化
手元で選出やフェイルオーバーを試すなら、3つのコンテナで組むのが早道です。Docker Hubの公式イメージmongoでは、2026年11月12日に9.0.8のタグが更新されています。次のcompose.yamlは、3台を別ポートで起動し、mongo1のhealthcheckで未初期化なら rs.initiate() を実行します。
services:
mongo1:
image: mongo:9.0
command: ["--replSet", "rs0", "--bind_ip_all", "--port", "27017"]
ports: ["127.0.0.1:27017:27017"]
volumes: ["mongo1-data:/data/db"]
healthcheck:
test:
- CMD
- mongosh
- --port
- "27017"
- --quiet
- --eval
- >-
try { rs.status().ok } catch (e) {
rs.initiate({ _id: "rs0", members: [
{ _id: 0, host: "mongo1:27017", priority: 2 },
{ _id: 1, host: "mongo2:27018" },
{ _id: 2, host: "mongo3:27019" } ] }).ok }
interval: 5s
timeout: 10s
retries: 30
mongo2:
image: mongo:9.0
command: ["--replSet", "rs0", "--bind_ip_all", "--port", "27018"]
ports: ["127.0.0.1:27018:27018"]
volumes: ["mongo2-data:/data/db"]
mongo3:
image: mongo:9.0
command: ["--replSet", "rs0", "--bind_ip_all", "--port", "27019"]
ports: ["127.0.0.1:27019:27019"]
volumes: ["mongo3-data:/data/db"]
volumes:
mongo1-data:
mongo2-data:
mongo3-data:
rs.status() は未初期化のときに例外を投げるため、catch側で一度だけ初期化が走ります。mongo2とmongo3がまだ起動していなければ rs.initiate() も失敗し、healthcheckの再試行で次の回に回ります。rs.initiate()のリファレンスが求めるとおり、実行するのは1つのmongodだけです。
この例は認証を掛けていません。ポートを 127.0.0.1 にだけ公開しているのはそのためで、社内LANから届く形にはしないでください。認証を掛けたまま単一ノードのレプリカセットを組む場合はkeyFileが必須になるので、MongoDBをDockerで構築する手順(compose・永続化・認証・初期化スクリプト)を参照してください。
ホスト側から繋ぐための名前解決と、directConnection=trueを使う場面
レプリカセットのメンバー名は mongo1:27017 のようなコンテナ名です。ドライバは最初に繋いだメンバーからこの名前の一覧を受け取り、改めて各メンバーへ接続します。ホストOSがmongo1という名前を引けないと、接続文字列にlocalhostと書いても接続は失敗するため、各メンバーのコンテナ名をホストOSから解決できるよう、名前解決の設定が必要です。ホストのhostsファイルに次の1行を足します。
# Linux・macOSは /etc/hosts、Windowsは C:\Windows\System32\drivers\etc\hosts
127.0.0.1 mongo1 mongo2 mongo3
# アプリやmongoshからの接続文字列
mongodb://mongo1:27017,mongo2:27018,mongo3:27019/?replicaSet=rs0
3台を別ポートにしたのは、ホストから見たときに同じ127.0.0.1上で区別するためです。全台を27017にすると、ホスト側では1台にしか届きません。
hostsを触れない環境では、接続文字列オプションの公式ページにある directConnection=true を使います。指定した1台だけに繋ぎ、他のメンバーを探しに行かない設定で、公式もテスト・開発用途に限っています。この接続ではフェイルオーバーを追えないので、切り替えの検証には使えません。
rs.status()とrs.conf():メンバーの状態と書き込み過半数の確認
起動後は、各メンバーの状態を一覧で出して確かめます。
docker compose up -d
docker compose exec mongo1 mongosh --quiet --eval '
rs.status().members.map(m => ({ name: m.name, state: m.stateStr, health: m.health }))'
# majority書き込みの確認に必要な台数と、選出のタイムアウト
docker compose exec mongo1 mongosh --quiet --eval 'rs.status().writeMajorityCount'
docker compose exec mongo1 mongosh --quiet --eval 'rs.conf().settings.electionTimeoutMillis'
正常なら、mongo1が PRIMARY、残り2台が SECONDARY になり、health はすべて1です。rs.status()のリファレンスにある writeMajorityCount は3台構成なら2で、majority書き込みの確認に何台が要るかを示します。electionTimeoutMillis は既定の10000です。STARTUP2 や RECOVERING のまま進まないメンバーがあれば、そのコンテナのログで名前解決の失敗を探します。
本番の初期設定:mongod.conf・keyFile・管理ユーザーと構成開始
mongod.confの構成名と待受IP:DNSホスト名でメンバーを指定する理由
本番では3台を別々のマシンに置き、電源とネットワークの経路も分けます。公式の構築手順では、各メンバーの設定ファイルに次の項目を書いて起動します。
# /etc/mongod.conf(db0の例。db1・db2はbindIpのホスト名だけ変える)
net:
port: 27017
bindIp: localhost,db0.example.net
replication:
replSetName: "rs0"
security:
keyFile: /etc/mongodb/keyfile
mongodは既定でlocalhostにしかバインドしないため、他のメンバーやアプリから届くよう bindIp に自分のホスト名を足します。メンバーの指定をIPアドレスにすると、アドレスが変わったときに構成の書き換えが必要です。公式は、5.0以降はIPアドレスだけで構成したノードが起動時の検証で失敗すると明記しており、DNS名を使う前提になっています。
keyFileで内部認証を有効にし、localhost例外で最初の管理ユーザーを作る
認証付きで構築する手順はkeyFile認証での構築ページにあります。鍵を作って全メンバーに同じものを置き、3台を起動してから1台目で初期化します。
# 鍵の作成(全メンバーに同じファイルをコピーする)
openssl rand -base64 756 > /etc/mongodb/keyfile
chmod 400 /etc/mongodb/keyfile
chown mongodb:mongodb /etc/mongodb/keyfile # RHEL系の実行ユーザーは mongod
# db0のmongoshで1回だけ実行する
rs.initiate({ _id: "rs0", members: [
{ _id: 0, host: "db0.example.net:27017" },
{ _id: 1, host: "db1.example.net:27017" },
{ _id: 2, host: "db2.example.net:27017" } ] })
# プライマリに繋いだまま、localhost例外で最初のユーザーを作る
db.getSiblingDB("admin").createUser({
user: "admin", pwd: passwordPrompt(),
roles: [ { role: "userAdminAnyDatabase", db: "admin" } ] })
keyFileを指定すると、メンバー間の内部認証と、ユーザーのロールによるアクセス制御が同時に有効になります。ユーザーが1人もいない間だけ、同じマシンのlocalhostから接続できる例外が働き、最初のユーザーを作った時点で、この例外による接続は終了です。レプリカセットの構成変更に使うユーザーには、続けて clusterAdmin ロールを付けます。
ただし公式はkeyFileをテスト・開発環境向けと位置づけ、本番ではX.509証明書を勧めています。
フェイルオーバーを手元で再現する:停止・rs.stepDown・priority変更
プライマリのコンテナを止めて、選出後のプライマリと書き込み再開を確かめる
Composeの環境で、プライマリのmongo1を止めます。残ったmongo2から状態を見ると、数秒から十数秒でどちらかが PRIMARY に変わります。
docker compose stop mongo1
docker compose exec mongo2 mongosh --port 27018 --quiet --eval '
rs.status().members.map(m => m.name + " " + m.stateStr)'
# 書き込みが新しいプライマリへ届くかを確かめる
mongosh "mongodb://mongo1:27017,mongo2:27018,mongo3:27019/?replicaSet=rs0" --quiet \
--eval 'db.getSiblingDB("shop").orders.insertOne({ orderNo: "F-0001", createdAt: new Date() })'
docker compose start mongo1
止めたmongo1は (not reachable/healthy) と表示されます。接続文字列に3台を並べていれば、mongoshは自動で新しいプライマリへ書き込みます。
mongo1を戻すと、セカンダリとして追いついた後、compose.yamlで付けた priority: 2 によって再びプライマリを取りにいきます。優先度の高いメンバーが選出を先に呼び、勝ちやすくなる動きで、選出の公式ページに書かれているとおりです。この切り戻しでも短い書き込み停止が起きます。
rs.stepDownで計画的に切り替える:書き込みが止まる最大20秒の内訳
OSの更新などで計画的にプライマリを替えるときは、止める前に降格させます。rs.stepDown()のリファレンスによれば、引数は降格後にプライマリへ戻らない秒数(既定60)と、セカンダリの追いつきを待つ秒数(既定10)です。
// プライマリで実行。120秒は再選出されず、追いつきを最大15秒待つ
rs.stepDown(120, 15)
追いついたセカンダリが待ち時間内に現れなければ、降格せずにエラーを返します。データを失う切り替えを防ぐための動きです。コマンドを受けてから新しいプライマリが決まるまで、プライマリへの書き込みはすべて失敗し、実行中のトランザクションは TransientTransactionError になります。公式が示す書き込み失敗の最大時間は、追いつき待ちの10秒と選出タイムアウトの10秒を足した20秒です。保守は書き込みの少ない時間帯に置きます。
priorityで選出順を指定:votesを保ちrs.reconfigで変更
バックアップ専用や集計専用のメンバーをプライマリにしたくない場合は、そのメンバーのpriorityを0にします。設定はプライマリで取得し、書き換えて戻します。
cfg = rs.conf()
cfg.members[2].priority = 0 // mongo3はプライマリにならない
rs.reconfig(cfg)
rs.conf().members.map(m => m.host + " priority=" + m.priority + " votes=" + m.votes)
選出の公式ページは、どのメンバーをプライマリにするかをvotesで操作せず、priorityで変えるよう求めています。votesを0にするのは、投票メンバーの上限7台を超えて台数を増やす場合などの例外です。votesが0のメンバーはpriorityも0にする決まりがあります。構成設定のリファレンスには、hidden や secondaryDelaySecs など、priority 0と組み合わせる設定も並んでいます。
write concern・read concern・読み取り先の設定と選択基準
既定のw:majorityとwtimeoutの挙動:時間切れでも書き込みは戻らない
write concernは、書き込みを何台に届けた時点で成功を返すかの指定です。公式ページによれば、暗黙の既定は w: "majority" で、過半数のデータ保持投票メンバーがoplogに書き込んだことを確かめてから応答します。PSA構成の例外は前述のとおりです。
// 操作ごとに指定する例
db.orders.insertOne(
{ orderNo: "A-1001", total: 12800 },
{ writeConcern: { w: "majority", wtimeout: 5000 } }
)
// クラスター全体の既定値を確かめる
db.adminCommand({ getDefaultRWConcern: 1 })
wtimeout の扱いには注意が要ります。指定した時間内に必要な台数へ届かなければエラーを返しますが、プライマリで成功した書き込みは取り消されません。エラーを受けたアプリは「書けなかった」と決めつけず、再読込みや冪等なキーで状態を確かめます。wtimeout を指定せず必要な台数がそろわない場合は、書き込みの待ち時間は無期限です。接続文字列の wtimeoutMS は非推奨になり、timeoutMS を使うよう案内されています。
トランザクションのコードとwrite concernの関係はNoSQLのトランザクション:MongoDBとDynamoDBで書く実装と使い分けで扱っています。
read concernのlocalとmajority:巻き戻るデータの読み取り回避
read concernの公式ページでは、プライマリとセカンダリへの読み取りの既定は "local" です。過半数に届いたかを問わず手元のデータを返すため、フェイルオーバーでロールバックされる書き込みを読んでしまう可能性があります。
// 過半数が確認したデータだけを読む
db.orders.find({ status: "paid" }).readConcern("majority")
決済の確定や在庫の引当など、読んだ値を根拠に次の書き込みをする処理は "majority" を使います。一覧画面の表示のように、数秒前の値で困らない読み取りは既定の "local" で十分です。直前の書き込みを自分の読み取りで必ず見たい場合は、因果整合性セッションと "majority" を組み合わせます。
readPreferenceでセカンダリへ読みを振るときの古いデータと90秒の下限
read preferenceの公式ページによれば、既定は primary で、それ以外の4つのモードはどれも古いデータを返す可能性があります。読み取りを含むトランザクションは primary でしか動きません。PyMongoで集計用の読み取りだけをセカンダリへ振るなら、次のように書けます。
from pymongo import MongoClient
from pymongo.read_preferences import SecondaryPreferred
client = MongoClient("mongodb://mongo1:27017,mongo2:27018,mongo3:27019/?replicaSet=rs0")
orders = client.shop.orders # 書き込みと通常の読み取りはプライマリ
report = client.get_database("shop", read_preference=SecondaryPreferred(max_staleness=120)).orders
print(list(report.aggregate([{"$group": {"_id": "$status", "n": {"$sum": 1}}}])))
max_staleness は、プライマリからの遅れがこの秒数を超えたセカンダリを読み取り先から外す設定です。接続文字列オプションの公式ページは下限を90秒としており、0〜90秒を指定するとエラーになります。数秒単位の鮮度が要る読み取りは、セカンダリではなくプライマリで行うしかありません。遅延を前提にした設計の考え方は結果整合性とは?強整合性との違いとレプリカ遅延の設計で詳しく説明しています。
運用で詰まる箇所:oplogのサイズとレプリカ遅延・アプリの接続文字列
oplogの既定サイズは空きディスクの5%:遅れたセカンダリが戻れる時間
oplogの公式ページによれば、WiredTigerの既定サイズは空きディスクの5%で、下限990MB、上限50GBです。止まっていたセカンダリが差分だけで追いつけるのは、oplogに残っている時間幅(oplogウィンドウ)の内側に戻った場合に限られます。外れると初期同期のやり直しになります。
// oplogのサイズと、最古から最新までの時間幅
rs.printReplicationInfo()
// 各セカンダリがプライマリから何秒遅れているか
rs.printSecondaryReplicationInfo()
// 再起動せずにoplogを16GBへ広げる(単位はMB)
db.adminCommand({ replSetResizeOplog: 1, size: 16384 })
夜間バッチで大量更新をする業務では、oplogウィンドウが短く縮み、週末に止めたセカンダリが月曜に戻れない事故が起きます。容量で決めにくいときは、設定ファイルの storage.oplogMinRetentionHours で最低保持時間を指定し、サイズが上限に達しても指定時間より新しい操作は消さないようにします。
接続文字列のreplicaSetとretryWrites:選出中の失敗への対処
アプリの接続文字列には、メンバーを1台ではなく全台並べ、replicaSet を付けます。1台だけを書くと、そのメンバーが止まったときに起動時の接続ができません。Atlasのように mongodb+srv:// が使える環境では、メンバーの増減に追従できるSRV形式を公式が勧めています。
mongodb://app:<password>@db0.example.net:27017,db1.example.net:27017,db2.example.net:27017/shop?replicaSet=rs0&authSource=admin&w=majority&retryWrites=true&timeoutMS=10000
公式ドライバの retryWrites は既定でtrueです。プライマリが落ちたことを検知すると、対象の書き込みを自動で再試行する回数は1回です。選出に12秒前後かかる間に再試行も失敗した場合はエラーがアプリに返るので、利用者に再操作を促すか、キューに積んで後で流す処理を用意します。MongoDB Compassの使い方で繋ぐ場合も、個々のメンバーではなくレプリカセット名を含む接続文字列を使います。
自前のレプリカセットを採用する条件と、Atlasなどへ任せる場面の判断
自前構築を選ぶ条件:閉域網・データ所在の制約とDB運用の担当者がいる場合
自前で組むのは、閉域網やオンプレミスにデータを置く必要がある場合、クラウド事業者の選定に制約がある場合で、かつ版の更新とバックアップを回せる担当者がいる場合です。レプリカセットは組んで終わりではありません。2026年11月にもMongoDB脆弱性CVE-2026-118383が公表され、レプリカセットでの対象判定と修正版への更新が必要になりました。セカンダリから1台ずつ更新し、最後に rs.stepDown() で降格させた旧プライマリを更新する手順を、平時に一度通しておきます。
既存の単体mongodをレプリカセットへ移す場合や、冗長構成と接続設計をまとめて見直したい場合は、一創のデータベース設計・移行支援でご相談を受けています。
見送る場面:2台構成・1台のホストへの3ノード同居・運用担当の不在
次の条件に当てはまるなら、自前のレプリカセットは組みません。
- 予算の都合で2台しか用意できない。1台が止まると過半数を作れず、残りの1台もプライマリになれないため、冗長化の意味がない
- 1台の物理ホストや1つの仮想マシンに3つのmongodを同居させる。ホストの障害で全メンバーが同時に止まる
- OSとMongoDBの更新、oplogとディスクの監視を担当する人がいない
この場合は、MongoDB Atlasとは?クラスタ階層・料金・セキュリティ設定と採用判断のようなマネージドサービスに任せます。AWS上に閉じたい事情があるなら、Amazon DocumentDBとは?MongoDB互換マネージドDBの仕組みも候補ですが、MongoDBとの互換範囲は事前に確かめます。
MongoDBレプリカセットのよくある質問:台数・移行・トランザクション
レプリカセットを組む前によく出る疑問を、公式ドキュメントの記述をもとにまとめます。
MongoDBのレプリカセットは2台で組めますか?
設定上は組めますが、1台止まると過半数を作れず、残った1台もプライマリになれないため冗長化になりません。データを持つ3台で組むのが公式の推奨です。3台目にアービターを置く方法もありますが、セカンダリ停止時にmajority書き込みが完了しなくなる制約が付きます。
単体で動いているMongoDBを後からレプリカセットにできますか?
後からレプリカセットへ変更することは可能です。単体からの変換手順では、mongodを停止し、設定ファイルに replication.replSetName を足して再起動し、引数なしの rs.initiate() の後に rs.add() でメンバーを足します。停止を伴うので、アプリの接続文字列の書き換えと合わせて作業時間を確保します。
トランザクションを使うにはレプリカセットが必要ですか?
必要です。公式のレプリケーション解説は、複数ドキュメントのトランザクションとChange Streamsをレプリカセットで使える機能と説明しています。単体のmongodで開発していると、本番で初めてトランザクションのエラーに気づくことがあります。開発環境もこの記事のCompose構成か、1ノードのレプリカセットにしておくと差が出ません。
セカンダリに直接書き込むことはできますか?
できません。レプリカセットで書き込みを受け付けるのはプライマリ1台だけで、セカンダリはプライマリのoplogを複製して適用します。書き込みの負荷を複数台へ分けたい場合は、レプリカセットではなくシャーディングの検討になります。
レプリカセットのメンバーは何台まで増やせますか?
選出の公式ページによれば、メンバーは最大50台、そのうち投票できるのは7台までです。8台目以降は votes: 0 と priority: 0 の非投票メンバーとして追加し、読み取り専用やバックアップ用に使います。
関連記事
- MongoDBとは?ドキュメント指向データベースの仕組み・利点・使い方入門:レプリカセットの前提になるMongoDBの構造と版の選び方
- データベースレプリケーションとは?同期・非同期の違いとレプリカ遅延の設計:DB横断で見たレプリケーションの方式
- NoSQLのトランザクション:MongoDBとDynamoDBで書く実装と使い分け:レプリカセットで動くトランザクションの書き方
- MongoDB Compassの使い方:接続・クエリ・集計・explainの手順:レプリカセットへの接続とデータの確認
- MongoDB Atlasとは?クラスタ階層・料金・セキュリティ設定と採用判断:レプリカセットの運用を任せる場合の選択肢