Embargo: network fault testing with Docker
Embargo is a fork of blockade. We have decided to fork blockade because the original project has not been maintained for years. The main difference between the original and this fork is that support for python 2 is dropped and python 3.6 and 3.7 should be supported. More changes should be on the way.
Embargo is a utility for testing network failures and partitions in distributed applications. Embargo uses Docker containers to run application processes and manages the network from the host system to create various failure scenarios.
A common use is to run a distributed application such as a database or cluster and create network partitions, then observe the behavior of the nodes. For example in a leader election system, you could partition the leader away from the other nodes and ensure that the leader steps down and that another node emerges as leader.
Check out the full documentation for details.
- A flexible YAML format to describe the containers in your application
- Support for dependencies between containers, using named links
- A CLI tool for managing and querying the status of your embargo
- Creation of arbitrary partitions between containers
- Giving a container a flaky network connection to others (drop packets)
- Giving a container a slow network connection to others (latency)
- While under partition or network failure control, containers can freely communicate with the host system – so you can still grab logs and monitor the application.
Blockade was originally developed by the Dell Cloud Manager (formerly Enstratius) team. Blockade was inspired by the excellent Jepsen series.
- docker (>= 1.4.0 due to docker-py)
- iproute2 tools (ip and tc specifically)
Embargo expects a embargo.yaml file in the current directory which describes the containers to launch, how they are linked, and various parameters for the embargo modes. Example:
containers: c1: image: my_docker_image command: /bin/myapp volumes: "/opt/myapp": "/opt/myapp_host" expose:  environment: "IS_MASTER": 1 ports: 81: 80 c2: image: my_docker_image command: /bin/myapp volumes: ["/data"] expose:  links: c1: master c3: image: my_docker_image command: /bin/myapp expose:  links: c1: master network: flaky: 30% slow: 75ms 100ms distribution normal
Embargo stores transient information in a local .embargo/ directory. This directory will be cleaned up automatically when you run the embargo destroy command.
Embargo may be used from the command line manually. The commands are also intended to be easy to wrap and automate within tests, etc.
Start the containers and link them together, if necessary.
Destroys all containers and restore networks.
Print the status of the containers and embargo.
embargo flaky n1
embargo flaky n1 n2
Make network flaky to one or more containers.
embargo slow n1
Make network slow to one or more containers.
embargo duplicate n1
Toggle sporadic duplicate packets in the network of one or more containers.
embargo fast n1
Restore network speed and reliability to one or more containers.
embargo partition n1,n2
embargo partition n1,n2 n3,n4
Create one or more network partitions. Each partition is specified as a comma-separated list. Containers may not exist in more than one partition. Containers not specified are grouped into an implicit partition. Each partition command replaces any previous partition or block rules.
Remove all partitions between containers.
Introduce one or many random partitions among the configured nodes.
Embargo is offered under the Apache License 2.0.
Install test dependencies with pip install embargo[test].
You can run integration tests in a Vagrant VM using the included Vagrantfile. Run vagrant up and Docker will be installed in your VM and tests run. You can rerun them with vagrant provision, or SSH into the VM and run them yourself, from /vagrant.
Embargo documentation is built with Sphinx and is found under docs/. To build:
$ pip install -r requirements_docs.txt $ cd docs/ $ make html
HTML output will be under docs/_build/html/.
The documentation is also hosted online.
- Added updated maintainers.
- Refactored code (renamed blockade to embargo in code).
- Updated README.md
- Initial release of Embargo!
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|Filename, size & hash SHA256 hash help||File type||Python version||Upload date|
|embargo-0.1.1-py3-none-any.whl (66.2 kB) Copy SHA256 hash SHA256||Wheel||py3|
|embargo-0.1.1.tar.gz (51.2 kB) Copy SHA256 hash SHA256||Source||None|