프로젝트

Jira에서 GitHub 연동(레포지토리 추가 + Issue 알림)

연꿀

10 9월 2024 • 5 min read

최근 프로젝트를 시작했다.

기존에는 프로젝트 협업 툴로 Notion을 사용했었다.

근데 팀원이 Notion이 불편해서 Jira와 Slack을 쓰는게 어떻냐고 물어보았다.

Jira를 통해 GitHub와 연동하여 새로운 Issue가 올라올 때 마다 Task를 만들도록 할 수 있다고 한다.

우리 프로젝트에는 GitHub를 쓰지 않는 디자이너분도 계셔서 Jira를 쓰는것도 괜찮아 보였다.

그래서 이번 기회에 Jira에 GitHub를 연동해 보았다.

Jira - GitHub Branch 연동

Jira 프로젝트 관리자 계정으로 로그인 후, GitHub app 페이지에서 Get it now 를 클릭하고 GitHub for Jira를 설치한다.

깃허브 계정과 연결한다. 깃허브 Organization에 대한 소유자 권한이 있어야 한다.

레포지토리 접근 권한 설정을 위해 Settings의 ...을 누르고 Configure 를 클릭한다.

Repository access에서 All repositories 를 선택하고 Save 버튼을 클릭하자.

보드에서 브랜치를 연결하면 GitHub에서의 진행 상황이 그대로 연동되어 표시된다.

Jira - GitHub Issue 연동

API 토큰 페이지에 접속 후 API 토큰 만들기 버튼을 클릭한다.

알기 쉬운 레이블 명을 정하고 토큰을 만들고 생성된 새 API 토큰을 메모장에 저장한다.

GitHub Action 에 사용할 Workflow를 만든다.

name: Create Jira issue
on:
  issues: 
    types: [opened]
    
jobs:
  create-issue:
    name: Create Jira issue
    runs-on: ubuntu-latest
    steps:
    - name: Login
      uses: atlassian/gajira-login@v3
      env:
        JIRA_BASE_URL: ${{ secrets.JIRA_BASE_URL }}
        JIRA_API_TOKEN: ${{ secrets.JIRA_API_TOKEN }}
        JIRA_USER_EMAIL: ${{ secrets.JIRA_USER_EMAIL }}
    
    - name: Create Issue 
      uses: atlassian/gajira-create@v3
      with:
        project: <본인의 프로젝트 명>
        issuetype: Task
        summary: '${{ github.event.issue.title }}'
        description: '${{ github.event.issue.html_url }}'

Workflow 파일은 레포지토리/.github/workflows/ 에 위치한다.

해당 Workflow는 Issue를 생성할 때, Jira 프로젝트에 Task를 생성하는 Action이다.