Create tickets from Suptask to GitLab
Learn how to set up the integration with GitLab
Overview
The Suptask integration with GitLab enables you to escalate tickets directly from Slack to GitLab. With a single reaction emoji (the :tornado: 🌪️) you'll be able to create tickets to your choice of repositories, directly from a Suptask ticket in Slack.
Prerequisites
The account name of your GitLab account. Can either be an organization or personal account. In this example the account name is acme.inc, the repository is core (case-sensitive) and the server is https://gitlab.comExample: https://gitlab.com/acme.inc/core
Create an access token for your user account in GitLab. You can find it from your user profile or by navigating to your user account > Preferences > Access tokens. Access tokens can also be created for Projects. In such a case, make sure the Role is set to minimum Developer. The minimum Scope for the token needs to be the following:
apiStore the token once you have it. You will need it when configuring the integration within Suptask.
Set up the GitLab integration
Navigate to the Integrations page in your Account.
Press on +GitLab button to create a new Gitlab integration.
Give it a name and specify what Suptask ticket forms to enable the integration for. Tickets initiated through forms are then enabled with the trigger to create a ticket within the integration system (in this case GitLab).
Next you will need to create credentials for your integration. Credentials can be shared across several integrations of the same type. Here you will need your GitLab server URL and the Access token that you stored from your Gitlab account.
Proceed to the next step and enter the GitLab account name that you collected from the preparation step.
Specify what repositories in GitLab you want to enable the integration for. Make sure you enter the exact name, case sensitive. If you enter the incorrect name, the integration connection will not work.
Finally specify if you want to add any default GitLab labels to the tickets that are created from Suptask.
Done! The integration is now activated.
Using the GitLab integration with Suptask
Make sure you are within the Responder channel of your Inbox.
On one of the received tickets in the channel, add the :tornado: 🌪️ reaction emoji to the ticket message in the channel. See below for a sample screenshot.
This will trigger a selection where you can specify to what integration target you want to send the new ticket, the same as configured in the previous step.
From here you will be able to edit the Description and Title of the issue sent to Gitlab. The Description field is pre-populated with a default template which you can edit according to your needs. Use the Suptask ticket placeholders to include Suptask ticket information automatically into the Gitlab issue. Especially the ticketUrl placeholder is valuable as it takes you directly to the Suptask ticket in Slack as a reference.
Gitlab supports quick actions which can help you perform further actions by entering these directly at the end of the Description field. This allows you to for example set specific labels for the created issue. Read more here Example screenshot on adding the the :tornado: 🌪️ to a ticket message in the responder channel:
After creating a related ticket in GitLab, the ticket message thread in Slack will receive the GitLab issue url, linking the both tickets together.
Last updated
