Jira와 GitLab(자체 서버) 연동하기

이 글은 Jira의 GitLab for Jira APP을 이용하여 연동하는 법을 설명합니다.

Jira의 앱 관리 화면

 

 

GitLab for Jira 을 들어 가면 Get Started 버튼 클릭

 

그럼 위와 같은 화면이 나옵니다. 처음 엔 GitLab.com (Saas) 가 체크 되어있지만 저는 GitLab 자체 서버를 사용하기에 아래 GitLab(self-managed)
를 선택 후 Next 버튼을 클릭 

 

그럼 위와 같은 화면이 나옵니다. 친절하게 4개의 체크 리스트를 모두 진행했다고 하면  Next  가 활성화 됩니다.

맨 위에 Prerequisites 부터 봅시다. [클릭하면 아래 주소로 이동합니다.]
https://docs.gitlab.com/ee/administration/settings/jira_cloud_app.html#prerequisites 

GitLab for Jira Cloud app administration | GitLab

 

나와 있는 설명대로 천천히 진행하면 별 다른 어려움 없이 할 수 있습니다만 그 중에서 설명이 모호했던 것들만 자세히 설명하겠습니다.

 

Set up OAuth authentication

Gitlab의 Admin Area에 Applications 를 클릭하면 다음고 같은 화면이 나옵니다.

(저는 이미 Instance OAuth applications 을 추가 하였기 때문에 Jira 가 추가되어 있는 모습입니다.)

 

오른쪽에 Add new application 버튼 클릭

그 후 설명서에 나와있는대로 아래와 같이 Scopes의 api만 체크 후 Save application을 클릭합니다. 
(Name은 임의로 작성해주시면 됩니다. 저는 편의상 Jira로 작성하였습니다.)

 

그럼 아래와 같이 추가된 모습을 확인 할 수 있습니다.

 

그 후 생성된 Instance 를 클릭하면 아래에 정보가 뜹니다.

설명서 대로 Application ID를 복사해둡니다.

그루 GitLab에 Settings -> General -> GitLab for Jira App을 보면
(만약 Gitlab for Jira App이 없다면 검색해서 추가해주세요.

저는 이미 추가가 되어있었습니다. 자동으로 추가가 되는건지 모르겠습니다.)

ID 입력란에 아까 복사해둔 복붙해줍니다.
그리고 Proxy URL 은 설명서대로 위와 같이 작성해준 뒤 Save changes 클릭 해줍니다.

 

그럼 GitLab은 준비가 끝났습니다. 

 

그 후 다시 Jira로 돌아가서 

체크리스트들을 모두 체크아웃 후  Next 클릭 후

본인 GitLab URL을 작성 후 Save 하면 

 

Sign in Button을 눌러 진행해 주시면 됩니다.

그 후에 Link Group 버튼을 통해 연동할 GitLab Group을 Link를 진행하면 됩니다. 

 

---

만약 Link 에러가 뜬다면 아래에 방법으로 진행해주세요.

https://community.atlassian.com/t5/Jira-questions/Can-not-link-group-of-gitlab-while-configuring-gitlab-plugin-for/qaq-p/2390914

 

위 글을 정리하자면 
Jira의 Group에 site-admins 을 만든 후 자신을 추가하면 된다고 나와있습니다.

(제가 Jira 관리자가 아니므로 Group을 추가하는 사진을 추가하지 못했습니다.)

site-admins 그룹에 자신이 추가된 후에 다시 Link를 진행하면 아래와 같이 잘 작동합니다.