# Epic OP-2944 - GitLab integration

Project: OpenProject
Status: closed
URL: https://community.openproject.org/work_packages/OP-2944

## Detailed specification

### Motivation and background information

### Acceptance criteria

### Out of scope

| Attribute | Value |
| --- | --- |
| Mockups |  |

## Planning

| Attribute | Value |
| --- | --- |
| Roadmap |  |
| Date |  |
| Votes | 74 |
| List |  |
| Target versions | 13.4.0 |
| Sprint | 13.4.0 |
| Backlog bucket |  |
| Relevance |  |

## Subitems

| ID | Type | Subject | Status | Assignee | Target versions | Project | Priority | Spent time |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| OP-14417 | Implementation | Bring btey/openproject-gitlab-integration into a structure that matches openproject | closed |  | 13.4.0 | OpenProject | Medium |  |
| OP-14419 | Implementation | Test Local Setup with GitLab plugin | closed |  | 13.4.0 | OpenProject | Medium |  |
| OP-14445 | Implementation | Add automated tests for the critical path of gitlab integration | closed |  | 13.4.0 | OpenProject | Medium |  |
| OP-14463 | Implementation | Define migration path for users with existing gitlab plugin installations | closed | Kabiru Mwenja | 13.4.0 | OpenProject | Medium |  |

## Bugs and other work packages

| ID | Type | Subject | Status | Assignee | Target versions | Module |
| --- | --- | --- | --- | --- | --- | --- |
| OP-14493 | Task | Update Gitlab Integration README.md | closed | Kabiru Mwenja | 13.4.0 |  |
| OP-14471 | Documentation | [POST FREEZE WORK]: Add documentation for (new) GitLab integration | closed | Maya Berdygylyjova | 13.4.0 |  |
| OP-14444 | Task | Identify Tests that need to be added | closed |  | 13.4.0 |  |
| OP-14443 | Task | Code review GitLab plugin against GitHub plugin | closed |  | 13.4.0 |  |
| OP-14418 | Task | Prepare pull request that merges opf/openproject-gitlab-integration | closed |  | 13.4.0 |  |
| OP-14492 | Code maintenance | Code Review refinements for the future | new |  |  |  |

## Details

| Attribute | Value |
| --- | --- |
| Module |  |
| Enterprise plan |  |
| Labels |  |

## People

| Attribute | Value |
| --- | --- |
| Assignee |  |
| Accountable | Kabiru Mwenja |
| Product manager |  |
| Designer |  |
| Developers | OP Dev Titan Team |
| Requested by |  |
| Interest by |  |

## Estimates and progress

| Attribute | Value |
| --- | --- |
| Work | 0h · Σ 0h |

## Description

**Purpose:**

The goal of this integration is to make GitLab's units of work (merge requests and issues) manageable from within OpenProject by

1.  linking GitLab's *merge requests* with work packages and
2.  linking GitLab's *issues* with work packages.

**Approach:**

- [ ] CLA
  - [ ] <mention class="mention" data-id="42086" data-type="user" data-text="@Wieland Lindenthal">@Wieland Lindenthal</mention> Clarify how is necessary
- [ ] Code review of the existing GitLab plugin
  - [x] Setting it up with some GitLab account
  - [x] Check security aspects
  - [x] Find out what crucial/vital tests are missing
  - [ ] Coming up with a migration path for existing plugin installations <mention class="mention" data-id="53220" data-type="work_package" data-text="###53220">###53220</mention>
- [x] Write tests
  - [x] Only the most vital ones. Keeping in mind that this code is already in production on some people's servers. It should work.
- [ ] Write basic setup docs for admins.
- [x] ~~Consolidate with GitHub integration and remove code duplication, wherever it is worth it.~~

**Out of scope:**

  - Full test coverage
  - Adoption of Primer design system
  - Further features