History

James Blair b2fba0290d Mark etcd-local-tester as deprecated so we can remove it in future. Signed-off-by: James Blair <mail@jamesblair.net>		2025-01-29 11:23:21 +13:00
..
bridge	Mark etcd-local-tester as deprecated so we can remove it in future.	2025-01-29 11:23:21 +13:00
bridge.sh	Mark etcd-local-tester as deprecated so we can remove it in future.	2025-01-29 11:23:21 +13:00
faults.sh	*: Convert tabulators to whitespaces in bash scripts.	2020-10-26 10:59:40 +01:00
OWNERS	Automate labels for tools pull requests.	2024-05-12 22:27:19 +12:00
Procfile	local-tester: use new bridge flags	2017-07-11 10:42:31 -07:00
README.md	Mark etcd-local-tester as deprecated so we can remove it in future.	2025-01-29 11:23:21 +13:00

README.md

etcd local-tester

Warning

etcd-local-tester is now deprecated in favor of our much more comprehensive robustness testing suite. In a future etcd release this historic tool will be removed as it is no longer maintained.

The etcd local-tester runs a fault injected cluster using local processes. It sets up an etcd cluster with unreliable network bridges on its peer and client interfaces. The cluster runs with a constant stream of Put requests to simulate client usage. A fault injection script periodically kills cluster members and disrupts bridge connectivity.

Requirements

local-tester depends on goreman to manage its processes and bash to run fault injection.

Building

local-tester needs etcd, benchmark, and bridge binaries. To build these binaries, run the following from the etcd repository root:

./scripts/build.sh
pushd tools/benchmark/ && go build && popd
pushd tools/local-tester/bridge && go build && popd

Running

The fault injected cluster is invoked with goreman:

goreman -f tools/local-tester/Procfile start