Skip to content

Commit

Permalink
More migration advantages
Browse files Browse the repository at this point in the history
Follows up from feedback on Azure#23426
  • Loading branch information
timovv committed Oct 7, 2022
1 parent ebb2237 commit 2ef32a8
Showing 1 changed file with 3 additions and 0 deletions.
3 changes: 3 additions & 0 deletions sdk/test-utils/recorder/MIGRATION.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,11 +7,14 @@ This document outlines key differences between the legacy recorder and the new U
- [Docker] is required, as the [test proxy server] is run in a container during testing. When running the tests, ensure the Docker daemon is running and you have permission to use it. For WSL 2, running `sudo service docker start` and `sudo usermod -aG docker $USER` should be sufficient.

## Advantages of migration to v2

- Recorder v2 handles secrets in the recordings better than v1 leveraging the new sanitizers/transformations approach.
- There are maintenance benefits to recorder v2, partly owing to the new test-proxy tool that is built to support recorders in various languages.
- Will allow us to run the tests in parallel in the future.
- All the recordings will be saved as JSON files instead of being JS files.
- Recordings will soon be migrated to an assets repository to lessen the load of the JS repo, which needs the packages to be migrated to recorder v2 first to grasp the benefits.
- The new recorder allows tests to imitate the live service more accurately during playback, since real HTTP requests are being made.
- The new recorder's API is more transparent and is easier to use compared to the old recorder.

## Upgrading to the Unified Recorder

Expand Down

0 comments on commit 2ef32a8

Please sign in to comment.