GitLab Project

This connection type connects a GitLab project (e.g. https://gitlab.matrix.org/matrix-org/olm) to a room.

Setting up

To set up a connection to a GitLab project in a new room:

(NB you must have permission to bridge GitLab repositories before you can use this command, see auth.)

Create a new, unencrypted room. It can be public or private.
Invite the bridge bot (e.g. @hookshot:example.com).
Give the bridge bot moderator permissions or higher (power level 50) (or otherwise configure the room so the bot can edit room state).
Send the command !hookshot gitlab project https://mydomain/my/project.
If you have permission to bridge this repo, the bridge will respond with a confirmation message. (Users with Developer permissions or greater can bridge projects.)
If you have configured the bridge with a publicUrl inside gitlab.webhook, it will automatically provision the webhook for you.
Otherwise, you'll need to manually configure the webhook to point to your public address for the webhooks listener.

This connection supports a few options which can be defined in the room state:

Option	Description	Allowed values	Default
ignoreHooks	Choose to exclude notifications for some event types	Array of: Supported event types	empty
commandPrefix	Choose the prefix to use when sending commands to the bot	A string, ideally starts with "!"	`!gh`
pushTagsRegex	Only mention pushed tags which match this regex	Regex string	empty
prDiff	Show a diff in the room when a PR is created, subject to limits	`{enabled: boolean, maxLines: number}`	`{enabled: false}`
includingLabels	Only notify on issues matching these label names	Array of: String matching a label name	empty
excludingLabels	Never notify on issues matching these label names	Array of: String matching a label name	empty

This connection supports sending messages when the following actions happen on the repository.