Skip to content

Conversation

@PavelSafronov
Copy link
Contributor

Description

Summary of Changes

Add documentation explaining how to run AWS integration tests locally.

Double check the following

  • Lint is passing (npm run check:lint)
  • Self-review completed using the steps outlined here
  • PR title follows the correct format: type(NODE-xxxx)[!]: description
    • Example: feat(NODE-1234)!: rewriting everything in coffeescript
  • Changes are covered by tests
  • New TODOs have a related JIRA ticket

@PavelSafronov PavelSafronov changed the title WIP: doc: add documentation for running aws integ tests locally doc: add documentation for running aws integ tests locally Jan 5, 2026
@PavelSafronov PavelSafronov marked this pull request as ready for review January 5, 2026 17:24
@PavelSafronov PavelSafronov requested a review from a team as a code owner January 5, 2026 17:24
@dariakp dariakp changed the title doc: add documentation for running aws integ tests locally docs: add documentation for running aws integ tests locally Jan 5, 2026
@baileympearson baileympearson changed the title docs: add documentation for running aws integ tests locally docs(NODE-XXXX): add documentation for running aws integ tests locally Jan 5, 2026
@baileympearson baileympearson changed the title docs(NODE-XXXX): add documentation for running aws integ tests locally docs: add documentation for running aws integ tests locally Jan 5, 2026
set -euxo pipefail # Exit on error, undefined variable, and fail on pipe errors

# NOTE: This script assumes that you've created an AWS SSO session already, as outlined in
# ./test/readme.md, section `AWS Profile`, and you have an AWS profile
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
# ./test/readme.md, section `AWS Profile`, and you have an AWS profile
# ../test/readme.md, section `AWS Profile`, and you have an AWS profile


Setup an AWS_PROFILE locally to be able to use AWS and to run AWS tests locally.

1. Get SSO sign-in info from AWS
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Are these steps just a duplicate of the docs here? https://wiki.corp.mongodb.com/spaces/DRIVERS/pages/239737385/Using+AWS+Secrets+Manager+to+Store+Testing+Secrets

If so, I'd suggest just linking these docs instead

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actually, we do link to these docs (indirectly) in the secrets section of the readme

source $DRIVERS_TOOLS/.evergreen/init-node-and-npm-env.sh

# clear AWS_PROFILE, so it doesn't interfere with env-creds
unset AWS_PROFILE
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is this environment variable used by any AWS auth variants in CI?

aWs there a particular reason this change was needed? iirc the AWS credential provider SDK fetches credentials from the environment first. So it's unclear how having the AWS_PROFILE set would interfere with AWS environment variable credential fetching.

https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-credential-providers/#:~:text=This%20credential%20provider%20will,exposed%20via%20process.env

@@ -0,0 +1,33 @@
#!/usr/bin/env bash
set -euxo pipefail # Exit on error, undefined variable, and fail on pipe errors

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Generally, if we add a script that we plan to use for local testing, we also ensure that it is the same script used to run tests in CI. This ensures the script is always up-to-date.

  • Is there something this script does that isn't captured by our testing readme's instructions?
  • Do you think it's worth refactoring CI to use this script?

@baileympearson baileympearson added the Primary Review In Review with primary reviewer, not yet ready for team's eyes label Jan 13, 2026
@baileympearson baileympearson self-assigned this Jan 13, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Primary Review In Review with primary reviewer, not yet ready for team's eyes

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants