1.0.0

New features and Enhancements

• Introduces a new chart for CoreDNS, a graduated CNCF project with a DNS pod failure experiment.
• Enhances the infrastructure/cluster level chaos suite with node drain chaos experiment
• Enhances the pod network chaos suite with network packet corruption chaos experiment
• Enhances the resource stress chaos suite with pod/container CPU hog experiment
• Supports post chaos checks against multiple (dependent) applications via the auxiliaryAppInfo property in the ChaosEngine CR
• Optimises the chaosServiceAccount permissions needed for each experiment at their respective scope (Namespaced, Cluster) in the scope & permissions of the ChaosExperiment CR. A sample RBAC manifest is now also provided with individual experiment documentation
• Adds validation of LitmusChaos CRDs via OpenAPI schema validation to help with prevention of malformed - ChaosEngine/ChaosExperiment CRs
• Upgrades the new Go ChaosRunner to beta quality
• Adds Gitlab CI for build & Chaos-Chart-e2e pipelines on LitmusChaos repositories
• Enhances the side panel on charthub (hub.litmuschaos.io) with experiment maturity, documentation link & supported Kubernetes platforms
• Includes support for usage (Google Analytics) metrics against the Chaos Experiments to capture chaos trends, indicated on respective charts in the charthub
• Indicates blast radius of a Chaos Experiment on the respective Charts in the charthub

Major Bug Fixes

• Fixes chaoslib task files to successfully cleanup chaos resources (daemonsets) in case of infra chaos experiments
• Fixes chaoslib task files to end plays/experiment upon not meeting expected conditions/results rather than notify & proceed with play.
• Move to apps/v1 for deployment/daemonset resources to support recent Kubernetes versions (1.16+)
• Fixes inability to cleanup experiment job when .spec.jobCleanupPolicy is set to delete with Go chaos runner
• Fixes reuse of facts/ playbook, included & registered variables by setting up a new naming convention to pass details from experiment logic playbooks to task files
• Update the docs with correct values for Mandatory/Optional nature of experiment environmental variables
• Fix broken/dead links on the charthub and docs

Community

• Monthly community sync-up (every 3rd Wednesday) to go over the concluded release, roadmap discussion, contributor shoutout, presentations/demos
• Group Reviews of contributors PRs on a need basis
• Improved contributor documentation for the chaos operator

Getting Started

Prerequisites to install

• Make sure you have a healthy Kubernetes Cluster.
• Kubernetes 1.11+ is installed

Installation

kubectl apply -f https://litmuschaos.github.io/pages/litmus-operator-v1.0.0.yaml

Verify your installation

• Verify if the chaos operator is running
  kubectl get pods -n litmus

• Verify if chaos CRDs are installed
  kubectl get crds | grep chaos

For more details refer to the documentation at Docs

1.0.0-RC2

Getting Started

Prerequisites to install

• Make sure you have a healthy Kubernetes Cluster.
• Kubernetes 1.11+ is installed

Installation

kubectl apply -f https://litmuschaos.github.io/pages/litmus-operator-latest.yaml

Verify your installation

• Verify if the chaos operator is running
  kubectl get pods -n litmus

• Verify if chaos CRDs are installed
  kubectl get crds | grep chaos

• Verify if the chaos experiments are installed.
  kubectl get chaosexperiments

For more details refer to the documentation at Docs

1.0.0-RC1

Getting Started

Prerequisites to install

• Make sure you have a healthy Kubernetes Cluster.
• Kubernetes 1.11+ is installed

Installation

kubectl apply -f https://litmuschaos.github.io/pages/litmus-operator-latest.yaml

Verify your installation

• Verify if the chaos operator is running
  kubectl get pods -n litmus

• Verify if chaos CRDs are installed
  kubectl get crds | grep chaos

• Verify if the chaos experiments are installed.
  kubectl get chaosexperiments

For more details refer to the documentation at Docs

0.9.0

New capabilities & Enhancements

• Introduces an alpha version of a new chaos-runner written in Go, that supports increased performance, validation of experiment dependencies & improved logging, while laying the base for features such as random execution, chaos experiment abort, etc.,
• Includes support for execution of chaos on daemonsets
• Includes support for injecting config information to the chaos experiments via configmaps and secrets
• Ability to specify chaos-runner and chaos-monitor default images via environment variables in the chaos-operator deployment
• Includes support for performing a multi/group-kill of pods in the pod-failure chaos experiment
• Support network chaos (latency, packet loss) on all apps irrespective of the availability of linux traffic shaper tool “tc” with upgraded pumba (0.6.5) integration
• Improved health checks (kafka cluster state) in kafka chaos experiments via zookeeper
• Includes kafka broker network chaos (latency & packet loss) experiments
• Improved user experience on the chaoshub (hub.litmuschaos.io) with platform & experiment maturity information.
• Improved experiment-specific user guides on docs.litmuschaos.io
• Updated chaos-operator using operator-sdk version 1.12

