This plugin aims to provide a connection between confluence and a GitLab server. It enables macros to view issues, builds, merge requests and project information.
GitLab connection configuration
Before you can start to use the macros, make sure the credentials inserted correctly in the admin panel (as seen below)
The credentials are the url of the server and an private api key. The server has to be reachable from the confluence server, in order to make the macros work properly.
The private api key can be generated on the GitLab server (there it is called personal access token). You can find it under Profile Settings (click on your avatar icon on the right) → Access Tokens.
At this place you can generate a unique access token for the GitLab Api Connector plugin. Be aware that the personal access token is only shown once after the creation.
Although you could also use the private token which can be found under account, consider using an access token created as described above, but for older versions of GitLab (before version 8.8), this might be
an alternative, as there you cannot create an access token.
View Issues
You can show the list of issues to a selected project.
View a single issue
You can choose a project and an issue.
View builds
Show the builds log of your project via the Gitlab Builds macro. You can choose the projects and the number of builds which should be shown via the macro.
View merge requests
Show all merge requests of a project
View project information
Show detailed project information
List all projects
You can list all projects via the List GitLab projects macro. You can choose between the options of showing more details (number of stars and forks, labels) than the title and showing the last status of the builds.
