The Tuleap StackStorm pack allows you to link a Tuleap instance to many external tools, to share data and automate actions between each other.
This post reminds you what is StackStorm and what's a pack. Then, I'll share how we built the Tuleap StackStorm pack and how you can use it, for instance, moving issues from Github to Tuleap.
StackStorm is an open-source automation platform that will connect all of your app and services to be able to work together.
As you know, Tuleap is a powerful open-source tool that allows you to build better software together, offering a large panel of modules for planning, issue tracking, code versioning, code review and document management. By definition, creating a software involved various people, several tools. So being compatible with a platform like StackStorm can help you connect your Tuleap with other tools.
To be compatible with StackStorm, each tool have to provide a pack. A pack is a component that will add multiple actions to StackStorm. These actions can also be used in a workflow to chain multiple actions from multiple services to work together.
Sensors are the StackStorm component made to listen external events. They can listen for a specific webhook for instance. Once this event is reached into StackStorm, the predefined action can be triggered and processed.
How we build the Tuleap StackStorm pack
To build the Tuleap StackStorm pack, we follow the StackStorm development guildelines.
- Python scripts with the StackStorm interfaces
- Following the pack filesystem layout
- Contribution the pack to the exchange platform for public deployment and usage
Tuleap StackStorm pack is the result of a collaborative work between Tuleap community members : contributors and maintainers. We would like to take the opportunity of this post to do thank Djuro Drljaca , moreauxh, djurod and andrejn their work and help. Given that the scripts are made with python (and with heart <3) , we were able to use the Tuleap REST Api client developed by the community.After many discussions, we've provided more that 20 commits to improve the tool and make it compatible with the StackStorm requirements. We've worked on:
- Compatibility python 2.7 and 3.0+
- Rework on REST call
- Add new routes
- Adding unit tests
Moving Github issues to Tuleap
How to use this pack ? You can use to move or synchronize your issues from Github to Tuleap for instance. During the TuleapCon 2017 we demonstrated the Github-Tuleap connection live.
On the technical side, this workflow works with the following structure
Other use cases of the Tuleap StackStorm pack
You can connect Tuleap to various tools using the Tuleap pack and others from the StackStorm marketplace, named StackStorm Exchange . These are examples of other workflows you could automate:
- Connect your Tuleap to Bitbucket: when a task is created in Tuleap, a Bitbucket repo is created.
- Connect your Tuleap to a server and Ansible: when an issue is opened in Tuleap, a server is set up (in Amazon, Digital Ocean, wherever you want). It is automatically configured so that the user can access to it.
- Connect your Tuleap to Docker: when a release artifact is created in Tuleap, a Docker image is build and published in the store.
Check what it is possible to do with each pack, and easily plug Tuleap and other tools.
Install the Tuleap StackStorm pack
The Tuleap StackStorm pack is now part of the official . You can now create your own workflows and integrations between Tuleap and all your favorite tools ;) Install it by simply doing :
```bash st2 pack install tuleap ```
Need help? Share your experience.