https://github.com/dgzlopes/powerfulseal-agent

WIP: Chaos agent for Powerfulseal
https://github.com/dgzlopes/powerfulseal-agent

chaos-engineering powerfulseal testing

Last synced: 7 days ago
JSON representation

WIP: Chaos agent for Powerfulseal

• Host: GitHub
• URL: https://github.com/dgzlopes/powerfulseal-agent
• Owner: dgzlopes
• Created: 2020-03-02T10:53:13.000Z (almost 5 years ago)
• Default Branch: master
• Last Pushed: 2020-05-22T15:15:45.000Z (over 4 years ago)
• Last Synced: 2024-12-09T19:57:00.492Z (13 days ago)
• Topics: chaos-engineering, powerfulseal, testing
• Language: Python
• Homepage:
• Size: 81.1 KB
• Stars: 0
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# powerfulseal-agent

> :warning: This repo is a proof of concept for an experimental Powerfulseal feature. 

## Usage

> Requirements: Docker

Build and run the container:

```

$ make build

$ make run

```

Go to -> http://127.0.0.1:8000/docs (Interactive OpenAPI based docs).

## Actions

Right now you can List attacks, Delete attacks and Create new attacks. For a quick and interactive overview go to -> [/docs](http://127.0.0.1:8000/docs)

Example [API View](https://github.com/dgzlopes/powerfulseal-agent/blob/master/media/api-docs.png).

## Attacks

Right now three areas of attack are available in `powerfulseal-agent`. Each one with its own types of attacks.

> The API design and docs are inspired by [Gremlin](https://www.gremlin.com/docs/infrastructure-layer/attacks/).

### Resource

> Types: CPU and memory

This type of attack makes use of `stress` to exhaust resources.

#### Examples

```json

# Default memory attack

{

  "command": {

    "type": "memory",

    "args": []

  }

}

```

```json

# CPU attack with custom args

{

  "command": {

    "type": "cpu",

    "args": [

      "--cores","1","--duration","40"

    ]

  }

}

```

#### Todo/Ideas

- Add IO and Disk types.

- Add docs about each type and its args.

### Network

TBD (Latency [placeholder](https://github.com/dgzlopes/powerfulseal-agent/blob/master/powerfulseal_agent/network.py) in code)

### State

> Types: Shutdown and restart

Perform chaos actions on the host operating system.

#### Examples

```json

{

  "command": {

    "type": "shutdown",

    "args": []

  }

}

```

#### Todo/Ideas

- Add Process killer type.

- Add docs about each type and its args.