Version: 2.14.0

Installing Chaos Delegates in non interactive mode

Usage: Litmusctl 0.14.0

Notes:
For litmusctl 0.14.0 or latest
Compatible with Litmus 2.9.0 or latest

litmusctl Syntax

litmusctl has a syntax to use as follows:

litmusctl [command] [TYPE] [flags]

Command: refers to what you do want to perform (connect, create, get and config)
Type: refers to the feature type you are performing a command against (chaos-delegate, project etc.)
Flags: It takes some additional information for resource operations. For example, --installation-mode allows you to specify an installation mode.

Litmusctl is using the .litmusconfig config file to manage multiple accounts

If the --config flag is set, then only the given file is loaded. The flag may only be set once and no merging takes place.
Otherwise, the ${HOME}/.litmusconfig file is used, and no merging takes place.

Litmusctl supports both interactive and non-interactive(flag based) modes.

Only litmusctl connect chaos-delegate command needs --non-interactive flag, other commands don't need this flag to be in non-interactive mode. If mandatory flags aren't passed, then litmusctl takes input in an interactive mode.

Installation modes

Litmusctl can install a Chaos Delegate in two different modes.

cluster mode: With this mode, the Chaos Delegate can run the chaos in any namespace. It installs appropriate cluster roles and cluster role bindings to achieve this mode. It can be enabled by passing a flag --installation-mode=cluster
namespace mode: With this mode, the Chaos Delegate can run the chaos in its namespace. It installs appropriate roles and role bindings to achieve this mode. It can be enabled by passing a flag --installation-mode=namespace

Note: With namespace mode, the user needs to create the namespace to install the Chaos Delegate as a prerequisite.

Minimal steps to connect a Chaos Delegate

To setup an account with litmusctl

litmusctl config set-account --endpoint="" --username="" --password=""

To create an Chaos Delegate with an existing project
Note: To get project-id. Apply litmusctl get projects

litmusctl connect chaos-delegate --name="" --project-id="" --non-interactive

Flags for `connect chaos-delegate` command

Flag	Short Flag	Type	Description
--description		String	Set the Chaos Delegate description (default "---")
--name		String	Set the name of Chaos Delegate which should be unique
--skip-ssl		Boolean	Set whether Chaos Delegate will skip ssl/tls check (can be used for self-signed certs, if cert is not provided in portal) (default false)
--chaos-delegate-type		String	Set the chaos-delegate-type to external for external Chaos Delegates \| Supported=external/internal (default "external")
--installation-mode		String	Set the installation mode for the kind of Chaos Delegate \| Supported=cluster/namespace (default "cluster")
--kubeconfig	-k	String	Set to pass kubeconfig file if it is not in the default location ($HOME/.kube/config)
--namespace		String	Set the namespace for the Chaos Delegate installation (default "litmus")
--node-selector		String	Set the node-selector for Chaos Delegate components \| Format: key1=value1,key2=value2)
--non-interactive	-n	String	Set it to true for non interactive mode \| Note: Always set the boolean flag as --non-interactive=Boolean
--ns-exists		Boolean	Set the --ns-exists=false if the namespace mentioned in the --namespace flag is not existed else set it to --ns-exists=true \| Note: Always set the boolean flag as --ns-exists=Boolean
--platform-name		String	Set the platform name. Supported- AWS/GKE/Openshift/Rancher/Others (default "Others")
--sa-exists		Boolean	Set the --sa-exists=false if the service-account mentioned in the --service-account flag is not existed else set it to --sa-exists=true \| Note: Always set the boolean flag as --sa-exists=Boolean"
--service-account		String	Set the service account to be used by the Chaos Delegate (default "litmus")
--config		String	config file (default is $HOME/.litmusctl)

Steps to create a chaos scenaro

To setup an account with litmusctl

litmusctl config set-account --endpoint="" --username="" --password=""

To create a Chaos Scenario by passing a manifest file
Note:
- To get project-id, apply litmusctl get projects
- To get chaos-delegate-id, apply litmusctl get chaos-delegates --project-id=""

litmusctl create chaos-scenario -f custom-chaos-scenario.yml --project-id="" --chaos-delegate-id=""

Additional commands

To view the current configuration of .litmusconfig, type:

litmusctl config view

Output:

accounts:
- users:
  - expires_in: "1626897027"
    token: eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE2MjY4OTcwMjcsInJvbGUiOiJhZG1pbiIsInVpZCI6ImVlODZkYTljLTNmODAtNGRmMy04YzQyLTExNzlhODIzOTVhOSIsInVzZXJuYW1lIjoiYWRtaW4ifQ.O_hFcIhxP4rhyUN9NEVlQmWesoWlpgHpPFL58VbJHnhvJllP5_MNPbrRMKyFvzW3hANgXK2u8437u
    username: admin
  - expires_in: "1626944602"
    token: eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE2MjY5NDQ2MDIsInJvbGUiOiJ1c2VyIiwidWlkIjoiNjFmMDY4M2YtZWY0OC00MGE1LWIzMjgtZTU2ZDA2NjM1MTE4IiwidXNlcm5hbWUiOiJyYWoifQ.pks7xjkFdJD649RjCBwQuPF1_QMoryDWixSKx4tPAqXI75ns4sc-yGhMdbEvIZ3AJSvDaqTa47XTC6c8R
    username: litmus-user
  endpoint: https://preview.litmuschaos.io
