k8s 中文文档

MongoDB In-Memory Server


Node.js CI

This package spins up an actual/real MongoDB server programmatically from within nodejs, for testing or mocking during development. By default it holds the data in memory. A fresh spun up mongod process takes about 7Mb of memory. The server will allow you to connect your favorite ODM or client library to the MongoDB server and run integration tests isolated from each other.

On install, this package downloads the latest MongoDB binaries and saves them to a cache folder. (only mongodb-memory-server-core does not download on postinstall )

On starting a new instance of the memory server, if the binary cannot be found, it will be auto-downloaded (if RUNTIME_DOWNLOAD option is truthy), thus the first run may take some time. All further runs will be fast, because they will use the downloaded binaries.

This package automatically downloads binaries from https://fastdl.mongodb.org/ according to your operating system. You can see all available versions for Linux (Ubuntu, RHEL, Debian, SUSE, Amazon), OSX, and Windows.

If your network is behind a proxy, make sure that it is configured through the HTTPS_PROXY or HTTP_PROXY environment variable.


Every MongoMemoryServer instance creates and starts a fresh MongoDB server on some free port. You may start up several mongod simultaneously. When you terminate your script or call stop(), the MongoDB server(s) will be automatically shutdown.

Works perfectly with any CI runner that can run NodeJS applications.

Table of Contentsgenerated with DocToc

Installation
Requirements
Choose the Correct Package
Configuring which mongod binary to use

Usage
Simple server start
Available options for MongoMemoryServer
Replica Set start
Available options for MongoMemoryReplSet
Config Options
Simple test with MongoClient in Jest
Provide connection string to mongoose
Test Runner Examples
Docker Alpine
Enable Debug Mode

Contributing
Join Our Discord Server
Documentation
Credits
Inspired by
Maintainers

Funding
Contributors
Backers
Sponsors

License

Installation


This tool provides three packages for different purposes:

With auto-download mongod binary on npm install (mongodb-memory-server, mongodb-memory-server-global-* )
Without auto-download on npm install (mongodb-memory-server-core )

Choose any package, because they are the same. They differ only in the default configuration, which you may override (see section Available options ).

Requirements


NodeJS: 12.22+
Typescript: 4.4+ (if used)

And one of those (on Linux):

