Gitlab hero border pattern left svg Gitlab hero border pattern right svg

Integration Demos

In some cases, GitLab must be used with existing systems. The most common systems requested include Atlassian Jira for issue management, Jenkins for pipeline execution or GitHub for source code management. Jira to GitLab workflow, GitHub to GitLab CI/CD linkage or GitLab to Jenkins connections can be arranged quickly on a per-project basis using available integrations from GitLab.

The below demonstration highlights a simple flow of work between Jira issues and GitLab source code management, as well as between GitLab merge requests and Jenkins pipelines.

The below demonstration highlights a simple flow of work between GitHub pull requests and GitLab CI/CD.

Jira Integration Demo

The following guide can be used to integrate Gitlab.com with Jira Software Cloud: There are two different GitLab provided integrations for Jira.

Prerequisite: Must be a Gold group owner on GitLab.com

GitLab Jira integration

  1. You can either create your own free Jira Software Cloud environment or use the environment listed under Jira Integration Demo Login in 1Password.
    • If using the Jira Integration Demo Login select the spring-integrations project in Jira and go to the issue board.
  2. Create a new Jira issue. Note the ID or copy it to the clipboard.
  3. Log in to GitLab.com and create a new project within your Gold group
    • Under Settings > Integrations > Jira, configure the integration with the web URL, username, API token (you will need to generate a new token for your own use), and transition ID for your project.
  4. Create a branch from Repository > Branches. Include your new Jira issue ID in branch name and description (such as fixes SI-X, where X is the issue number).
  5. Create a merge request with SI-X in the name and Resolves SI-X in the description.
  6. Edit any non-essential code within the repository, then enter a commit message mentioning SI-X again.
  7. When you merge the GitLab Merge Request, the Jira issue’s status is transitioned to Done_.
  8. Go to Jira again via the link in the GitLab menu.
  9. Navigate to the Jira issue board and select the your issue (SI-X if using the spring-integrations project). Note the GitLab content is now present in the Comments area. If you have Jira open in another browser tab, the updated comments will show immediately upon refresh of the page’s content.

GitLab Jira development panel integration

  1. Follow the Jira development panel integration instructions.
  2. Manually sync GitLab and Jira for the commit and branch data to show up. It takes 60 minutes by default between syncs. Manually refresh the spring-integrations DVCS account in Jira by navigating to System/Applications/DVCS and clicking the circular icon next to the last activity date.
  3. Navigate to the Jira issue board and select the your issue (SI-X if using the spring-integrations project). Note the GitLab commit and branch information displayed in the Development panel on the right side.

Jenkins Integration Demo

Bamboo CI Integration Demo

OpenLDAP Integration Demo (Adding Users)

GitHub Integration Demo

Conclusion

GitLab, leveraging built-in integrations, can work with existing Jira, GitHub or Jenkins systems, flowing work and updating status bi-directionally between those tools and GitLab.