You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/modules/toxiproxy.md
+12-3Lines changed: 12 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,10 +1,16 @@
1
1
# Toxiproxy Module
2
2
3
3
Testcontainers module for Shopify's [Toxiproxy](https://github.com/Shopify/toxiproxy).
4
-
This TCP proxy can be used to simulate network failure conditions in between tests and containers.
5
-
6
-
[toxiproxy-java](https://github.com/trekawek/toxiproxy-java) is used as a client.
4
+
This TCP proxy can be used to simulate network failure conditions.
5
+
6
+
You can simulate network failures:
7
+
8
+
* between Java code and containers, ideal for testing resilience features of client code
9
+
* between containers, for testing resilience and emergent behaviour of multi-container systems
10
+
* if desired, between Java code/containers and external resources (non-Dockerized!), for scenarios where not all dependencies can be/have been dockerized
7
11
12
+
Testcontainers Toxiproxy support allows resilience features to be easily verified as part of isolated dev/CI testing. This allows earlier testing of resilience features, and broader sets of failure conditions to be covered.
13
+
8
14
## Usage example
9
15
10
16
A Toxiproxy container can be placed in between test code and a container, or in between containers.
This module was inspired by a [hotels.com blog post](https://medium.com/hotels-com-technology/i-dont-know-about-resilience-testing-and-so-can-you-b3c59d80012d).
83
+
84
+
[toxiproxy-java](https://github.com/trekawek/toxiproxy-java) is used to help control failure conditions.
0 commit comments