This is a template README.md. Be sure to update this with project specific content that describes your performance test project.

agent-registration-performance-tests

Performance test suite for the <digital service name>, using performance-test-runner under the hood.

Pre-requisites

Services

Start Mongo Docker container following instructions from the MDTP Handbook.

Start AGENT_REGISTRATION_STUBBED_GRS services as follows:

sm2 --start AGENT_REGISTRATION_STUBBED_GRS

Stop AGENT_REGISTRATION_FRONTEND in sm2:

sm2 --stop AGENT_REGISTRATION_FRONTEND

Restart AGENT_REGISTRATION_FRONTEND in sbt with email verification turned off (to avoid email verification calls to the stubbed GRS service which are not supported):

sbt -DignoreEmailVerification=true -Dapplication.router=testOnlyDoNotUseInAppConf.Routes run

Logging

The default log level for all HTTP requests is set to WARN. Configure logback.xml to update this if required.

WARNING ⚠️

Do NOT run a full performance test against staging from your local machine. Please implement a new performance test job and execute your job from the dashboard in Performance Jenkins.

Tests

Run smoke test (locally) as follows:

sbt -DdebugRequests=true -Dperftest.runSmokeTest=true -DrunLocal=true "gatling:testOnly uk.gov.hmrc.perftests.mmtar.AgentRegistrationSimulation"

Run full performance test (locally) as follows:

sbt -DrunLocal=true gatling:test

Run smoke test (staging) as follows:

sbt -Dperftest.runSmokeTest=true -DrunLocal=false gatling:test

Scalafmt

Check all project files are formatted as expected as follows:

sbt scalafmtCheckAll scalafmtCheck

Format *.sbt and project/*.scala files as follows:

sbt scalafmtSbt

Format all project files as follows:

sbt scalafmtAll

License

This code is open source software licensed under the Apache 2.0 License.