Learn more about Jira Cloud products, features, plans, and migration.
Integrate Jira Cloud with Confluence, development tools, apps, and self-hosted tools using OAuth and feature flags.
Control who has access to your Jira Cloud products and give them the right permissions to perform their role.
Learn how to set up, customize, and manage Jira Cloud projects.
Explore issues, issue types, issue custom fields, issue screens, custom field context, and issue field configurations in Jira Cloud.
Define the lifecycle of your work and learn about issue workflow schemes and the issue collector.
Learn more on how you can set up Jira Cloud for your team.
Connecting your GitLab account to Jira Software means your team can view their development activity in the context of the Jira issues they’re working on - no need to switch between tools. When a Jira issue key is referenced in a commit, branch, or merge request in GitLab, the Jira issue will update automatically to show the latest development information.
If you set up a CI/CD pipeline in GitLab, Jira will also show build and deployment information on your Jira issues, on the board, on the deployments timeline, and in the Releases hub. Learn more about integrating deployments with Jira.
Connect a GitLab account to Jira Software
Install the GitLab Marketplace app
Go to the Atlassian Marketplace and install the app GitLab.com for Jira Cloud.
Once the app has installed, follow the link Manage apps. If the app is already installed on your Jira site, log in to Jira and select the Settings icon, then select Apps > Manage apps.
Add your GitLab namespace in Jira
On the Manage apps page in Jira, expand the GitLab for Jira app details and select Get started.
Select Add namespace.
Select or enter the namespace of your GitLab project. If the URL for your project is https://gitlab.com/mynamespace/new-project then the namespace is mynamespace
Set up your Jira integration in GitLab
Log in to your GitLab.com account.
Go to your project and select Settings > Integrations.
Under Add an integration, select Jira.
Enter your Jira site details as follows:
Web URL - your Jira site URL (e.g. https://myjirasite.atlassian.net)
Username or email - the username or email registered on your Jira profile.
Password or API token - create an API token, copy it to your clipboard, and paste it in. Learn more about managing API tokens for your Atlassian account.
Select Test settings to check if the connection is working.
Select Save changes.
Add Jira issue keys in your commits, branches, and merge requests
To link your team’s development activity to Jira, start including issue keys in commit messages, branch names, and merge request titles. Learn more about referencing issues in your development work.
Set up a CI/CD pipeline in GitLab
Log in to your GitLab.com account.
Go to your project and select CI/CD > Pipelines.
Create a .gitlab-ci.yml file with a pipeline.
Add a deploy stage and set your environment. Learn more about setting up environments in GitLab.
To send build and deployment information from GitLab to Jira, your team must include Jira issue keys in their commit messages and branch names. Whenever a pipeline runs in GitLab, the integration will look for Jira issue keys in the branch name and commit messages. If it finds issue keys, it will send build and deployment information to Jira. This information will be shown in the development panel on your team’s Jira issues, on the board, on the Deployments timeline, and in the Releases hub.
Was this helpful?