[Atlassian Jira, Github] Jira Issue 티켓 끊고 Github 연결하기

 

본 가이드는 Jira 스페이스 Github 연동 이후
Jira 이슈를 생성하고, Github 레포지토리와 연결하는 방법에 대해 설명합니다.

Jira 스페이스와 Github 레포지토리와 연동하는 방법에 대한 가이드는
아래의 포스팅을 참고해주세요.

 

[Atlassian Jira, Github] Jira ↔ Github 연동하기

 

Jira Issue 생성부터 Github 레포지토리 연동까지

Jira Issue(티켓) 생성하기

티켓을 끊는다는 것은, 하나의 이슈가 생긴다는 것..

Jira 팀 스페이스 > 칸반 보드 > 백로그 > "만들기" 버튼을 누른다.

 

 

이슈의 제목을 입력하고 엔터를 누른다.

 

무엇을 완료해야 할까요?

 

이후 생성된 이슈를 클릭해 이슈 내용을 수정한다.

 

 

[참고] 티켓 기재 내용 설명/예시

- 제목: 컨벤션에 따른 제목 설정 → 이후 Github 브랜치 생성 간 티켓 제목을 따라 생성
- 설명: 작업 간 할 일이나, 그 밖의 이슈 기재(마크다운 문법 지원)
- 담당자: 업무 수행할 담당자를 지정
- 보고자: 티켓 생성자 혹은 팀장 등 상급자
- 레이블: 컨벤션에 따른 작업유형 지정 (release, bugfix, hotfix, feat, test 등)
- 기한: 업무 기한
- Start date: 업무 착수시점
- 우선 순위: 우선 순

 

Jira 연결 Github 레포지토리 브랜치 만들기

주의) Jira ↔ Github Branch는 직접적인 연동을 제공하지 않는다.
단, Git Commit과 Github Pull Request 이력을 Jira와 연동시킬 수 있다.

 

 

이슈 수정 후 "브랜치 만들기" 버튼을 클릭한다.

 

 

레포지토리와 분기할 브랜치, 브랜치 명을 지정한 후 “Create branch”를 눌러 브랜치를 생성한다.

*주의: 브랜치명은 한글 입력을 지양한다. (git 자체 한글 인코딩 미지원으로 브랜치명이 깨지는 문제가 발생)

 

 

 

브랜치 생성 후 git bash에서 해당 브랜치로 체크아웃 한다.

 

# git Bash
git fetch origin # 원격 브랜치 정보 최신 갱신
git checkout {생성 브랜치명} # 생성한 이슈 브랜치로 체크아웃

 

 

Jira 이슈 키로 Github 레포지토리와 연결하기

이슈 키: Jira의 티켓마다 고유 생성되는 ID이다.
Github 커밋 내용과 PR 제목에 해당 이슈 키를 입력하면 자동으로 Jira에서 이를 인식하고,
이슈와 PR/커밋을 자동으로 연결한다.

 

앞서 생성한 예시 이슈에서 아래와 같이 “커밋 만들기” 버튼을 클릭하면

해당 이슈의 이슈 키와, 연결하기 위한 커밋 예시를 볼 수 있다.

 

 

[커밋 메시지나 PR 제목에 이슈 키 입력시 주의사항]
이슈 키 문자 앞뒤로 공백이나 “:”, "-" 만이 위치해야만 Github에서 Jira 이슈 키를 정확히 인식할 수 있다.


ex) 이슈 키가 “TR-3”인 경우 올바른 커밋 예시 (PR 제목도 동일함)

⭕ : git commit -m “TR-3 hello world”, git commit -m “TR-3: hello world”

❌ : git commit -m” TR-3hello world”

 

Github ↔ Jira 이슈별 연동정보 확인

칸반 보드 등 대시보드의 이슈의 아래 버튼을 통해 이슈 키를 링킹한 Github 브랜치와 PR, 커밋 등을 확인할 수 있다.

 

브랜치, 커밋, PR등 이슈키를 입력한 Github 정보를 Jira에서 확인할 수 있다.