目錄
- 背景
- 啟動步驟
- 可能遇到的問題
- 解決辦法
背景
在開發(fā)中，我們很容易通過docker啟動一個(gè)普通的mongodb數(shù)據(jù)庫服務(wù)。但是有時(shí)候?yàn)榱吮３峙c線上環(huán)境一致，或者為了利用mongodb副本集的某些特性，我們需要在本地部署mongodb副本集。副本集往往需要啟動多個(gè)mongodb服務(wù)作為副本集成員，而通常用于開發(fā)的筆記本資源比較有限。鑒于此，官方文檔給了解決辦法，可以直接將一個(gè)單節(jié)點(diǎn)mongodb服務(wù)轉(zhuǎn)換為單節(jié)點(diǎn)副本集(standlone replica set)(https://www.mongodb.com/docs/manual/tutorial/convert-standalone-to-replica-set/)
啟動步驟
按照官方文檔的說明，如果利用docker部署服務(wù)，那么依次有如下步驟:
-
第一步, 假如已經(jīng)存在一個(gè)運(yùn)行中的普通mongodb容器服務(wù)。此時(shí)，需要關(guān)閉服務(wù)，并通過指定
--replSet參數(shù)重啟該服務(wù)或者重新啟動一個(gè)新的mongodb容器。假如mongodb的服務(wù)名及容器名均為
mongodb_rs，運(yùn)行端口映射為27017:27017，副本集名稱為rs0，數(shù)據(jù)存儲目錄指定為/srv/mongodb/db0，數(shù)據(jù)卷掛載目錄為./data:/srv/mongodb/db0。那么docker-compose.yaml文件可編寫如下:version: "3" services: mongodb_rs: network_mode: bridge container_name: mongodb_rs image: mongo:latest ports: - "27017:27017" restart: always # environment: # MONGO_INITDB_ROOT_USERNAME: username # MONGO_INITDB_ROOT_PASSWORD: pwd command: mongod --port 27017 --replSet rs0 --dbpath /srv/mongodb/db0 volumes: - ./data:/srv/mongodb/db0 -
第二步，執(zhí)行如下命令啟動mongodb服務(wù)
docker-compose up -d mongodb_rs
-
第三步，進(jìn)入容器mongosh，執(zhí)行初始化副本集命令
docker exec -it mongodb_rs mongo
# mongosh rs.initiate() # --- # > rs.initiate() # { # "info2" : "no configuration specified. Using a default configuration for the set", # "me" : "f76081e20602:27017", # "ok" : 1 # } # rs0:SECONDARY> # rs0:PRIMARY>| -
第四步，退出容器，容器服務(wù)正常運(yùn)行
可能遇到的問題
按照上述步驟執(zhí)行后，通常情況下容器服務(wù)可以正常運(yùn)行，應(yīng)用程序可以正常進(jìn)行連接，到這里基本就成功了。以golang代碼測試：
package main
import (
"context"
"fmt"
"log"
"go.mongodb.org/mongo-driver/bson"
"go.mongodb.org/mongo-driver/mongo"
"go.mongodb.org/mongo-driver/mongo/options"
)
func main() {
clientOpts := options.Client().ApplyURI("mongodb://localhost:27017/?replicaSet=rs0")
client, err := mongo.Connect(context.TODO(), clientOpts)
if err != nil {
log.Fatal(err)
}
colls, _ := client.Database("admin").ListCollectionNames(context.TODO(), bson.M{})
fmt.Printf("colls: %v\n", colls)
}
// colls: [system.keys system.version]
但是有時(shí)候可能會出現(xiàn)本地程序代碼無法連接副本集服務(wù)，控制臺會報(bào)類似連接錯(cuò)誤的問題，報(bào)錯(cuò)的原因在于副本集無法識別成員host。
在單節(jié)點(diǎn)副本集下，本機(jī)既是主也是從，在容器的mongo shell中可進(jìn)行查看, members只有一個(gè)成員，其name為"f76081e20602:27017", 所以如果你遇到無法連接或者其他類似錯(cuò)誤，根本原因在于本地啟動的這個(gè)副本集無法識別f76081e20602這個(gè)host。
rs.status()
---
rs0:PRIMARY> rs.status()
{
"set" : "rs0",
"date" : ISODate("2022-05-06T18:59:21.417Z"),
# ...
"members" : [
{
"_id" : 0,
"name" : "f76081e20602:27017",
"health" : 1,
"state" : 1,
"stateStr" : "PRIMARY",
"uptime" : 1433,
"optime" : {
"ts" : Timestamp(1651863555, 1),
"t" : NumberLong(1)
},
# ...
}
],
# ...
}
解決辦法
曾經(jīng)遇到上述問題，百度csdn上有多篇內(nèi)容一樣的文章，都說這種情況需要將應(yīng)用程序也通過容器進(jìn)行啟動，并將應(yīng)用程序與mongdb副本集服務(wù)置于同一個(gè)docker網(wǎng)絡(luò)中，就可以正常連接了。這樣做確實(shí)也可行，但似乎過于麻煩了，有點(diǎn)走歪路的感覺。
從上述內(nèi)容已經(jīng)知道是副本集成員host的識別問題，那么在初始化mongodb副本集時(shí)，我們可以顯式的去指定成員host，不使用默認(rèn)的副本集配置。具體而言，將啟動步驟中的第三步更改為:
-
進(jìn)入
mongoshdocker exec -it mongodb_rs mongo
-
自定義配置
# mongosh conf = { _id : "rs0", members: [ { _id: 0, host: "<本機(jī)ip地址>:27017" }, ] } -
初始化副本集
# mongosh rs.initiate(conf)
如此，通過指定成員ip，mongo單節(jié)點(diǎn)副本集就可以準(zhǔn)確的識別到副本集成員，對于多節(jié)點(diǎn)副本集如果出現(xiàn)連接問題，此方法同樣適用。
