1. yum方式安裝
1、添加一個yum源
創建一個 /etc/yum.repos.d/mongodb-org-5.0.repo 文件
[mongodb-org-5.0]
name=MongoDB Repository
baseurl=https://repo.mongodb.org/yum/redhat/$releasever/mongodb-org/5.0/x86_64/
gpgcheck=1
enabled=1
gpgkey=https://www.mongodb.org/static/pgp/server-5.0.asc
2、安裝MongoDB包
sudo yum install -y mongodb-org
默認配置文件:/etc/mongod.conf
默認數據文件目錄:/var/lib/mongo
默認日志文件目錄:/var/log/mongodb
3、可以自定義配置文件,更改某些設置
比如,指定新的數據存儲目錄(例如:/some/data/directory)或者 指定新的日志文件路徑(例如:/some/log/directory/mongod.log)
最后,一定要確保運行MongoDB的用戶有權限訪問這些目錄。假設我們新創建了一個用戶叫zhangsan,我們打算用zhangsan這個用戶來運行MongoDB,那么必須確保zhangsan可以訪問/some/data/directory和/some/log/directory/mongod.log
於是,可以這樣操作
sudo chown -R zhangsan:zhangsan <directory>
mongod --config /etc/mongod.conf
PS:如果更改運行 MongoDB 進程的用戶,則必須授予新用戶訪問這些目錄的權限。
4、啟動MongoDB
sudo systemctl start mongod
5、查看MongoDB運行狀態
sudo systemctl status mongod
6、停止MongoDB
sudo systemctl stop mongod
7、重啟MongoDB
sudo systemctl restart mongod
8、使用MongoDB
mongosh
在與 mongod 相同的主機上啟動 mongosh 會話。可以在不帶任何參數的情況下運行 mongosh,這樣的話就會連接本地 localhost 上運行的 mongod,默認端口為 27017。
9、help
10、卸載MongoDB
# 停止服務
sudo systemctl stop mongod
# 刪除安裝包
sudo yum erase $(rpm -qa | grep mongodb-org)
# 刪除數據庫和日志文件
sudo rm -r /var/log/mongodb
sudo rm -r /var/lib/mongo
11、快速開始
MongoDB 將文檔存儲在集合中。 集合類似於關系數據庫中的表。 如果集合不存在,MongoDB 會在首次存儲該集合的數據時創建該集合。
12、包名稱和描述
- mongodb-org-database : 是一個metapackage,會自動安裝下列組件包
- mongodb-org-server : 包含 mongod 守護進程、相關的初始化腳本和配置文件 (/etc/mongod.conf)
- mongodb-org-mongos : 包含 mongos 守護進程
- mongodb-org-shell : 包含歷史遺留的 mongo shell
- mongodb-mongosh : 包含 MongoDB Shell (mongosh)
- mongodb-org-tools : 是一個metapackage,會自動安裝以下組件包
- mongodb-database-tools : 包含下列MongoDB數據庫工具(mongodump 、mongorestore 、bsondump 、mongoimport 、mongoexport 、mongostat 、mongotop 、mongofiles)
- mongodb-org-database-tools-extra : 包含install_compass腳本
13、關閉防火牆
systemctl stop|start|status firewalld
2. docker方式安裝
下載鏡像
docker pull mongo
指定版本運行容器
1、啟動一個 mongo server 實例
docker run --name some-mongo -d mongo:tag
2、從另一個 Docker 容器連接到 MongoDB
以下示例啟動另一個 MongoDB 容器實例,並針對上面示例中的原始 MongoDB 容器運行 mongo 命令行客戶端,從而允許您對數據庫實例執行 MongoDB 語句:
docker run -it --network some-network --rm mongo mongo --host some-mongo test
(PS:這里解釋一下,這就相當於是在B容器中遠程連接到A容器,相當於是本地mongo客戶端連接到遠程mongo服務器。由於現在mongo是運行在docker容器里的,所以我們可以把運行mongo server的容器理解成一台機器A,為了能夠在另外一台機器B中連接到A,需要B上至少安裝了mongo shell,這就是mongo client 連接到遠程 mongo server)
3、容器shell訪問並查看MongoDB日志
docker exec 命令允許你在 Docker 容器內運行命令。 以下命令行將為你提供 mongo 容器內的 bash shell:
docker exec -it some-mongo bash
MongoDB 服務器日志可通過 Docker 的容器日志獲得:
docker logs some-mongo
4、幫助
查看幫助,可以知道mongo容器運行時可以帶哪些參數
docker run -it --rm mongo --help
5、設置WiredTiger緩存大小限制
docker run --name some-mongo -d mongo --wiredTigerCacheSizeGB 1.5
6、用一個自定義的MongoDB配置文件
mongod 默認不讀取配置文件,所以需要通過 --config 選項來指定配置文件的路徑。 通過從 mongo 創建自定義 Dockerfile 或將其從主機掛載到容器來創建自定義配置文件並將其放入容器中。
例如,假設/my/custom/mongod.conf是自定義的配置文件,那么在啟動MongoDB容器的時候可以這樣:
docker run --name some-mongo -v /my/custom:/etc/mongo -d mongo --config /etc/mongo/mongod.conf
默認的配置文件(/etc/mongod.conf)如下:
# mongod.conf
# for documentation of all options, see:
# http://docs.mongodb.org/manual/reference/configuration-options/
# where to write logging data.
systemLog:
destination: file
logAppend: true
path: /var/log/mongodb/mongod.log
# Where and how to store data.
storage:
dbPath: /var/lib/mongo
journal:
enabled: true
# engine:
# wiredTiger:
# how the process runs
processManagement:
fork: true # fork and run in background
pidFilePath: /var/run/mongodb/mongod.pid # location of pidfile
timeZoneInfo: /usr/share/zoneinfo
# network interfaces
net:
port: 27017
bindIp: 127.0.0.1 # Enter 0.0.0.0,:: to bind to all IPv4 and IPv6 addresses or, alternatively, use the net.bindIpAll setting.
#security:
#operationProfiling:
#replication:
#sharding:
## Enterprise-Only Options
#auditLog:
#snmp:
7、環境變量
啟動 mongo 鏡像時,可以通過在 docker run 命令行中傳遞一個或多個環境變量來調整 MongoDB 實例的初始化。
MONGO_INITDB_ROOT_USERNAME, MONGO_INITDB_ROOT_PASSWORD 這兩個變量一起使用,創建一個新用戶並設置該用戶的密碼。 該用戶是在管理員(admin)身份驗證數據庫中創建的,並被賦予 root 角色,這是一個“superuser(超級用戶)”角色。
下面是一個例子,使用這兩個變量創建一個MongoDB實例,然后使用 mongo cli 連接到admin身份認證數據庫。
首先,啟動容器,創建MongoDB實例
docker run -d --network some-network --name some-mongo \
-e MONGO_INITDB_ROOT_USERNAME=mongoadmin \
-e MONGO_INITDB_ROOT_PASSWORD=secret \
mongo
連接到前面創建的mongo server實例容器
docker run -it --rm --network some-network mongo \
mongo --host some-mongo \
-u mongoadmin \
-p secret \
--authenticationDatabase admin \
some-db
(PS:命令行中的mongo是鏡像的名字,而 mongod 是 MongoDB 系統的主要守護進程)
要創建用戶,這兩個變量都是必需的。 如果二者都存在,那么 MongoDB 將啟用身份驗證(mongod --auth)
MongoDB 中的身份驗證相當復雜,因此更復雜的用戶設置通過 /docker-entrypoint-initdb.d/ 顯式留給用戶自己設置
MONGO_INITDB_DATABASE 這個變量允許您指定用於/docker-entrypoint-initdb.d/*.js中創建腳本的數據庫名稱
MongoDB 設計的最基本的原則是:"create on first use" (第一次使用時創建)
作為通過環境變量傳遞敏感信息的替代方法,_FILE 可以附加到先前列出的環境變量中,從而導致初始化腳本從容器中存在的文件中加載這些變量的值。特別是,這可用於從存儲在 /run/secrets/<secret_name> 文件中的 Docker 密鑰存儲中加載密碼。當前,只支持MONGO_INITDB_ROOT_USERNAME 和 MONGO_INITDB_ROOT_PASSWORD 。
docker run --name some-mongo -e MONGO_INITDB_ROOT_PASSWORD_FILE=/run/secrets/mongo-root -d mongo
8、認證
MongoDB 中的身份驗證相當復雜,參見:
Security > Role-Based Access Control
Security > Role-Based Access Control > Built-In Roles
Security > Enable Auth (tutorial)
9、數據存儲在哪里
有兩種方法可以存儲在 Docker 容器中運行的應用程序使用的數據。
方式一:讓Docker使用自己的內部卷管理將數據庫文件寫入主機系統上的磁盤,從而管理數據庫數據的存儲。這是默認設置,對用戶來說非常簡單且相當透明。缺點是,對於直接運行在主機系統上的工具和應用程序(即外部容器)來說,可能很難找到這些文件。
方式二:在宿主機系統(容器外部)上創建一個數據目錄,並將其掛載到容器內部可見的目錄。這會將數據庫文件放置在主機系統上的已知位置,並使主機系統上的工具和應用程序可以輕松訪問這些文件。 缺點是,用戶需要確保目錄存在,例如,主機系統上的目錄權限和其他安全機制是正確設置的。
(PS:總結一下,兩種方式,一種是放到容器內部,另一種是放到容器外部)
由docker自己管理這種默認行為就不在這里演示了,下面演示一下將容器外部的目錄掛載到容器這種方式:
首先,在宿主機上創建一個目錄,比如叫 /my/own/datadir
然后,在啟動容器的時候使用 -v 選項掛載目錄
docker run --name some-mongo -v /my/own/datadir:/data/db -d mongo
這個命令中,-v /my/own/datadir:/data/db 將主機系統上的/my/own/datadir目錄掛載到容器的/data/db。docker容器安裝mongodb時,默認情況下MongoDB會將它的數據存放在/data/db目錄中。
備忘錄
docker network create my-network
docker network ls
docker run -d --network my-network --name my-mongo mongo
docker run -it --rm --network my-network mongo mongo --host my-mongo test
docker exec -it my-mongo bash
10、創建數據庫轉儲(dump)
docker exec some-mongo sh -c 'exec mongodump -d <database_name> --archive' > /some/path/on/your/host/all-collections.archive
11、備忘錄
docker run --network some-network --name some-mongo -v /my/custom:/etc/mongo -p 27017:27017 -d mongo --config /etc/mongo/mongod.conf
docker run --name some-mongo -p 27017:27017 -d mongo --auth
docker exec -it some-mongo mongo admin
> db.createUser({user:"root",pwd:"123456",roles:["root"]})
docker run -d --name some-mongo \
-e MONGO_INITDB_ROOT_USERNAME=admin \
-e MONGO_INITDB_ROOT_PASSWORD=123456 \
mongo
docker exec -it some-mongo mongo
文檔:
https://docs.mongodb.com/manual/tutorial/install-mongodb-on-red-hat/
https://registry.hub.docker.com/_/mongo
https://docs.docker.com/engine/reference/commandline/network/