GitHub 연동하기

들어가며

Jira와 GitHub를 연동하면 커밋, PR, 브랜치 정보를 Jira 이슈에서 바로 확인할 수 있다. 코드 변경과 이슈를 연결해서 추적하기 훨씬 편해진다. 연동 방법과 활용법을 정리해둔다.

---

연동으로 할 수 있는 것

- Jira 이슈에서 연결된 GitHub PR, 커밋, 브랜치 확인
- GitHub PR에서 연결된 Jira 이슈 확인
- 커밋 메시지에 이슈 키 입력으로 자동 연결
- PR merge 시 Jira 이슈 상태 자동 변경

---

연동 방법

Jira에서 GitHub 앱 설치

Jira 설정 → 앱 → 앱 찾기 → "GitHub for Jira" 검색 → 설치

또는 GitHub Marketplace에서 설치한다.

https://github.com/marketplace/jira-software-github

연동 설정

1. GitHub for Jira 앱 설치
2. GitHub 조직/저장소 연결
3. Jira 프로젝트와 GitHub 저장소 매핑

---

커밋으로 이슈 연결

커밋 메시지에 Jira 이슈 키를 포함하면 자동으로 연결된다.

# 이슈 키를 커밋 메시지에 포함
git commit -m "SHOP-42 feat: 로그인 기능 구현"
git commit -m "feat: 로그인 기능 구현 [SHOP-42]"
git commit -m "fixes SHOP-42 로그인 버그 수정"

커밋 후 Jira 이슈 상세 화면에서 연결된 커밋을 확인할 수 있다.

---

브랜치 네이밍으로 연결

브랜치 이름에 이슈 키를 포함해도 자동으로 연결된다.

# 브랜치 이름에 이슈 키 포함
git switch -c SHOP-42-login-feature
git switch -c feature/SHOP-42-login

Jira 이슈에서 바로 브랜치를 생성하는 방법도 있다.

이슈 상세 화면 → 개발 섹션 → 브랜치 만들기
→ GitHub 저장소 선택 → 브랜치 이름 자동 생성 (SHOP-42-이슈제목)

---

PR과 이슈 연결

PR 제목이나 본문에 이슈 키를 포함하면 연결된다.

PR 제목: SHOP-42 feat: 로그인 기능 구현
PR 본문: Closes SHOP-42

연결된 PR은 Jira 이슈 상세 화면의 개발 섹션에서 확인할 수 있다.

---

자동 상태 변경

PR merge 시 Jira 이슈 상태를 자동으로 변경할 수 있다.

설정 방법:
Jira 프로젝트 설정 → 자동화 → 규칙 추가

규칙 예시:
트리거: Pull request merged
조건: 브랜치 이름에 이슈 키 포함
액션: 이슈 상태를 "Done"으로 변경

---

Jira 이슈에서 개발 현황 확인

연동 후 이슈 상세 화면에서 확인할 수 있는 정보들이다.

개발 섹션에서 확인 가능:
- 연결된 브랜치 수
- 커밋 수
- PR 상태 (Open / Merged / Declined)
- CI/CD 빌드 상태

---

정리

항목	방법
앱 설치	GitHub Marketplace → GitHub for Jira
커밋 연결	커밋 메시지에 이슈 키 포함 (SHOP-42)
브랜치 연결	브랜치 이름에 이슈 키 포함
PR 연결	PR 제목/본문에 이슈 키 포함
자동 상태 변경	Jira 자동화 규칙 설정