diff options
author | Richard Samuels <richard.l.samuels@gmail.com> | 2022-04-08 13:50:25 +0000 |
---|---|---|
committer | Evergreen Agent <no-reply@evergreen.mongodb.com> | 2022-04-08 14:27:40 +0000 |
commit | 0d9705653d904bed75b06f77eba2a5e9af2b3a7d (patch) | |
tree | 4657e027db6c13012bb71f7ceb9c689efd677682 /docs | |
parent | d96b46e0430d0fe4ce82264e2924df9ed505a5c6 (diff) | |
download | mongo-0d9705653d904bed75b06f77eba2a5e9af2b3a7d.tar.gz |
SERVER-62992 Remove need for resmoke.ini
Diffstat (limited to 'docs')
-rw-r--r-- | docs/testing/README.md | 36 |
1 files changed, 36 insertions, 0 deletions
diff --git a/docs/testing/README.md b/docs/testing/README.md new file mode 100644 index 00000000000..8c76472c334 --- /dev/null +++ b/docs/testing/README.md @@ -0,0 +1,36 @@ +# Testing + +Most tests for MongoDB are run through resmoke, our test runner and orchestration tool. +The entry point for resmoke can be found at `buildscripts/resmoke.py` + +## run + +The run subcommand can run suites (list of tests and the MongoDB topology and +configuration to run them against), and explicitly named test files. + +A single suite can be specified using the `--suite` flag, and multiple suites +can be specified by providing a comma separated list to the `--suites` flag. + +Additional parameters for the run subcommand can be found on the help page, +accessible by running `buildscripts/resmoke.py run --help` + +Additional documentation on our suite configuration can be found on the +[Suites configuration file page](../suites.md) + +### Testable Installations (`--installDir`) + +resmoke can run tests against any testable installation of MongoDB (such +as ASAN, Debug, Release). When possible, resmoke will automatically locate and +run with a locally built copy of MongoDB Server, so long as that build was +installed to a subdirectory of the root of the git repository, and there is +exactly one build. In other situations, the `--installDir` flag, passed to run +subcommand, can be used to indicate the location of the mongod/mongos binaries. + +As an alternative, you may instead prefer to use the resmoke.py wrapper script +located in the same directory as the mongod binary, which will automatically +set `installDir` for you. + +Note that this wrapper is unavailable in packaged installations of MongoDB +Server, such as those provided by Homebrew, and other package managers. If you +would like to run tests against a packaged installation, you must explicitly +pass `--installDir` to resmoke.py |