having lsb-core installed (or any that provides the lsb_release command)
having an /etc/os-release file that is compliant to the OS-Release Spec
having an /etc/*-release file that is compliant to the OS-Release Spec (and does not include lsb )
manually specify which version & system should be used

On Linux, you will also need libcurl4 (or libcurl3 on some older distro versions). This will probably only be an issue on "slim" Docker images.

Choose the Correct Package


Choose the right package for the task

Configuring which mongod binary to use


The default behavior is that version 5.0.13 for your OS will be downloaded. By setting Environment variables you are able to specify which version and binary will be downloaded:

  1. ``` shell
  2. export MONGOMS_DOWNLOAD_URL=https://fastdl.mongodb.org/linux/mongodb-linux-x86_64-ubuntu1804-4.2.8.tgz
  3. export MONGOMS_VERSION=4.2.8
  4. ```

Usage


Simple server start


A Normal Server can be easily started with:

  1. ``` ts
  2. import { MongoMemoryServer } from 'mongodb-memory-server';

  4. // This will create an new instance of "MongoMemoryServer" and automatically start it
  5. const mongod = await MongoMemoryServer.create();

  7. const uri = mongod.getUri();

  9. // The Server can be stopped again with
  10. await mongod.stop();
  11. ```

Available options for MongoMemoryServer


All options are optional.

  1. ``` js
  2. const mongod = new MongoMemoryServer({
  3.   instance: {
  4.     port?: number, // by default choose any free port
  5.     ip?: string, // by default '127.0.0.1', for binding to all IP addresses set it to `::,0.0.0.0`,
  6.     dbName?: string, // by default '' (empty string)
  7.     dbPath?: string, // by default create in temp directory
  8.     storageEngine?: string, // by default `ephemeralForTest`, available engines: [ 'ephemeralForTest', 'wiredTiger' ]
  9.     replSet?: string, // by default no replica set, replica set name
  10.     auth?: boolean, // by default `mongod` is started with '--noauth', start `mongod` with '--auth'
  11.     args?: string[], // by default no additional arguments, any additional command line arguments for `mongod` `mongod` (ex. ['--notablescan'])
  12.   },
  13.   binary: {
  14.     version?: string, // by default '5.0.13'
  15.     downloadDir?: string, // by default node_modules/.cache/mongodb-memory-server/mongodb-binaries
  16.     platform?: string, // by default os.platform()
  17.     arch?: string, // by default os.arch()
  18.     checkMD5?: boolean, // by default false OR process.env.MONGOMS_MD5_CHECK
  19.     systemBinary?: string, // by default undefined or process.env.MONGOMS_SYSTEM_BINARY
  20.   },
  21. });
  22. ```

Replica Set start


A ReplicaSet can be easily started with:

  1. ``` ts
  2. import { MongoMemoryReplSet } from 'mongodb-memory-server';

  4. // This will create an new instance of "MongoMemoryReplSet" and automatically start all Servers
  5. const replset = await MongoMemoryReplSet.create({ replSet: { count: 4 } }); // This will create an ReplSet with 4 members

  7. const uri = replset.getUri();

  9. // The ReplSet can be stopped again with
  10. await replset.stop();
  11. ```

Available options for MongoMemoryReplSet


All options are optional.

  1. ``` js
  2. const replSet = new MongoMemoryReplSet({
  3.   binary: binaryOpts, // same as for MongoMemoryServer
  4.   instanceOpts: [
  5.     {
  6.       args, // any additional instance specific args
  7.       port, // port number for the instance
  8.       dbPath, // path to database files for this instance
  9.       storageEngine, // same storage engine options
  10.     },
  11.     // each entry will result in a MongoMemoryServer (replSet.count will not count towards here)
  12.   ],
  13.   // unless otherwise noted below these values will be in common with all instances spawned:
  14.   replSet: {
  15.     name, // replica set name (default: 'testset')
  16.     auth, //  enable auth support? (default: false)
  17.     args, // any args specified here will be combined with any per instance args from `instanceOpts`
  18.     count, // number of additional `mongod` processes to start (will not start any extra if instanceOpts.length > replSet.count); (default: 1)
  19.     dbName, // default database for db URI strings. (default: uuid.v4())
  20.     ip, // by default '127.0.0.1', for binding to all IP addresses set it to `::,0.0.0.0`
  21.     oplogSize, // size (in MB) for the oplog; (default: 1)
  22.     spawn, // spawn options when creating the child processes
  23.     storageEngine, // default storage engine for instance. (Can be overridden per instance)
  24.     configSettings: {
  25.       // Optional settings for replSetInitiate command. See https://docs.mongodb.com/manual/reference/command/replSetInitiate/
  26.       chainingAllowed: boolean, // When true it allows secondary members to replicate from other secondary members. When false, secondaries can replicate only from the primary.
  27.       heartbeatTimeoutSecs: number, // Number of seconds that the replica set members wait for a successful heartbeat from each other. If a member does not respond in time, other members mark the delinquent member as inaccessible.
  28.       heartbeatIntervalMillis: number, // The frequency in milliseconds of the heartbeats.
  29.       electionTimeoutMillis: number, // The time limit in milliseconds for detecting when a replica set’s primary is unreachable.
  30.       catchUpTimeoutMillis: number, // Time limit for a newly elected primary to sync (catch up) with the other replica set members that may have more recent writes.
  31.     },
  32.   },
  33. });
  34. ```

Config Options


Documentation of Config Options

Simple test with MongoClient in Jest


A example test file for a singleMongoMemoryServer within jest.

A example test file for multipleMongoMemoryServer within jest.

A example test file for a singleMongoMemoryReplSet within jest.

Provide connection string to mongoose


  1. ``` js
  2. // assuming mongoose@6.x
  3. import mongoose from 'mongoose';
  4. import { MongoMemoryServer } from 'mongodb-memory-server';

  6. const mongoServer = await MongoMemoryServer.create();

  8. (async () => {
  9.   await mongoose.connect(mongoServer.getUri(), { dbName: "verifyMASTER" });

  11.   // your code here

  13.   await mongoose.disconnect();
  14. })();
  15. ```

For additional information it is recommended to read this article Testing a GraphQL Server using Jest with Mongoose

Test Runner Examples


Documentation for Test Runner Integration Examples

Docker Alpine


There isn't currently an official MongoDB release for alpine linux. This means that we can't pull binaries for Alpine (or any other platform that isn't officially supported by MongoDB), but you can use a Docker image that already has mongod built in and then set the MONGOMS_SYSTEM_BINARY variable to point at that binary. This should allow you to use mongodb-memory-server on any system on which you can install mongod manually.

Enable Debug Mode


The Debug mode can be enabled with an Environment-Variable or in the package.json "config" section:

  1. ``` shell
  2. MONGOMS_DEBUG=1 # also available case-insensitive values: "on" "yes" "true"
  3. ```

or

  1. ``` json
  2. {
  3.   "config": {
  4.     "mongodbMemoryServer": {
  5.       "debug": "1", // also available case-insensitive values "on" "yes" "true"
  6.     }
  7.   }
  8. }
  9. ```

Also see the Enable Debug Mode Guide.

Contributing


Contributing Guidelines are setup in CONTRIBUTING

Join Our Discord Server


To ask questions or just talk with us, join our Discord Server.

Documentation


Documentation
Quick start guide
Known Issues

Credits


Inspired by


Inspired by alternative runners for mongodb-prebuilt :

mockgoose
mongomem

Maintainers


@nodkz Pavel Chertorogov
@AJRdev Andre Ranarivelo
@hasezoey

Funding


Contributors


This project exists thanks to all the people who contribute.

Backers


Thank you to all our backers! 🙏[Become a backer ]

Sponsors


Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [Become a sponsor ]

License


MIT