Getting Started with Running Scenarios

Quick Start with krknctl (Recommended)

Recommended Approach

krknctl is the recommended and easiest way to run krkn scenarios. It provides command auto-completion, input validation, and abstracts the complexities of the container environment so you can focus on chaos engineering.

Why krknctl?

krknctl is a dedicated CLI tool that streamlines running chaos scenarios by providing:

Command auto-completion - Quick access to all available commands
Input validation - Catch errors before they happen
Scenario descriptions - Built-in documentation and instructions
Simple workflow - No need to manage config files or containers

Get Started in 3 Steps:

Install krknctl - Follow the installation guide
Explore features - Learn about krknctl usage and how to execute chaos scenarios
Run scenarios - Check out each scenario’s documentation for krknctl examples

Alternative Methods

The following alternative methods are available for advanced use cases:

Krkn-hub

Containerized version ideal for CI/CD systems. Set up krkn-hub based on these directions.

See each scenario’s documentation for krkn-hub examples.

Note: krkn-hub only allows you to run 1 scenario type and scenario file at a time.

Krkn

Standalone Python program for running multiple scenarios in a single run. Get krkn set up with the help of these directions.

See these helpful hints on easy edits to the scenarios and config file to start running your own chaos scenarios.

Note: Krkn allows you to run multiple different types of scenarios and scenario files in one execution, unlike krkn-hub and krknctl.