FeatureBridgeDocs
v2.4.0MarketplaceSupport

Git sync

Connect GitLab

For projects on gitlab.com. You need admin rights in Jira and the Maintainer role in the GitLab project (needed to create the webhook).

1. Create a token on GitLab

  1. Open your avatar → Preferences → Access tokens.

  2. Click the arrow next to Add new token and choose Legacy token.

    GitLab's new fine-grained tokens are in beta; use the legacy type for now.

  3. Enter a name (FeatureBridge) and an expiration date.

  4. Under scopes, select api only.

  5. Click Create token and copy it (it starts with glpat-).

Premium or Ultimate

You can use a project access token instead (project → Settings → Access tokens, role Maintainer, scope api). It only works for that project. On the Free tier GitLab.com doesn't offer project access tokens.

2. Connect it in Jira

  1. Open Jira settings → Apps → FeatureBridge.

  2. Fill in the Git sync form:

    • Git host: GitLab (gitlab.com)
    • Group or user: the path before the project name, for example acme in gitlab.com/acme/shop. For subgroups use acme/team.
    • Repository name: the project path, for example shop
    • Branch and Folder with .feature files
    • Access token: the token from step 1

  3. Click Save. You should see Connected to GitLab ….

If the webhook could not be created

The settings page then shows a URL and a secret. In GitLab open the project's Settings → Webhooks → Add new webhook, paste the URL, paste the secret as Secret token and select Push events.

Existing files: click Import from the repository on the settings page (see Import scenarios).

PreviousConnect GitHubNextConnect Bitbucket