README.md in prometheus-splash-0.3.0 vs README.md in prometheus-splash-0.4.0

- old
+ new

@@ -2,14 +2,27 @@ ![Splash logo](assets/images/logo_splash_reduce.png) _Orchestration and Supervision made easy_ SPLASH is **Supervision with Prometheus of Logs and Asynchronous tasks orchestration for Services or Hosts** +* Author : Romain GEORGES +* COPYright : BSD-2-Clause (c) 2020 Ultragreen Software +* Web : http://www.ultragreen.net +* Github : https://github.com/Ultragreen/prometheus-splash +* Rubygems : https://rubygems.org/gems/prometheus-splash +* DOC yardoc : https://www.rubydoc.info/gems/prometheus-splash/0.3.0 Prometheus Logs and Batchs supervision over PushGateway +[![GitHub version](https://badge.fury.io/gh/Ultragreen%2Fprometheus-splash.svg)](https://badge.fury.io/gh/Ultragreen%2Fprometheus-splash) +![Ruby](https://github.com/Ultragreen/prometheus-splash/workflows/Ruby/badge.svg) +[![Gem Version](https://badge.fury.io/rb/prometheus-splash.svg)](https://badge.fury.io/rb/prometheus-splash) +## Design + +![Splash Design](assets/images/splash_design.png) + ## Preconfiguration You need a Prometheus PushGateway operational, if the service not run on localhost:9091, See Prometheus server Configuration chapter to precise it in the configuration @@ -287,10 +300,17 @@ #### Prepare test with default configuration Commands or Commands Sequences must be defined in the main configuration file '/etc/splash.yml' +Command name must be Ruby Symbols, so in the YAML file, it must look like : + + :xxxxxx: + +_with x in the following list [A-Za-z_0-9]_ + + *Exemple* in default configuration : ### configuration of commands and scheduling :commands: :id_root: @@ -348,15 +368,26 @@ may include : * :user: the userneme to use to run the command * :on_failure: the name of an other defined command, to, execute if exit_code > 0 * :on_success: the name of an other defined command, to, execute if exit_code = 0 -* :schedule: (hash) a scheduling for daemon, after in this documentation, it support : +* :schedule: (Hash) a scheduling for daemon, after in this documentation, it support : * :every: "<timing>" ex: "1s", "3m", "2h" * :at: "<date/time>" ex: "2030/12/12 23:30:00" * :cron: * * * * * a cron format +* delegate_to: (Hash) a Slash delagation + * :host: the hostname of an other Confiugured Splash Node. + * :remote_command: a command defined in the remote Splash node Configuration +_Remarque_ : Command name, as precise earlier in this documentation is Ruby Symbols ':xxxxx'. +In YAML as a Hash key : ':xxxxxx: ', but as a value _':xxxxx'_, so the synthaxe for callbacks : + + :on_success: :xxxxxx + :on_failure: :xxxxxx + +It's the same for :remote_command + [Rufus Scheduler Doc](https://github.com/jmettraux/rufus-scheduler) if you want to inject default configuration, again as root : # splash conf set @@ -702,5 +733,10 @@ 1. Fork it 2. Create your feature branch (`git checkout -b my-new-feature`) 3. Commit your changes (`git commit -am 'Add some feature'`) 4. Push to the branch (`git push origin my-new-feature`) 5. Create new Pull Request + + +## Context + +*Massively made during COVID-19 containment : #StayAtHomeSoftware*