Major Bug Fixes

• Fix chaos-runner failure to patch chaosengine with chaos experiment results
• Deprecate chaoskube support and fix chaoslib selection logic for pod-failure experiments
• Fix reuse of ansible register variables as facts in container-kill & pod-failure chaos experiments
• Fix premature exit of the chaos-runner pod before chaos experiment completion

Getting Started

Prerequisites to install

• Make sure you have a healthy Kubernetes Cluster.
• Kubernetes 1.11+ is installed

Installation

kubectl apply -f https://litmuschaos.github.io/pages/litmus-operator-v0.9.0.yaml

Verify your installation

• Verify if the chaos operator is running
  kubectl get pods -n litmus

• Verify if chaos CRDs are installed
  kubectl get crds | grep chaos

• Verify if the chaos experiments are installed.
  kubectl get chaosexperiments

For more details refer to the documentation at Docs

0.9.0-RC1

Getting Started

Prerequisites to install

• Make sure you have a healthy Kubernetes Cluster.
• Kubernetes 1.11+ is installed

Installation

kubectl apply -f https://litmuschaos.github.io/pages/litmus-operator-latest.yaml

Verify your installation

• Verify if the chaos operator is running
  kubectl get pods -n litmus

• Verify if chaos CRDs are installed
  kubectl get crds | grep chaos

• Verify if the chaos experiments are installed.
  kubectl get chaosexperiments

For more details refer to the documentation at Docs

0.8.0

Getting Started

Prerequisites to install

• Make sure you have a healthy Kubernetes Cluster.
• Kubernetes 1.11+ is installed

Whats New?

• [chaos-operator] [enhancement] Supports Chaos on Statefulset resources
• [chaos-operator] [fix] Obtains application namespace from spec.appinfo.appns instead of ChaosEngine namespace
• [chaos-operator] [ci] Increased unit-tests
• [chaos-operator] [enhancement] Supports auto-removal of chaos experiment jobs upon completion
• [chaos-operator] [enhancement] Supports ability to choose chaos executor and exporter images
• [chaos-operator] [enhancement] Supports secret definition in chaos experiments CRs
• [chaos-exporter] [enhancement] Increased unit-tests
• [litmus] [feature] Includes OpenEBS Chaos Litmusbooks (storage pool pod/container failure, storage target pod/container failure, target container network delay/loss)
• [litmus] [feature] Includes Kafka Chaos experiments (kafka broker pod failure, kafka broker disk failure)
• [litmus] [feature] Includes Infra/platform level Chaos experiments (gke) (disk loss, disk fill, cpu hog)
• [litmus] [feature] Add quality checks via sonarqube integration
• [litmus] [enhancement] Optimized Dockerfile for ansible-runner image
• [litmus] [enhancement] Provides pumba image as a tunable (LIB_IMAGE) for container-kill & network chaos experiments
• [litmus] [developer-docs] Includes developer guide with script to scaffold chaos experiment
• [litmus] [project-mgmt] Includes chaos experiment maturity guidelines and litmus release guidelines
• [chaos-charts] [charts] Additional OpenEBS chaos charts
• [chaos-charts] [charts] Introduces Kafka experiment charts
• [chaos-charts] [icons] Adds new icons for chaos chart & experiment cards
• [charthub] [feature] Support for hosting ( & auto-updation) of chaos-charts on the hub
• [charthub] [enhancement] Include icons for generic & OpenEBS charts
• [litmus-docs] [fix] Fixes dead links
• [litmus-docs] [enhancements] Optimized images for doc pages
• [litmus-docs] [enhancement] Improved mobile view for docs website

Installation

kubectl apply -f https://litmuschaos.github.io/pages/litmus-operator-v0.8.0.yaml

Verify your installation

• Verify if the chaos operator is running
  kubectl get pods -n litmus

• Verify if chaos CRDs are installed
  kubectl get crds | grep chaos

• Verify if the chaos experiments are installed.
  kubectl get chaosexperiments

For more details refer to the documentation at Docs

0.8.0-RC1

Getting Started

Prerequisites to install

