README.md in agile_notifier-2.1.4 vs README.md in agile_notifier-3.0.0

- old
+ new

@@ -11,11 +11,11 @@ The joy of this tool is that, whenever a build fails, it can blame whoever submitted the commit (or praises the committer who fixed it), in whatever language you want, and even the sentenses can be randomly chosen each time :) Have fun with it! -## Examples of Usage: +## Examples of Usage ```ruby AgileNotifier::Configuration.set do ci_url 'http://x.x.x.x:8080' ci_job 'your-project-continuous-build' ci_get 'Jenkins' @@ -27,11 +27,11 @@ scm_auth username: 'github_login_username', password: 'github_login_password' # optional scm_auth token: 'a1b2c3d4e5f6f0f0f0f0f0f0f0f0f6e5d4c3b2a1' # optional scm_get 'Github', enterprise: true # for non-enterprise version - # scm_url 'https://api.github.com' + # scm_url 'https://github.com' # scm_repo user: 'your_user_name', repo: 'your_repository_name' # scm_get 'Github' its_url 'https://jira.atlassian.com' its_auth 'jira_username', 'jira_password' @@ -47,10 +47,26 @@ alert_on_unstable alert_on_wip end ``` -## Notes: +## Deploy to CI +First create a config file based on above DSL syntax. (let's say the file name is [*your_own_config*].rb) +### Jenkins +* The **easy** way: + * Create [*The_Notification_Job*] + * Configure -> Build -> Execute shell: + * ```ruby [your_own_config].rb``` + * Your Main Job + * Configure -> Add post-build action -> Build other projects -> Projects to build -> [*The_Notification_Job*] +* The **hard** but **precise** way: (imagine there are a few developers pushing all the time, which makes your CI build one after one without rest) + * Create [The_Notification_Job] + * Configure -> Build -> Execute shell: + * ```ruby [your_own_config].rb -b $UPSTREAM_BUILD_NUMBER``` + * Your Main Job + * Configure -> Add post-build action -> Trigger parameterized build on other projects -> Projects to build -> [*The_Notification_Job*] -> Add Parameters -> Predefined parameters -> ```UPSTREAM_BUILD_NUMBER=${BUILD_NUMBER}``` + +## Notes * TTS (Text To Speech) on Linux used here has two dependencies: * TTS service benefits from online MARY TTS Web Client: http://mary.dfki.de:59125/ While it has limited languages support, please check before use. * play command comes from package sox which is not pre-installed, you have to install manually beforehand by: * ```sudo apt-get install sox libsox-fmt-all```