Skip to content
Litmus is a toolset to do chaos engineering in a kubernetes native way. Litmus provides chaos CRDs for Cloud-Native developers and SREs to inject, orchestrate and monitor chaos to find weaknesses in Kubernetes deployments. Community notes is at https://hackmd.io/a4Zu_sH4TZGeih-xCimi3Q
Python Shell Makefile Dockerfile
Branch: master
Clone or download
shubhamchaudhary and ksatchit (feat): Added containerd runtime for container-kill experiment (#1175)
Signed-off-by: shubhamchaudhary <shubham.chaudhary@mayadata.io>
Latest commit e234fbb Jan 28, 2020
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github adding multiple templates for github issues (#838) Oct 11, 2019
build (refactor) make the experiment logs more meaningful (#1048) Jan 7, 2020
ceps (chore)cep: add cep template (#917) Nov 6, 2019
chaoslib (feat): Added containerd runtime for container-kill experiment (#1175) Jan 28, 2020
ci_plugins/gitlab (restructure)repo: restructure litmus repo for generic chaos: contd Sep 30, 2019
contribute/developer_guide Add pytest suite to verify successful scaffolding of experiment artef… Dec 12, 2019
executor (feat): Add ability to provide cmap/secret in engine (#1129) Jan 20, 2020
experiments (feat): Added containerd runtime for container-kill experiment (#1175) Jan 28, 2020
hack Add pytest suite to verify successful scaffolding of experiment artef… Dec 12, 2019
images Adding new images to be used for Litmus branding (#812) Oct 6, 2019
utils (refactor): Updating kafka broker pod failure experiment (#1095) Jan 10, 2020
.bettercodehub.yml (chore) add bettercodehub badge to readme (#1083) Jan 9, 2020
.gitignore Add pytest suite to verify successful scaffolding of experiment artef… Dec 12, 2019
.gitlab-ci.yml (feat): Add baseline stage in the gitlab pipeline (#1128) Jan 20, 2020
.travis.yml (chore)ci: add sonarqube quality check (#847) Oct 14, 2019
ADOPTERS.md (chore) add bettercodehub badge to readme (#1083) Jan 9, 2020
CHAOS_EXPERIMENT_MATURITY.md (chore)updates to project docs (#946) Nov 15, 2019
CODE_OF_CONDUCT.md (fix): Typo fix in CODE_OF_CONDUCT.md and README.md (#834) Oct 11, 2019
CONTRIBUTING.md (community)contributing_guide: include sync up meeting details (#884) Oct 22, 2019
LICENSE (license): Update the license Authors (#957) Nov 25, 2019
Makefile (refactor)experiments: rename experiment artefacts (#800) Oct 4, 2019
NOTICE.md (restructure)repo: restructure litmus repo for generic chaos: contd Sep 30, 2019
README.md (chore) add bettercodehub badge to readme (#1083) Jan 9, 2020
RELEASE_GUIDELINES.md (chore)updates to project docs (#946) Nov 15, 2019
sonar-project.properties (chore): exclude modified ansible source files from sonar analysis (#… Jan 9, 2020

README.md

LitmusChaos

Cloud-Native Chaos Engineering; Kubernetes-Native Chaos Engineering; Chaos Engineering for Kubernetes

Build Status Docker Pulls GitHub stars GitHub issues Twitter Follow CII Best Practices Quality Gate Status BCH compliance



Overview

Litmus is a toolset to do cloud-native chaos engineering. Litmus provides tools to orchestrate chaos on Kubernetes to help SREs find weaknesses in their deployments. SREs use Litmus to run chaos experiments initially in the staging environment and eventually in production to find bugs, vulnerabilities. Fixing the weaknesses leads to increased resilience of the system.

Litmus takes a cloud-native approach to create, manage and monitor chaos. Chaos is orchestrated using the following Kubernetes Custom Resource Definitions (CRDs):

  • ChaosEngine: A resource to link a Kubernetes application or Kubernetes node to a ChaosExperiment. ChaosEngine is watched by Litmus' Chaos-Operator which then invokes Chaos-Experiments
  • ChaosExperiment: A resource to group the configuration parameters of a chaos experiment. ChaosExperiment CRs are created by the operator when experiments are invoked by ChaosEngine.
  • ChaosResult: A resource to hold the results of a chaos-experiment. The Chaos-exporter reads the results and exports the metrics into a configured Prometheus server.

Chaos experiments are hosted on hub.litmuschaos.io. It is a central hub where the application developers or vendors share their chaos experiments so that their users can use them to increase the resilience of the applications in production.

Use cases

  • For Developers: To run chaos experiments during application development as an extension of unit testing or integration testing.
  • For CI pipeline builders: To run chaos as a pipeline stage to find bugs when the application is subjected to fail paths in a pipeline.
  • For SREs: To plan and schedule chaos experiments into the application and/or surrounding infrastructure. This practice identifies the weaknesses in the system and increases resilience.

Demo

asciicast

Getting Started with Litmus

See Litmus Docs.

Contributing to Chaos Hub

See Contributing to chaos hub

Adopters

See Adopters of LitmusChaos

(Send a PR to the above page if you are using Litmus in your chaos engineering practice)

License

Litmus is licensed under the Apache License, Version 2.0. See LICENSE for the full license text. Some of the projects used by the Litmus project may be governed by a different license, please refer to its specific license.

Community notes

https://hackmd.io/a4Zu_sH4TZGeih-xCimi3Q

Important Links

Litmus Docs Litmus Docs
CNCF Landscape Litmus on CNCF Landscape
You can’t perform that action at this time.