Skip to main content
Skip table of contents

Gitlab Confluence Connector Cloud

Main guide for the Gitlab Confluence integration for Confluence Cloud.

GitLab for Confluence Cloud is accessible at Atlassian Marketplace.

Objective

Provide helpful information about Gitlab items like issues, pull requests, source code files, etc. The App supports Gitlab SaaS and GitLab On-Premises.

GitLab On-Premises

To use the GitLab On-Premise instance together with Gitlab for the Confluence Cloud app, you need to use an internet-accessible URL for the configuration and macro URLs.

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 (project) link looks like this. Here you can find the project name, the number of branches, stars and forks.

You need to use the link similar to this https://gitlab.com/moveworkforward/learn-gitlab.

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 and the base URL.

You can change the PAT and the base URL together. For security reasons, it is impossible to change those separately.

For the base URL, you need to use https://gitlab.com for the SaaS GitLab offering and the internet-accessible GitLab URL for the On-Premise GitLab deployments.

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

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

You may need to start the trial if you have not started it before.

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:

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.