Proofdock Chaos CLI

The Proofdock Chaos CLI is a command line tool to execute attacks and scenarios defined in the Azure DevOps.

Project description

This project is part of the Proofdock Chaos Platform that helps you to write, run, store and analyze chaos attacks in your Azure DevOps environment.

For more information visit our official website or documentation. Feel free to ask for support for this package on GitHub.

Getting started

To get started check out our official guide.

Install

This package requires Python 3.5+

$ pip install -U proofdock-chaos-cli

Configuration

The Proofdock Chaos CLI expects that you have a proper API token that allows you to authenticate against the Proofdock cloud. Learn more about the API token generation here.

Set the API token using an environment variable PROOFDOCK_API_TOKEN.

export PROOFDOCK_API_TOKEN=<API token>

Run

You use the pd run command to run an attack and upload its results to the Proofdock cloud.

pd run [OPTIONS] <attack ID>

Test

To test the script, you can make a new virtualenv and then install your package:

$ virtualenv venv
$ . venv/bin/activate
$ pip install --editable .

Afterwards, your command should be available:

$ yourscript
Hello World!