🎮 What our GitLab integration can do
1️⃣ Export your incident follow-ups to GitLab
You can export your follow-ups to GitLab. We'll sync the status of your tasks, so you can work in GitLab without worrying about updating statuses manually in incident.io!
You'll see the option to export your follow-ups from the incident homepage:
2️⃣ Link GitLab issues to your follow-ups.
You can copy the reference of issues you already have and linked them back to your incident.io follow-ups.
3️⃣ Bulk Exports through the Follow-ups tab.
Select all the follow-ups you'd like to publish in one go and export to GitLab through bulk actions.
4️⃣ Attach GitLab Merge Requests to incidents from Slack
You can attach GitLab MRs to your incident directly from the incident channel.
5️⃣ Attach GitLab MRs to incidents from GitLab
You can also attach an MR by mentioning the incident number in the MR title or source branch.
🛠 Setting Up
Adding GitLab to incident.io is simple.
⚡ You'll need a GitLab top-level group owner to perform some of these steps.
1️⃣ Create a Service Account user in GitLab
Follow GitLab's guide to creating a service account. We recommend using 'incident.io' for the name, since this will show up in the UI on issues and comments created by the integration.
🔈 Make sure the bot user has access to create and edit issues, and view and comment on merge requests in all relevant projects.
We recommend assigning the Reporter role to your incident.io service account user.
🔗 See GitLab.com: Permissions and roles
2️⃣ Create a personal access token with no expiry
Follow GitLab's guide here.
For scopes, pass api. For name use 'incident.io integration'.
Note the token value for the next step!
3️⃣ Connect the integration
Go to Settings → Integrations, click on GitLab, then Connect.
Paste in the access token created in step 2️⃣ and click Connect. That's it 🎉
If you're using self-managed GitLab, make sure traffic from our IPs can reach your instance.
➡️ Next up
We recommend adding a Group Hook in GitLab, which allows us to sync changes in GitLab back to incident.io. Read our setup guide here.
If you run into any issues, get in touch 👋