• Make sure you have a healthy Kubernetes Cluster.
• Kubernetes 1.11+ is installed

Installation

kubectl apply -f https://litmuschaos.github.io/pages/litmus-operator-latest.yaml

Verify your installation

• Verify if the chaos operator is running
  kubectl get pods -n litmus

• Verify if chaos CRDs are installed
  kubectl get crds | grep chaos

• Verify if the chaos experiments are installed.
  kubectl get chaosexperiments

For more details refer to the documentation at Docs

0.7.0

Getting Started

Prerequisites to install

• Make sure you have a healthy Kubernetes Cluster.
• Kubernetes 1.11+ is installed

What's new?

• [chaos-operator] [enhancement] Refactored operator code to increase modularity
• [chaos-operator] [bug-fix] Fix Crashing of Chaos-Executor post-experiment execution
• [chaos-operator] [feature] Ability to turn on/off monitoring (chaos metrics collection) via ChaosEngine
• [chaos-operator] [enhancement] Run chaos exporter as a separate pod
• [chaos-operator] [ci] Increased unit-test coverage
• [chaos-exporter] [enhancement] Refactored exporter code to increase modularity (BCH standards)
• [litmus] [enhancement] Ability to patch experiment status to ChaosEngine
• [litmus] [feature] Ability to override experiment defaults via ChaosEngine spec
• [litmus] [feature] Add powerfulseal integration (chaoslib) to induce pod chaos
• [litmus] [feature] Experiments to perform network chaos using Pumba
• [litmus] [enhancement] Optimized dockerfile for ansible-runner image
• [chaos-charts] [charts] Additional OpenEBS chaos charts (target failure, pool failure, target network chaos)
• [chaos-charts] [charts] Additional Generic charts (network chaos)
• [chaos-charts] [ci] Auto-Versioning of chaos charts
• [charthub][enhancements] Implementation of filters and sort functionalities on chaos hub
• [litmus-docs] [enhancements] Restructured docs with simpler user guide & architecture details
• [litmus-docs] [feature] Updated docs website to use docusaurus version 1.13.0

Installation

kubectl apply -f https://litmuschaos.github.io/pages/litmus-operator-v0.7.0.yaml

Verify your installation

• Verify if the chaos operator is ru\nning
  kubectl get pods -n litmus

• Verify if chaos CRDs are installed
  kubectl get crds | grep chaos

• Verify if the chaos experiments are installed.
  kubectl get chaosexperiments

For more details refer to the documentation at Docs

0.7.0-RC1

Getting Started

Prerequisites to install

• Make sure you have a healthy Kubernetes Cluster.
• Kubernetes 1.11+ is installed

Installation

kubectl apply -f https://litmuschaos.github.io/pages/litmus-operator-latest.yaml

Verify your installation

• Verify if the chaos operator is running
  kubectl get pods -n litmus

• Verify if chaos CRDs are installed
  kubectl get crds | grep chaos

• Verify if the chaos experiments are installed.
  kubectl get chaosexperiments

For more details refer to the documentation at Docs

0.6.0

Getting Started

Whats's new

• Support for KubernetesVersion and OpenEBSVersion in ChaosExporter
• Added BDD tests for ChaosOperator and ChaosExporter
• Released Chaos Hub to render chaos charts (OpenEBS and k8s chart)

Prerequisites to install

• Make sure you have a healthy Kubernetes Cluster.
• Make sure that you are in the admin context in order to setup RBAC.
• Make sure you have setup Helm (with Tiller) on your k8s cluster. From installing Tiller, please follow here: https://github.com/litmuschaos/chaos-charts/blob/master/README.md
• Make sure that you don't have any prior instance of LitmusChaos CRDS like ChaosEngine, ChaosExperiment, ChaosResult, LitmusResult. so that you don't face any failure while installing HELM commands.

Install using kubectl

// Installing RBAC for authorization
kubectl create -f https://raw.githubusercontent.com/litmuschaos/chaos-operator/v0.6/deploy/rbac.yaml

// Installing required CRDS 
kubectl create -f https://raw.githubusercontent.com/litmuschaos/chaos-operator/v0.6/deploy/chaos_crds.yaml

// Deploying chaos operator
kubectl create -f https://raw.githubusercontent.com/litmuschaos/chaos-operator/v0.6/deploy/operator.yaml

OR

Install using Helm Charts

helm repo add litmuschaos https://litmuschaos.github.io/chaos-charts
helm repo update
helm install litmuschaos/litmus --namespace=litmus

For more details refer to the documentation at https://docs.litmuschaos.io