apiVersion: v1
current-account: https://preview.litmuschaos.io
current-user: litmus-user
kind: Config

To get an overview of the accounts available within .litmusconfig, use the config get-accounts command:

litmusctl config get-accounts

Output:

CURRENT  ENDPOINT                         USERNAME  EXPIRESIN
         https://preview.litmuschaos.io   admin     2021-07-22 01:20:27 +0530 IST
*        https://preview.litmuschaos.io   raj       2021-07-22 14:33:22 +0530 IST

To alter the current account use the use-account command with the --endpoint and --username flags:

litmusctl config use-account --endpoint="" --username=""

To create a project, apply the following command with the --name flag:

litmusctl create project --name=""

To view all the projects with the user, use the get projects command.

litmusctl get projects

Output:

PROJECT ID                                PROJECT NAME       CREATEDAT
50addd40-8767-448c-a91a-5071543a2d8e      Developer Project  2021-07-21 14:38:51 +0530 IST
7a4a259a-1ae5-4204-ae83-89a8838eaec3      DevOps Project     2021-07-21 14:39:14 +0530 IST

To get an overview of the Chaos Delegates available within a project, issue the following command.

litmusctl get chaos-delegates --project-id=""

Output:

CHAOS DELEGATE ID                            CHAOS DELEGATE NAME          STATUS     REGISTRATION
55ecc7f2-2754-43aa-8e12-6903e4c6183a   chaos-delegate-1            ACTIVE     REGISTERED
13dsf3d1-5324-54af-4g23-5331g5v2364f   chaos-delegate-2            INACTIVE   NOT REGISTERED

To disconnect a Chaos Delegate, issue the following command..

litmusctl disconnect chaos-delegate <chaos-delegate-id> --project-id=""

Output:

🚀 Chaos Delegate successfully disconnected.

To list the created Chaos Scenarios within a project, issue the following command.

litmusctl get chaos-scenarios --project-id=""

Output:

CHAOS SCENARIO ID                         CHAOS SCENARIO NAME                   CHAOS SCENARIO TYPE     NEXT SCHEDULE CHAOS DELEGATE ID                             CHAOS DELEGATE NAME LAST UPDATED BY
9433b48c-4ab7-4544-8dab-4a7237619e09 custom-chaos-scenario-1627980541 Non Cron Chaos Scenario None          f9799723-29f1-454c-b830-ae8ba7ee4c30 Self-Chaos-delegate admin

Showing 1 of 1 Chaos Scenarios

To list all the Chaos Scenario runs within a project, issue the following command.

litmusctl get chaos-scenario-runs  --project-id=""

Output:

CHAOS SCENARIO RUN ID                      STATUS  RESILIENCY SCORE CHAOS SCENARIO ID                          CHAOS SCENARIO NAME                    TARGET CHAOS DELEGATE LAST RUN                 EXECUTED BY
8ceb712c-1ed4-40e6-adc4-01f78d281506 Running 0.00             9433b48c-4ab7-4544-8dab-4a7237619e09 custom-chaos-scenario-1627980541 Self-Chaos-Delegate   June 1 2022, 10:28:02 pm admin

Showing 1 of 1 Chaos Scenario runs

To describe a particular Chaos Scenario, issue the following command.

litmusctl describe chaos-scenario <chaos-scenario-id> --project-id=""

Output:

apiVersion: argoproj.io/v1alpha1
kind: Workflow
metadata:
    creationTimestamp: null
    labels:
        cluster_id: f9799723-29f1-454c-b830-ae8ba7ee4c30
        subject: custom-chaos-scenario_litmus
        workflow_id: 9433b48c-4ab7-4544-8dab-4a7237619e09
        workflows.argoproj.io/controller-instanceid: f9799723-29f1-454c-b830-ae8ba7ee4c30
    name: custom-chaos-scenario-1627980541
    namespace: litmus
spec:
...

To delete a particular Chaos Scenario, issue the following command.

litmusctl delete chaos-scenario <chaos-scenario-id> --project-id=""

Output:

🚀 Chaos Scenario successfully deleted.

For more information related to flags, Use litmusctl --help.

litmusctl Syntax​

Installation modes​

Minimal steps to connect a Chaos Delegate​

Flags for connect chaos-delegate command​

Steps to create a chaos scenaro​

Additional commands​

Learn More​

litmusctl Syntax

Installation modes

Minimal steps to connect a Chaos Delegate

Flags for `connect chaos-delegate` command

Steps to create a chaos scenaro

Additional commands

Learn More