背景

在開發(fā)中，我們很容易通過docker啟動(dòng)一個(gè)普通的mongodb數(shù)據(jù)庫(kù)服務(wù)。但是有時(shí)候?yàn)榱吮３峙c線上環(huán)境一致，或者為了利用mongodb副本集的某些特性，我們需要在本地部署mongodb副本集。副本集往往需要啟動(dòng)多個(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/)

啟動(dòng)步驟

按照官方文檔的說明，如果利用docker部署服務(wù)，那么依次有如下步驟:

• 第一步, 假如已經(jīng)存在一個(gè)運(yùn)行中的普通mongodb容器服務(wù)。此時(shí)，需要關(guān)閉服務(wù)，并通過指定--replSet參數(shù)重啟該服務(wù)或者重新啟動(dòng)一個(gè)新的mongodb容器。

  假如mongodb的服務(wù)名及容器名均為mongodb_rs，運(yùn)行端口映射為27017:27017，副本集名稱為rs0，數(shù)據(jù)存儲(chǔ)目錄指定為/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í)行如下命令啟動(dòng)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代碼測(cè)試：

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í)候可能會(huì)出現(xiàn)本地程序代碼無法連接副本集服務(wù)，控制臺(tái)會(huì)報(bào)類似連接錯(cuò)誤的問題，報(bào)錯(cuò)的原因在于副本集無法識(shí)別成員host。

在單節(jié)點(diǎn)副本集下，本機(jī)既是主也是從，在容器的mongo shell中可進(jìn)行查看, members只有一個(gè)成員，其name為"f76081e20602:27017", 所以如果你遇到無法連接或者其他類似錯(cuò)誤，根本原因在于本地啟動(dòng)的這個(gè)副本集無法識(shí)別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)行啟動(dòng)，并將應(yīng)用程序與mongdb副本集服務(wù)置于同一個(gè)docker網(wǎng)絡(luò)中，就可以正常連接了。這樣做確實(shí)也可行，但似乎過于麻煩了，有點(diǎn)走歪路的感覺。

從上述內(nèi)容已經(jīng)知道是副本集成員host的識(shí)別問題，那么在初始化mongodb副本集時(shí)，我們可以顯式的去指定成員host，不使用默認(rèn)的副本集配置。具體而言，將啟動(dòng)步驟中的第三步更改為:

• 進(jìn)入mongosh

  docker 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)確的識(shí)別到副本集成員，對(duì)于多節(jié)點(diǎn)副本集如果出現(xiàn)連接問題，此方法同樣適用。

到此這篇關(guān)于docker搭建mongodb單節(jié)點(diǎn)副本集的實(shí)現(xiàn)的文章就介紹到這了,更多相關(guān)docker搭建mongodb單節(jié)點(diǎn)副本集內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！