mirror of
https://github.com/krkn-chaos/krkn.git
synced 2026-08-25 09:27:36 +00:00
Naga Ravi Chaitanya Elluri
674eb74a75
This commit enables users to start Kraken to act as listener by setting the signal to PAUSE in the config to get the cluster to a desired test or run any setup before injecting chaos by setting the signal to RUN. This helps in cases where we have test cases that need to coordinate the chaos at a desired time depending on the state of the cluster/test run.
59 lines
1.8 KiB
Markdown
59 lines
1.8 KiB
Markdown
### Signaling to Kraken
|
|
This functionality allows a user to be able to pause or stop the kraken run at any time no matter the number of iterations or daemon_mode set in the config
|
|
|
|
If publish_kraken_status is set to True in the config, kraken will start up a connection to a url at a certain port to decide if it should continue running
|
|
|
|
By default it will get posted to http://0.0.0.0:8081/
|
|
|
|
An example use case for this feature would be coordinating kraken runs based on the status of the service installation or load on the cluster
|
|
|
|
|
|
|
|
#### States
|
|
There are 3 states in the kraken status
|
|
|
|
```PAUSE```: When the Kraken signal is 'PAUSE', this will pause the kraken test and wait for the wait_duration until the signal returns to RUN
|
|
|
|
```STOP```: When the Kraken signal is 'STOP', end the kraken run and print out report
|
|
|
|
```RUN```: When the Kraken signal is 'RUN', continue kraken run based on iterations
|
|
|
|
|
|
|
|
#### Configuration
|
|
|
|
In the config you need to set these parameters to tell kraken which port to post the kraken run status to
|
|
As well if you want to publish and stop running based on the kraken status or not
|
|
The signal is set to `RUN` by default meaning it will continue to run the scenarios, it can set to `PAUSE` for Kraken to act as listener and wait until set to `RUN` before injecting chaos
|
|
```
|
|
port: 8081
|
|
publish_kraken_status: True
|
|
signal_state: RUN
|
|
```
|
|
|
|
|
|
#### Setting Signal
|
|
|
|
See [set_stop_signal.py](https://github.com/cloud-bulldozer/kraken/tree/master/set_stop_signal.py) for an example of how to reset the kraken status during kraken execution
|
|
|
|
Make sure to set the correct port number in your set_stop_signal script
|
|
|
|
|
|
|
|
##### Url Examples
|
|
To stop run:
|
|
|
|
```
|
|
curl -X POST http:/0.0.0.0:8081/STOP
|
|
```
|
|
|
|
To pause run:
|
|
```
|
|
curl -X POST http:/0.0.0.0:8081/PAUSE
|
|
```
|
|
|
|
To start running again:
|
|
```
|
|
curl -X POST http:/0.0.0.0:8081/RUN
|
|
```
|