...
저장하고 다시 Integration 화면에 들어가면 JIRA 가 설정된 것을 확인할 수 있습니다.
사용
연결되면 JIRA 프로젝트 메뉴에 코드가 생기며 클릭하면 현재 프로젝트에 연결된 저장소 목록을 표시합니다.
브랜치 생성
BitBucket 은 JIRA 메뉴에서 바로 브랜치를 생성할 수 있지만 gitlab 은 JIRA 메뉴에서 생성할 수 없습니다.
대신 브랜치를 만들 때 이름에 Issue key 가 포함되게 만들어주면 됩니다.
예로 위 지라 이슈 키는 AA-25 인데 아래 그림처럼 이슈 키를 포함해서 브랜치를 생성해 주면 됩니다.
이슈 키를 포함하는 새 브랜치를 만들었으면 JIRA 와 연동되도록 커밋이 없어도 push 를 한 번 해보고 지라 이슈 상세 화면에 들어가 보겠습니다.
그러면 아래 그림처럼 브랜치가 추가된 것을 볼 수 있습니다.
브랜치를 클릭하면 현재 이슈와 관련된 gitlab 커밋 내역과 Pull Request 등을 볼 수 있습니다.
JIRA server 와 gitlab 간 연동은 gitlab 이 커밋 메시지에 Issue Key 가 있을 경우 JIRA 에 REST API 로 요청하는 형식으로 동작하므로 JIRA 에서는 정상 연결 여부를 확인할수 없습니다.
대신 직접 커밋을 해 봐야 정상 동작 여부를 알 수 있습니다.
브랜치 연결
둘 간의 연계는 gitlab 에서 이벤트 발생시 REST API 를 호출하는 방식이라 통합 기능이 미약합니다.
그래서 JIRA Server 와 gitlab 간 브랜치 연결은 제공되지 않습니다.
Commit 연결
커밋시에 이슈 키를 추가하면 이슈 별 커밋 내역을 확인할 수 있습니다.
예로 아래와 같은 수정을 하고 커밋시에 이슈 키와 수정 사항을 커밋 메시지로 입력하고 push 까지 해보겠습니다.
그런후에 이슈 상세 화면에서 브랜치를 클릭한 후에 커밋 탭을 열면 아래와 같이 커밋 내역이 연결된 것을 볼 수 있습니다.
커밋의 해시 id 를 클릭하면 gitlab 으로 넘어가서 소스의 상세 변경 내역을 화면을 보면 댓글과 mention 에 커밋 내역이 연결된 것을 확인할 수 있습니다.
Issue status transition
| Note |
|---|
gitlab premium plan 이어야 동작하는 기능입니다. |
커밋 메시지에 전환할 Issue 상태를 기술하면 이슈 상태도 변경할 수 있습니다.
예로 다음과 같이 전환할 상태인 close 를 Done 을 넣고 #comment 태그 뒤에 댓글로 남길 메시지를 넣으면 이슈가 종료 상태로 전환되고 댓글로 "응답 메시지에 현재 시간 추가 " 가 남게 됩니다.
| Code Block |
|---|
AAKANTEST-2519 #close#done #comment 응답 메시지에 현재 시간 추가 |
이슈 상세 화면에서 확인하면 현재 이슈에 1개 브랜치와 2개 커밋이 있는 걸 확인할 수 있는데 이슈의 상태는 바뀌지 않은 것을 알수 있습니다.
...
| Tip |
|---|
스마트 커밋시 자주 하는 |
...
실수로 work flow 에 |
...
칸반 프로젝트이므로 Close 가 아닌 Done 상태이며 이런 실수를 방지하려면 현재 프로젝트의 워크 플로우를 기억하고 있어야 합니다.
상단의 이슈 상태 리스트를 클릭한 후에 메뉴에서 워크플로 보기 를 선택합니다.
그럼 현재 프로젝트는 Done 이 종료 상태인 것을 알수 있습니다.
다시 소스를 수정하고 커밋 메시지에 전환할 work flow 상태를 추가하고 push 를 해 줍니다.
| Code Block |
|---|
| AA-26 #done #comment 현재 시간의 time stamp zone 표시 없는 상태명(예: close) 를 넣는 것입니다. 이슈의 work flow를 확인해서 적절한 상태명을 넣어주세요. |
그리고 이슈 상세 화면을 보면 이슈 상태가 완료로 변경된 것을 확인할 수 있습니다.
전환할 이슈가 "IN Progress" 나 "Selected for Development" 같이 공백이 있을 경우 공백을 대쉬(-) 로 치환해서 커밋 메시지에 적어주면 됩니다.
| Code Block |
|---|
AA-26 #in-progress #comment 날자 출력시 안내 메시지를 한글로 변경 |
...