Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/chaos-mesh/chaosd
A Chaos Engineering toolkit.
https://github.com/chaos-mesh/chaosd
chaos chaos-engineering chaos-mesh chaos-testing fault-injection
Last synced: about 22 hours ago
JSON representation
A Chaos Engineering toolkit.
- Host: GitHub
- URL: https://github.com/chaos-mesh/chaosd
- Owner: chaos-mesh
- License: apache-2.0
- Created: 2020-10-10T07:09:03.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2024-04-15T12:58:10.000Z (10 months ago)
- Last Synced: 2024-12-11T00:32:13.783Z (about 2 months ago)
- Topics: chaos, chaos-engineering, chaos-mesh, chaos-testing, fault-injection
- Language: Go
- Homepage:
- Size: 27.1 MB
- Stars: 136
- Watchers: 14
- Forks: 63
- Open Issues: 72
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Roadmap: ROADMAP.md
Awesome Lists containing this project
README
# chaosd
[](https://gitpod.io/#https://github.com/chaos-mesh/chaosd)
chaosd is an easy-to-use Chaos Engineering tool used to inject failures to a physical node.
## Document
For details about the introduction and usage of chaosd, refer to the [documentation](https://chaos-mesh.org/docs/chaosd-overview/).
## Types of fault
You can use Chaosd to simulate the following fault types:
- Process: Injects faults into the processes. Operations such as killing the process or stopping the process are supported.
- Network: Injects faults into the network of physical machines. Operations such as increasing network latency, losing packets, and corrupting packets are supported.
- Stress: Injects stress on the CPU or memory of the physical machines.
- Disk: Injects faults into disks of the physical machines. Operations such as increasing disk load of reads and writes, and filling disks are supported.
- Host: Injects faults into the physical machine. Operations such as shutdown the physical machine are supported.
For details about the introduction and usage of each fault type, refer to the related documentation.
## Work modes
You can use Chaosd in the following modes:
- Command-line mode: Run Chaosd directly as a command-line tool to inject and recover faults.
- Service mode: Run Chaosd as a service in the background, to inject and recover faults by sending HTTP requests.
## Prerequisites
Before deploying chaosd, make sure the following items have been installed:
* [tc](https://linux.die.net/man/8/tc)
* [ipset](https://linux.die.net/man/8/ipset)
* [iptables](https://linux.die.net/man/8/iptables)
* [stress-ng](https://wiki.ubuntu.com/Kernel/Reference/stress-ng) (required when install chaosd by building from source code)
* [byteman](https://github.com/chaos-mesh/byteman)(required when install chaosd by building from source code)
## Install
You can either build directly from the source or download the binary to finish the installation.
- Build from source code
Build chaosd:
```bash
make chaosd
```
Build or download tools related to Chaosd:
```bash
make chaos-tools
```
Put Chaosd into `PATH`:
```
mv ./bin /usr/local/chaosd
export PATH=$PATH:/usr/local/chaosd
```
- Download binary
Download the latest unstable version by executing the command below:
```bash
curl -fsSL -o chaosd-latest-linux-amd64.tar.gz https://mirrors.chaos-mesh.org/chaosd-latest-linux-amd64.tar.gz
```
If you want to download the release version, you can replace the `latest` in the above command with the version number. For example, download `v1.1.1` by executing the command below:
```bash
curl -fsSL -o chaosd-v1.1.1-linux-amd64.tar.gz https://mirrors.chaos-mesh.org/chaosd-v1.1.1-linux-amd64.tar.gz
```
Then uncompress the archived file：
```bash
tar zxvf chaosd-latest-linux-amd64.tar.gz
```
Put Chaosd into `PATH`:
```bash
mv ./chaosd-latest-linux-amd64 /usr/local/chaosd
export PATH=$PATH:/usr/local/chaosd
```