Jira 및 Confluence 사용 방법

현재 스터디를 진행하면서 학습 계획 및 성과 분석을 Jira와 Confluence를 활용해 관리하고 있다. 본인이 스터디장을 맡고 있어서 Jira 및 Confluence를 통해 문서를 취합해야 하는데, 두 가지 도구를 처음 접한 데다 사용 가이드도 인터넷이나 유튜브에 많지 않아서 그야말로 맨땅에 헤딩하며 하나씩 기능을 익혀가는 중이다. 그래서 혼자 삽질하며 알아낸 기능들을 이 글에 정리해두고, 필요할 때마다 다시 찾아볼 수 있도록 정리할 예정이다. 그리고 계속 사용하면서 새롭게 알게 된 내용들도 틈틈이 추가할 예정이다. (본인이 모르는 Jira 및 Confluence 기능이 아직도 많을 거다..) 저처럼 혼자 헤매고 있을 누군가에게도 조금이나마 도움이 되었으면 한다. (본인이 한참 삽질했던 부분은 빨간색 굵은 폰트로 표시했으니, 참고하세요)

 

📌 Jira 프로젝트 생성

일단 프로젝트 생성은 정말 간단하다. 우선 jira 공식 사이트에 접속한 뒤 오른쪽 상단에 위치한 [무료로 시작]  버튼을 클릭한다.

각 회사나 팀은 자체 도메인(Jira 사이트)을 생성하여 사용한다. 새로운 사이트를 만들면, 입력한 도메인을 기반으로 다음과 같은 URL이 자동 생성된다.

