README ¶
ChaosCenter
ChaosCenter provides console and UI experience for managing, monitoring, and events around chaos workflows. Chaos workflows consist of a sequence of experiments run together to achieve the objective of introducing some kind of fault into an application or the Kubernetes platform.
Platforms Support
- GKE
- EKS
- Okteto Cloud
- AKS
- K3S
- Civo Cloud
- Kublr
- Minikube
- KIND
Pre-requisites
- Kubernetes 1.17 or later.
Installation
Applying k8s manifest
Litmus-2.13.0 (Stable) Cluster Scope manifest
kubectl apply -f https://raw.githubusercontent.com/litmuschaos/litmus/2.13.0/mkdocs/docs/2.13.0/litmus-2.13.0.yaml
Or
Litmus-2.13.0 (Stable) Namespaced Scope manifest.
#Create a namespace eg: litmus
kubectl create ns litmus
#Install CRDs, if SELF_AGENT env is set to TRUE
kubectl apply -f https://raw.githubusercontent.com/litmuschaos/litmus/master/mkdocs/docs/2.13.0/litmus-portal-crds-2.13.0.yml
#Install ChaosCenter
kubectl apply -f https://raw.githubusercontent.com/litmuschaos/litmus/master/mkdocs/docs/2.13.0/litmus-namespaced-2.13.0.yaml -n litmus
Or
Master (Latest) Cluster scope. Install in litmus namespace by default.
kubectl apply -f https://raw.githubusercontent.com/litmuschaos/litmus/master/litmus-portal/manifests/cluster-k8s-manifest.yml
Or
Master (Latest) Namespaced scope.
#Create a namespace eg: litmus
kubectl create ns litmus
#Install CRDs, if SELF_AGENT env is set to TRUE
kubectl apply -f https://raw.githubusercontent.com/litmuschaos/litmus/master/litmus-portal/manifests/litmus-portal-crds.yml
#Install ChaosCenter
kubectl apply -f https://raw.githubusercontent.com/litmuschaos/litmus/master/litmus-portal/manifests/namespace-k8s-manifest.yml -n litmus
Configuration Options for Cluster scope.
-
litmus-portal-operations-config
configmap.AgentNamespace: litmus
-
All environment variables.
Retrieving external url to access the litmus portal
GKE/Okteto Cloud/EKS
export NODE_NAME=$(kubectl -n $LITMUS_PORTAL_NAMESPACE get pod -l "component=litmusportal-frontend" -o=jsonpath='{.items[*].spec.nodeName}')
export EXTERNAL_IP=$(kubectl -n $LITMUS_PORTAL_NAMESPACE get nodes $NODE_NAME -o jsonpath='{.status.addresses[?(@.type=="ExternalIP")].address}')
export NODE_PORT=$(kubectl -n $LITMUS_PORTAL_NAMESPACE get -o jsonpath="{.spec.ports[0].nodePort}" services litmusportal-frontend-service)
echo "URL: http://$EXTERNAL_IP:$NODE_PORT"
Minikube
minikube -n $LITMUS_PORTAL_NAMESPACE --url litmusportal-frontend-service
Note: Default username: admin
and password: litmus
User Guide for ChaosCenter
ChaosCenter provides console or UI experience for managing, monitoring, and events round chaos workflows. Chaos workflows consist of a sequence of experiments run together to achieve the objective of introducing some kind of fault into an application or the Kubernetes platform.
View the User Guide here
Local Development Guide for ChaosCenter
Local Development Guide for ChaosCenter can be found here
Upgrade from 2.12.0 to 2.13.0
You can upgrade using the steps from section here
Uninstallation
You can uninstall using the steps from section here