Features
After user reviews test run (goes through all issues, marks failures as passed or known issues) he gets ability to mark test run as reviewed. In this case test run on dashboard gets specific label 'reviewed'. Such label notifies all zafira users that test run was verified and appropriate measures have been taken.
User is free to add any comment to test run during reviewing process.
For example that's useful to left comments about bugs that were opened during verification or about some environment issues.
Note: If test run contains unresolved failures or skipped tests user will be forbidden to mark run as reviewed without leaving some comment.
With Slack integration properly configured user gets ability to have Slack notifications sent by Zafira. Such messages from Zafira will notify members of channel about test run completion, about its status and details.
Also user will have ability to send notification about reviewed test run posting its latest status.
Here are the list of things you need to do to enable integration with slack:
- Create new incoming web hook in Slack
- Go to 'Slack properties -> Apps & Integrations -> Manage -> Custom integrations -> Incoming WebHooks'
- Create new web hook, give it a name, description and copy hook's URL
- Add proper configuration in Zafira
- Go to Zafira settings
- Add new settings with name 'SLACK_WEB_HOOK_URL' and web hook URL as value
- Add new setting that will connect Zafira channel with Jenkins jobs you want to send notifications for. Amount of such settings is unlimited. Use next format: SLACK_NOTIF_CHANNEL_%%channel_name%%=job1;job2;job3
Example: let's imagine next setting 'SLACK_NOTIF_CHANNEL_zafira-slack-notif=record-web-tests;mmf-web-tests'.
That means after run is completed for jobs 'record-web-tests' or 'mmf-web-tests' status about completion will be posted to 'zafira-slack-notif' channel. Also user will have ability to send Slack notification for mentioned jobs manually
There are next ways of triggering slack notifications:
- If integration is properly configured (see Configuration paragraph) then notification will be posted to Slack automatically after run is completed
- If integration is properly configured and user marks test run as reviewed he will be proposed to notify slack channel about latest run status
- If integration is properly configured and test run is marked as reviewed user can send notification to Slack anytime
- If user left some comments during reviewing the run that comment will present in Slack notification as well
