Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/thyrlian/agilenotifier
Agile Notifier - an easy way of monitoring Agile SW Engineering, including CI (Continuous Integration), SCM (Source Control Management), and ITS (Issue Tracking System).
https://github.com/thyrlian/agilenotifier
Last synced: 16 days ago
JSON representation
Agile Notifier - an easy way of monitoring Agile SW Engineering, including CI (Continuous Integration), SCM (Source Control Management), and ITS (Issue Tracking System).
- Host: GitHub
- URL: https://github.com/thyrlian/agilenotifier
- Owner: thyrlian
- License: mit
- Created: 2013-06-11T06:11:37.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2016-02-28T14:35:10.000Z (over 8 years ago)
- Last Synced: 2024-10-12T18:54:33.467Z (about 1 month ago)
- Language: Ruby
- Size: 88.9 KB
- Stars: 16
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
AgileNotifier
=============
[](http://badge.fury.io/rb/agile_notifier)
[](https://codeclimate.com/github/thyrlian/AgileNotifier)
[](https://travis-ci.org/thyrlian/AgileNotifier)
Agile Notifier - an easy way of monitoring Agile SW Engineering by auralization change. It supports most of the popular tools including **CI** (Continuous Integration), **SCM** (Source Control Management), and **ITS** (Issue Tracking System). Of course you can integrate more tools as you want. And the simple beautiful DSL syntax gives you a rocket start.
In a modern agile team, members would like to be notified immediately once their Continuous Integration job fails (but building process usually takes quite a while). That's the initial idea of this tool.
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
```ruby
AgileNotifier::Configuration.set do
ci_url 'http://x.x.x.x:8080'
ci_job 'your-project-continuous-build'
ci_get 'Jenkins'
scm_url 'https://github.xyzcompany.com'
scm_repo user: 'your_user_name', repo: 'your_repository_name'
# scm_auth is optional, depends on if your github API access requires authentication
# if authentication is required, please choose either username & password or OAuth access token (latter one is recommended)
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://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'
its_get 'Jira'
its_set_wip 'BAM', 'project = BAM AND status = Resolved AND resolution = Unresolved', 3
its_set_wip 'XXX', 'project = XXX AND status = Resolved AND resolution = Unresolved', 5
speak 'en'
play 'Boing' # Mac OSX TTS voice name(optional field), unnecessary for other OS
alert_on_fail
alert_on_fix
alert_on_unstable
alert_on_wip
end
```
## 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```
##License
Copyright (c) 2016 Jing Li. See the LICENSE file for license rights and limitations (MIT).