Our Gitlab integration lets you create and link Gitlab issues right from your Harvestr Discoveries. You will then be able to follow the evolution of these issues and their status in Gitlab, without leaving Harvestr.
Prerequisites
In order to use our Gitlab integration, all you need is:
a Gitlab account with one of the following permissions: "Owner", "Maintainer", or "Developer"
a Harvestr account
How to integrate Harvestr to your company's Gitlab account
Connecting your Gitlab account to Harvestr is super simple:
go to your Harvestr settings -> integrations -> Gitlab
click on "Connect to Gitlab"
in the OAuth window that pops up, log in to your Gitlab account
authorize Harvestr and grant us the rights that are listed
Once this is done, you will be automatically redirected to your Gitlab integration settings in Harvestr and you should now see the option "Remove Gitlab integration".
How to use the Gitlab integration in Harvestr
Now that the integration is set up, you will see a Gitlab section appear in each and every Discovery in Harvestr.
You will now be able to :
create and link one or more new Gitlab issues to a Discovery
link one or more existing Gitlab issues to a Discovery
Create and link one or more new Gitlab issues to a Discovery
Once you have decided to launch a Discovery to production, you can create issues in Gitlab that correspond to what needs to be developed.
When you press "Create issue" in a Discovery in Harvestr, it pops up a window where you will be able to enter the attributes of the issue you want to create, namely : its project, its type, its status, one assignee, a summary and a description.
Once the issue is opened, it will be created in Gitlab with the attributes you have entered and with an additional link to the Discovery in Harvestr. This gives your software team access to the valuable content that's in your Discovery, like user feedback for example.
In your Discovery in Harvestr, you will also have the link to the newly created issue and you will be able to keep track of the evolution of its statuts in Gitlab.
2. Link one or more existing Gitlab issues to a Discovery
Sometimes, you will also want to link Gitlab issues that already exist to a Harvestr Discovery.
You can do that by clicking on the "Link issue" button in your Discovery. This will open a search bar where you will be able to search a Gitlab issue by its name or by its key. The search by key only works when you type the exact entire key in the search bar.
Once you have linked the issue to your Discovery, you will also be able to follow the evolution of its status from Harvestr.
Note: you can link as many issues as you like to a Discovery.
If you have requests or ideas about how we could improve our Gitlab integration to fit your workflow better, shoot us a message!