- Accessing integrations
- Integrations listing
- Push hooks limit
- Services templates
- Troubleshooting integrations
- Contributing to integrations
Integrations
Integrations allow you to integrate GitLab with other applications. They are a bit like plugins in that they allow a lot of freedom in adding functionality to GitLab.
Accessing integrations
You can find the available integrations under your project’s Settings ➔ Integrations page.
There are more than 20 integrations to integrate with. Click on the one that you want to configure.
Below, you will find a list of the currently supported ones accompanied with comprehensive documentation.
Integrations listing
Click on the service links to see further configuration instructions and details.
Service | Description | Service Hooks |
---|---|---|
Asana | Asana - Teamwork without email | No |
Assembla | Project Management Software (Source Commits Endpoint) | No |
Atlassian Bamboo CI | A continuous integration and build server | Yes |
Buildkite | Continuous integration and deployments | Yes |
Bugzilla | Bugzilla issue tracker | No |
Campfire | Simple web-based real-time group chat | No |
Custom Issue Tracker | Custom issue tracker | No |
Discord Notifications | Receive event notifications in Discord | No |
Drone CI | Continuous Integration platform built on Docker, written in Go | Yes |
Emails on push | Email the commits and diff of each push to a list of recipients | No |
External Wiki | Replaces the link to the internal wiki with a link to an external wiki | No |
Flowdock | Flowdock is a collaboration web app for technical teams | No |
Generic alerts | Receive alerts on GitLab from any source | No |
GitHub | Sends pipeline notifications to GitHub | No |
Hangouts Chat | Receive events notifications in Google Hangouts Chat | No |
HipChat | Private group chat and IM | No |
Irker (IRC gateway) | Send IRC messages, on update, to a list of recipients through an Irker gateway | No |
Jira | Jira issue tracker | No |
Jenkins | An extendable open source continuous integration server | Yes |
JetBrains TeamCity CI | A continuous integration and build server | Yes |
Mattermost slash commands | Mattermost chat and ChatOps slash commands | No |
Mattermost Notifications | Receive event notifications in Mattermost | No |
Microsoft teams | Receive notifications for actions that happen on GitLab into a room on Microsoft Teams using Office 365 Connectors | No |
Packagist | Update your project on Packagist, the main Composer repository | Yes |
Pipelines emails | Email the pipeline status to a list of recipients | No |
Slack Notifications | Send GitLab events (e.g. issue created) to Slack as notifications | No |
Slack slash commands | Use slash commands in Slack to control GitLab | No |
GitLab Slack application | Use Slack’s official application | No |
PivotalTracker | Project Management Software (Source Commits Endpoint) | No |
Prometheus | Monitor the performance of your deployed apps | No |
Pushover | Pushover makes it easy to get real-time notifications on your Android device, iPhone, iPad, and Desktop | No |
Redmine | Redmine issue tracker | No |
Unify Circuit | Receive events notifications in Unify Circuit | No |
YouTrack | YouTrack issue tracker | No |
Push hooks limit
Introduced in GitLab 12.4.
If a single push includes changes to more than three branches or tags, services
supported by push_hooks
and tag_push_hooks
events won’t be executed.
The number of branches or tags supported can be changed via
push_event_hooks_limit
application setting.
Services templates
Services templates is a way to set some predefined values in the Service of your liking which will then be pre-filled on each project’s Service.
Read more about Services templates in this document.
Troubleshooting integrations
Some integrations use service hooks for integration with external applications. To confirm which ones use service hooks, see the integrations listing. GitLab stores details of service hook requests made within the last 2 days. To view details of the requests, go to the service’s configuration page.
The Recent Deliveries section lists the details of each request made within the last 2 days:
- HTTP status code (green for 200-299 codes, red for the others,
internal error
for failed deliveries) - Triggered event
- URL to which the request was sent
- Elapsed time of the request
- Relative time in which the request was made
To view more information about the request’s execution, click the respective View details link. On the details page, you can see the data sent by GitLab (request headers and body) and the data received by GitLab (response headers and body).
From this page, you can repeat delivery with the same data by clicking Resend Request.
Contributing to integrations
Because GitLab is open source we can ship with the code and tests for all plugins. This allows the community to keep the plugins up to date so that they always work in newer GitLab versions.
For an overview of what integrations are available, please see the project_services source directory.
Contributions are welcome!
Help and feedback
If there's something you don't like about this feature
To propose functionality that GitLab does not yet offer
To further help GitLab in shaping new features
If you didn't find what you were looking for
If you want help with something very specific to your use case, and can use some community support
POST ON GITLAB FORUM
If you have problems setting up or using this feature (depending on your GitLab subscription)
REQUEST SUPPORT
To view all GitLab tiers and features or to upgrade
If you want to try all features available in GitLab.com
If you want to try all features available in GitLab self-managed
If you spot an error or a need for improvement and would like to fix it yourself in a merge request
EDIT THIS PAGE
If you would like to suggest an improvement to this doc