( https://[입력한 도메인].atlassian.net )

원하는 사이트 주소를 입력한 후 [계속] 버튼을 클릭한다.

이 단계에서는 프로젝트 목적에 맞는 템플릿을 선택한다. (프로젝트의 큰 카테고리를 결정)

원하는 템플릿을 선택한 후 [계속] 버튼을 클릭한다.

이 단계에서는 프로젝트 이름, 프로젝트 목적에 맞는 템플릿을 선택한다. (실제 프로젝트의 구조와 기능을 결정 / ex: Scrum, Kanban 등)

원하는 프로젝트 이름, 원하는 템플릿을 선택한 후 [프로젝트 만들기] 버튼을 클릭한다.

위 단계를 모두 완료하면 프로젝트가 정상적으로 생성된다.

 

📌 프로젝트 사이드바 설정

칸반 프로젝트를 선택하여 생성하면, 기본적으로 프로젝트 사이드바에 "백로그" 메뉴가 표시되지 않는다.

이를 활성화하려면 프로젝트 사이드바에서 [+ 보기 추가] > [+ 더 많은 기능] 을 클릭한다.

(또는 프로젝트 사이드바에서 [프로젝트 설정] > [기능] 에서도 동일한 설정 변경 가능)

 

해당 창에서 추가하려는 기능의 토글을 'On'으로 설정한다.

 

📌 스프린트 생성

"백로그" 기능을 정상적으로 추가했다면, 프로젝트 사이드바에 "백로그" 메뉴가 표시된다.

스프린트를 생성하려면, 프로젝트 사이드바에서 [백로그] > [스프린트 만들기] 버튼을 클릭한다.

스프린트를 편집하려면, 스프린트 오른쪽 상단의 [•••] > [스프린트 편집] 버튼을 클릭한다.

원하는 스프린트 이름, 기간을 입력한 후 [업데이트] 버튼을 클릭한다.

 

📌 이슈 생성

이슈를 생성하려면, 프로젝트 사이드바에서 [백로그] > [+이슈 만들기] 버튼을 클릭한다.

스프린트에 직접 이슈를 등록할 수도 있고, 백로그에 새로운 이슈를 추가할 수도 있다.

백로그에 있는 이슈를 드래그앤드롭하여 스프린트로 이동할 수 있다.

또는 프로젝트 사이드바에서 [목록] > [+ 만들기] 버튼을 클릭해 이슈를 등록할 수도 있다.

 

📌 칸반 보드

프로젝트 사이드바에서 [보드] 버튼을 클릭하면 칸반 보드를 확인할 수 있다.

이슈를 등록했음에도 칸반 보드에 표시되지 않는다면, 현재 진행 중인 스프린트가 없기 때문이다.

따라서, 프로젝트 사이드바에서 [백로그] > [스프린트 시작] > [시작] 버튼을 클릭하여 스프린트를 시작한다.

다시 프로젝트 사이드바에서 [보드] 버튼을 클릭하면, 정상적으로 등록된 이슈가 칸반 보드에 표시되는 것을 확인할 수 있다.

칸반보드 오른쪽 상단의 [+] 버튼을 클릭하면, 새로운 상태를 추가할 수 있다.

 

📌 이슈 담당자 할당 및 상태 변경

이슈 담당자 할당 및 상태 변경은 프로젝트 사이드바에서 [백로그] 메뉴에서 쉽게 설정 가능하다.

또는 프로젝트 사이드바에서 [보드] > 이슈 클릭 > 이슈 상세 창에서도 동일한 설정 변경이 가능하다.

또한, 이슈 상태는 보드에서 상태 간 드래그앤드롭으로도 변경할 수 있다.

 

📌 이슈 상세 창 (하위 이슈 등록, 필드 구성 변경 등)

하위 이슈를 생성하려면, 프로젝트 사이드바에서 [보드] > 이슈 클릭 을 통해 하위 이슈를 등록할 이슈 상세 창으로 이동한다.

(또는 프로젝트 사이드바에서 [백로그] > 이슈 클릭을 통해서도 이슈 상세 창으로 이동 가능)

이슈 상세 창 왼쪽 상단에서 [+추가] > [하위 이슈] 버튼을 클릭하여 하위 이슈를 등록할 수 있다.

이슈 상세 창 오른쪽에는 이슈 필드 섹션이 존재한다.

이슈 필드 섹션 오른쪽 하단의 [구성] 버튼을 클릭하여 필드 편집 창으로 이동할 수 있다.

필드 편집 창의 중앙에서는 기존 필드를 수정하거나, 순서를 변경하고, 삭제할 수 있다.

오른쪽에는 새로운 필드를 검색하거나 추가할 수 있는 섹션과 검색 창이 제공된다.

본인은 우선순위 필드를 추가하기 위해 검색 창에서 필드를 검색하고 추가했다.

필드를 드래그앤드롭하여 쉽게 추가하거나 순서를 변경할 수 있다.

 

📌 Epic 생성

에픽을 생성하려면, 프로젝트 사이드바에서 [백로그] > [에픽] > [에픽 패널 표시] 토글을 'On'으로 설정한다. (이미 표시된 경우 생략)

에픽 패널 하단의 [+ 만들기 에픽] 버튼을 클릭하여 에픽을 등록할 수 있다.

또는 네비게이션 바의 오른쪽에 위치한 [만들기] 버튼을 클릭한다.

이슈 유형을 '에픽'으로 설정한 후, 요약란에 에픽 이름을 입력하고, 오른쪽 하단의 [만들기] 버튼을 클릭하여 에픽을 등록할 수도 있다.

이슈에 에픽을 할당하려면, 프로젝트 사이드바에서 [백로그] > [+Epic] 버튼을 클릭하여 할당할 수 있다.

또는 이슈 상세 창 오른쪽의 이슈 필드 섹션에서 [상위 항목] 필드를 사용하여 할당할 수도 있다.

이슈를 특정 에픽에 할당하면, 에픽별로 이슈를 모아서 확인할 수 있다는 장점이 있다.

 

📌 Jira에서 Confluence 연결

우선, 프로젝트 사이드바에서 [프로젝트 설정] > [도구 체인] > Confluence [무료 평가판 사용] 버튼을 클릭한다.

[다음] 버튼을 클릭하면, Jira에서 Confluence를 사용할 준비가 완료된다.

Jira에서 Confluence를 연결하려면, 프로젝트 사이드바에서 [프로젝트 페이지] > [Confluence에 연결] 버튼을 클릭한다.

이미 스페이스가 존재한다면, 검색창에서 검색 후 [연결] 버튼을 클릭하고, 스페이스가 없다면 [또는 새 스페이스 만들기] 버튼을 클릭한다.

정상적으로 연결이 완료되면, 프로젝트 사이드바의 [프로젝트 페이지]에서 확인할 수 있다.

 

📌 Confluence 콘텐츠 생성 (jira 이슈 연동)

Confluence에서 콘텐츠를 생성하려면, 왼쪽 사이드바의 [+] 버튼을 클릭한 후, 생성할 콘텐츠 유형을 선택한다.

Confluence 문서에서 '/' 는 빠른 명령 입력 기능을 실행하는 단축키다.

'/jira 이슈'를 통해 Confluence 문서에 Jira의 특정 이슈를 삽입할 수 있다.

프로젝트, 이슈 유형, 상태, 담당자를 선택한 후, [이슈 삽입] 버튼을 클릭하면 원하는 Jira 이슈를 Confluence 문서에 추가할 수 있다.

하지만 여기서 문제가 발생했다. 우리 스터디에서는 주차별로 스프린트를 관리하며, 각 주차에 맞는 이슈를 등록하여 일정을 관리하고 있다. 예를 들어, 1주차에 해당하는 이슈들은 '1주차' 에픽에, 2주차에 해당하는 이슈들은 '2주차' 에픽에 할당된다. 그러나 위 방법에서는 특정 에픽을 필터링할 수 없어, 모든 주차의 이슈가 한꺼번에 불러와진다. 따라서, 주차가 끝날 때마다 해당 주차의 이슈만 가져와서 성과를 분석해야 하지만, 이를 제대로 수행할 수 없는 문제가 발생했다.

이를 해결하려면, 필터링할 에픽의 키를 알아야 한다. 키는 일반적으로 프로젝트 키(Project Key)와 이슈 번호(Issue Number)로 구성된다.

에픽의 키를 확인한 후, Jira 이슈 삽입 창의 오른쪽에 있는 [JQL] 버튼을 클릭한다.

그런 다음, and parent = "에픽 키" 조건을 추가하고, [🔍] 버튼을 클릭하여 해당 조건에 맞는 이슈를 검색한다.

본인은 Week 1(JIR-8) 에픽이 할당된 이슈들만 가져오기를 원했으며, 원하는 결과가 정상적으로 출력되는 것을 확인할 수 있다.

이를 통해 Confluence 문서에 특정 Jira 이슈를 삽입할 수 있다.

JQL은 Confluence 문서에 삽입된 이슈 클릭 > [편집 ▼] > [검색 쿼리 편집] 버튼을 클릭하여 수정할 수도 있다.

 

그러나 또 다른 문제가 발생했다. 특정 에픽의 이슈들은 정상적으로 불러와졌지만, 그 이슈들의 하위 이슈들은 포함되지 않았다. 이는 JQL에서 특정 에픽을 parent로 설정했기 때문이다. 즉, 하위 이슈들은 해당 에픽이 아닌, 그 상위 이슈를 parent로 가지므로 자동으로 포함되지 않는 것이다.

이는 간단하게 해결할 수 있는데 우선 오른쪽 상단의 [ 열 구성 ] 버튼을 클릭한다.

필드 중에서 [ 하위 작업 ] 버튼을 클릭하여 추가할 수 있다.

위와 같이, 하위 이슈가 정상적으로 표시되는 것을 확인할 수 있다.

 

📌 Jira 이슈에 Confluence 콘텐츠 연결

Jira 이슈에 Confluence 콘텐츠를 연결하려면, 프로젝트 사이드바에서 [보드] > 이슈 클릭 을 통해 이슈 상세 창으로 이동한다.

(또는 프로젝트 사이드바에서 [백로그] > 이슈 클릭을 통해서도 이슈 상세 창으로 이동 가능)

이슈 상세 창 왼쪽 상단에서 [+추가] > [기존 Confluence 콘텐츠] 버튼을 클릭한다.

스페이스, 콘텐츠를 선택한 후, [링크] 버튼을 클릭하면 Jira 이슈에 원하는 Confluence 콘텐츠를 연결할 수 있다.

문서를 작성했음에도 콘텐츠 목록에 표시되지 않는다면, Confluence 콘텐츠 초안을 게시하지 않았기 때문이다.

따라서, Confluence 콘텐츠의 오른쪽 상단에 위치한 [게시 설정 선택 및 확인] 버튼을 클릭하여 콘텐츠를 정상적으로 게시한다.

다시 콘텐츠 목록을 확인하면, 문서가 정상적으로 목록에 표시되는 것을 확인할 수 있다.

 

 

출처

https://tech.devsisters.com/posts/jira-of-qa/

https://techblog.woowahan.com/2508/