Skip to content

litmuschaos/litmus-ansible

Repository files navigation

litmus-ansible

Slack Channel GitHub Workflow Docker Pulls GitHub issues Twitter Follow CII Best Practices YouTube Channel

This repo consists of Litmus Chaos Experiments written as ansible playbooks. The examples in this repo are good indicators of how to construct the experiments in ansible: complete with steady state checks, chaosresult generation, chaos injection, post chaos checks, event & and reports generation etc.,

NOTE

  • litmus-ansible is very similar in purpose to and therefore a sister repo of litmus-python & litmus-go which contain experiment business logic written in python & golang respectively.

Litmus SDK

The Litmus SDK provides a simple way to bootstrap your experiment and helps create the aforementioned artifacts in the appropriate directory (i.e., as per the chaos-category) based on an attributes file provided as input by the chart-developer. The scaffolded files consist of placeholders which can then be filled as desired.

It generates the custom chaos experiments with some default Pre & Post Chaos Checks (AUT & Auxiliary Applications status checks). It can use the existing chaoslib (present inside /chaoslib directory), if available else It will create a new chaoslib inside the corresponding directory.

Refer Litmus-SDK for more details.

How to get started?

Refer the LitmusChaos documentation litmus docs

How do I contribute?

You can contribute by raising issues, improving the documentation, contributing to the core framework and tooling, etc.

Head over to the Contribution guide