Skip to content

Commit b610248

Browse files
authored
Describe pipeline configuration issues (Azure#23979)
1 parent 3cb30f5 commit b610248

File tree

1 file changed

+11
-0
lines changed

1 file changed

+11
-0
lines changed

doc/dev/test_proxy_troubleshooting.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,7 @@ GitHub repository, and documentation of how to set up and use the proxy can be f
1616
- [KeyError during container startup](#keyerror-during-container-startup)
1717
- [ConnectionError during test startup](#connectionerror-during-test-startup)
1818
- [Different error than expected when using proxy](#different-error-than-expected-when-using-proxy)
19+
- [Test setup failure in test pipeline](#test-setup-failure-in-test-pipeline)
1920

2021
## General troubleshooting tip
2122

@@ -91,10 +92,20 @@ if exc_info.type is HttpResponseError:
9192
assert "Name does not resolve" in response_content["Message"]
9293
```
9394

95+
## Test setup failure in test pipeline
96+
97+
If the test proxy isn't configured correctly for pipeline tests, you may see each test fail with an error message
98+
of `test setup failure`. To resolve this, follow the instructions in the
99+
[Enable the test proxy in pipelines][proxy_pipelines] section of the [migration guide][migration_guide]. The test
100+
proxy should be enabled for playback test pipelines and disabled for live test pipelines, since recordings are only
101+
involved in the former scenario.
102+
103+
94104
[detailed_docs]: https://github.com/Azure/azure-sdk-tools/tree/main/tools/test-proxy/Azure.Sdk.Tools.TestProxy/README.md
95105
[general_docs]: https://github.com/Azure/azure-sdk-tools/blob/main/tools/test-proxy/README.md
96106
[mgmt_recorded_test_case]: https://github.com/Azure/azure-sdk-for-python/blob/main/tools/azure-sdk-tools/devtools_testutils/mgmt_recorded_testcase.py
97107
[migration_guide]: https://github.com/Azure/azure-sdk-for-python/blob/main/doc/dev/test_proxy_migration_guide.md
108+
[proxy_pipelines]: https://github.com/Azure/azure-sdk-for-python/blob/main/doc/dev/test_proxy_migration_guide.md#enable-the-test-proxy-in-pipelines
98109
[proxy_startup]: https://github.com/Azure/azure-sdk-for-python/blob/main/tools/azure-sdk-tools/devtools_testutils/proxy_startup.py
99110
[py_sanitizers]: https://github.com/Azure/azure-sdk-for-python/blob/main/tools/azure-sdk-tools/devtools_testutils/sanitizers.py
100111
[pytest_collection]: https://docs.pytest.org/latest/goodpractices.html#test-discovery

0 commit comments

Comments
 (0)