Jira와 GitHub 연동

Jira에 GitHub을 연동하면 Jira 이슈로 인해 어떤 커밋들이 발생했는 지 확인할 수 있다.

이를 통해 개발자는 이 커밋들이 왜 발생했는 지에 대한 비즈니스 히스토리를 알 수 있게 되고, 비슷한 비즈니스 요구사항이 생겼을 때 예전 담당자가 어떻게 작업했는 지 영향도 파악 및 참고 시에도 유용하다.

아래 순서로 포스팅 내용을 진행하겠다.

1. Jira - Github Enterprise 연동 (jira와 github Admin 권한 필요)

   참고 문서 : https://support.atlassian.com/jira-cloud-administration/docs/integrate-with-github/

2. Jira에서 development 사용방법

   참고 문서 : Reference issues in your development work | Jira Software Cloud

3. IDEA에 Jira 연동 (Optional)

   참고 블로그 : https://jojoldu.tistory.com/260

---

Jira - GitHub Enterprise 연동

1. GitHub OAuth token 발급

admin 권한이 있는 GitHub계정으로 접속하여 OAuth 토큰을 발급한다. 토큰 생성을 위한 메뉴는 Settings → Developer settings → OAut Apps → New OAuth App 으로 접근한다. Generate a new client secret을 선택하면 비밀번호가 생성되는데, 최초 발급 시에만 해당 비밀번호를 확인할 수 있으니 잘 복사해두길 바란다.

2. Jira Software에 GitHub token 추가

admin 권한이 있는 Jira 계정으로 로그인 해서 메뉴 제품(Products...)→ DVCS 계정 → GitHub 엔터프라이즈 계정으로 연결 로 접근한다. 이후 위에서 발급한 GitHub OAuth 토큰을 연결해주면 된다.

• Team or User Account에는 대표 조직명을 입력하면 된다.

  예를 들어 아래과 같은 레포지토리의 URL이 있을 때,

    https://github.com/myteamspace/my-repository

  레포명(my-repository)를 적는 게 아니라 조직명(myteamspace)을 적으면 된다.

• Host URL 깃헙이나 버킷 URL을 입력한다.

• Client ID 발급받은 깃헙 Oauth ID

• Client Secret 발급받은 깃헙 Oauth PW

GitHub 정보 입력 후 Add 시 아래와 같은 페이지가 나타난다. (404 에러가 뜨는 경우 정보를 다시 확인하길 바란다.)

3. Jira Marketplace에서 Jira용 GitHub 앱 설치 및 연결

페이지의 안내대로 Jira용 Github앱을 설치하고, 등록한 Github organization을 연결해준다.

---

Jira에서 development 사용방법

1. 사전 준비사항 : Jira와 GitHub가 연결

2. 브랜치 명, 커밋 메시지, 풀 리퀘스트에 Jira 이슈키를 포함하여 작성

   

3. 코드 메뉴에 Jira이슈키를 포함한 커밋/브랜치/풀 리퀘스트가 있는 레포지토리가 자동으로 연동됨

4. Jira 이슈를 확인하면 커밋된 이력이 표시됨

---

IDEA에 Jira 연동 (Optional)

1. 개인 Jira계정에서 API token 발급은 계정 설정 → 보안 → API 토큰 생성 및 관리 를 선택한다.

   

2. 사용하는 IDEA에서 Jira 연동

   JetBrain 제품인 WebStorm, IntelliJ는 Preferences → Tools → Servers → + 메뉴로 접근하면 된다.

   

3. IntelliJ 기준 아래와 같이 입력

   

   Email에는 Jira 계정, API Token에는 발급받은 Jira 토큰일 입력한다.

4. mac + intellij 기준 option + shift + n 을 누르면 나에게 할당된 Jira 이슈번호 조회됨

---