Main guide for the Gitlab Confluence integration for Confluence Cloud.

Short Video Demo

Objective

Provide useful information about Gitlab items like issues, pull requests, source code files, etc. The App supports Gitlab SaaS only.

This app supports only Gitlab SaaS on gitlab.com only.

If you need support of Gitlab Enterprise, please contact us.

Gitlab Confluence Macro

There is one macro that supports multiple Gitlab link types.

Gitlab merge request

You can enhance merge request visibility by using the link to a merge request in Confluence.

An example of the link is https://gitlab.com/moveworkforward/aCloudGuru-DynamoDB/-/merge_requests/1.

Gitlab issue

You need to use the link to the single Gitlab issue, for instance, https://gitlab.com/moveworkforward/aCloudGuru-DynamoDB/-/issues/2.

Gitlab repository

The Gitlab repository looks like this.

And need to use the link similar to https://gitlab.com/moveworkforward/aws-lambda-zombie-workshop.

Configuration by Confluence administrator

Getting the personal access token

You need to navigate to the Personal Access Tokens page in Gitlab.

You may need to contact Gitlab admin to generate you a token that has access to the required repositories.

First, you need to navigate to Preferences.

Second, you need to click on the Access Tokens.

Afterwards, you need to select the required expiration date and read_api scope.

Copy the token and insert this in Confluence.

How to generate personal access token (PAT)

Please follow this official guide from Gitlab.

In Confluence, navigate to Settings → Gitlab and enter your personal access token.

Potential issues

No valid token

You see this message when the configuration of Gitlab Confluence Connector has some issues. You need to contact your Confluence administrator to solve this issue.

No valid token can happen due to one of the following reasons:

  • your administrator did not configure Gitlab Confluence Connector at all. Action: create the token and insert it on the configuration page.

  • the token created has expired. Action: create a new token with the correct permissions and update the configuration.

  • the token does not provide correct permissions to read the required data. Action: create a new access token with the correct permissions and do not use personal resources.

No valid licence (not applicable for the free app)

You see this message when your Confluence instance does not have a valid license for Gitlab Confluence Connector. You need to contact your Confluence administrator(s) to solve this issue. The license can be bought or extended via Atlassian Marketplace.

It also can mean that your trial is over, and your organization needs to acquire a license for Gitlab Confluence Connector.

Disconnect

Navigate to Settings → Gitlab and click Disconnect.

Providing feedback and bug reports

Please contact us via the Service Desk.

Updated: