From 00116635e918e50d0421abeb67957554f2fac5eb Mon Sep 17 00:00:00 2001 From: bailey Date: Tue, 16 Sep 2025 13:46:01 -0600 Subject: [PATCH 1/3] update readme --- test/readme.md | 23 +++++++++++++++++++---- 1 file changed, 19 insertions(+), 4 deletions(-) diff --git a/test/readme.md b/test/readme.md index 3e4c5103973..430f5b3df9f 100644 --- a/test/readme.md +++ b/test/readme.md @@ -40,6 +40,9 @@ about the types of tests and how to run them. - [Kerberos Tests](#kerberos-tests) - [AWS Authentication tests](#aws-authentication-tests) - [Container Tests](#container-tests) + - [GCP](#gcp) + - [Azure](#azure) + - [AWS](#aws) - [TODO Special Env Sections](#todo-special-env-sections) - [Testing driver changes with mongosh](#testing-driver-changes-with-mongosh) - [Point mongosh to the driver](#point-mongosh-to-the-driver) @@ -76,7 +79,7 @@ The actual implementations of the spec tests can be unit tests or integration te ## Running the Tests Locally -The easiest way to get started running the tests locally is to start a standalone server and run all of the tests. +The easiest way to get started running the tests locally is to start a replica set and run all of the integration tests. Ensure the drivers tools submodule is cloned: @@ -85,16 +88,28 @@ git submodule init git submodule update ``` -Start a `mongod` standalone with our [run-orchestration.sh](.evergreen/run-orchestration.sh) script with the environment set for the cluster: +Set the `DRIVERS_TOOLS` environment variable: ```sh -VERSION='latest' TOPOLOGY='server' AUTH='noauth' ./.evergreen/run-orchestration.sh +export DRIVERS_TOOLS=/drivers-evergreen-tools +``` + +Start a `mongod` replica set with our [run-orchestration.sh](.evergreen/run-orchestration.sh) script with the environment set for the cluster: + +```sh +VERSION='latest' TOPOLOGY='replica_set' AUTH='noauth' bash .evergreen/run-orchestration.sh +``` + +Load the new cluster's URI into the environment: + +```sh +source mo-expansion.sh ``` Then run the tests: ```sh -npm test +npm run check:test ``` > **Note:** the command above will run a subset of the tests that work with the standalone server topology since the tests are being run against a standalone server. From 59470d1a28aef398a50c45fca40ca70375c75478 Mon Sep 17 00:00:00 2001 From: bailey Date: Tue, 16 Sep 2025 14:18:52 -0600 Subject: [PATCH 2/3] phrasing --- test/readme.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/test/readme.md b/test/readme.md index 430f5b3df9f..37d9a2a9b0a 100644 --- a/test/readme.md +++ b/test/readme.md @@ -94,7 +94,7 @@ Set the `DRIVERS_TOOLS` environment variable: export DRIVERS_TOOLS=/drivers-evergreen-tools ``` -Start a `mongod` replica set with our [run-orchestration.sh](.evergreen/run-orchestration.sh) script with the environment set for the cluster: +Start a replica set with our [run-orchestration.sh](.evergreen/run-orchestration.sh) script with the environment set for the cluster: ```sh VERSION='latest' TOPOLOGY='replica_set' AUTH='noauth' bash .evergreen/run-orchestration.sh From 49259fd47ec3adf47d2d884b96b13f72b92f10a7 Mon Sep 17 00:00:00 2001 From: bailey Date: Wed, 17 Sep 2025 08:06:01 -0600 Subject: [PATCH 3/3] remove noauth setting --- test/readme.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/test/readme.md b/test/readme.md index 37d9a2a9b0a..47701d39927 100644 --- a/test/readme.md +++ b/test/readme.md @@ -97,7 +97,7 @@ export DRIVERS_TOOLS=/drivers-evergreen-tools Start a replica set with our [run-orchestration.sh](.evergreen/run-orchestration.sh) script with the environment set for the cluster: ```sh -VERSION='latest' TOPOLOGY='replica_set' AUTH='noauth' bash .evergreen/run-orchestration.sh +VERSION='latest' TOPOLOGY='replica_set' bash .evergreen/run-orchestration.sh ``` Load the new cluster's URI into the environment: