Published Oct 14, 2024

Confluence 및 Jira 함께 사용하기

6 min

Confluence 와 Jira 를 함께 사용하여 프로젝트에서 공동 작업하고 소프트웨어를 만들고 주요 의사 결정 추적하는 방식 등을 바꿀 수 있습니다.

Confluence와 Jira를 통합하는 방법에는 여러 가지가 있으며 시작하는 방법은 다음과 같습니다.

 

 

1. Confluence 및 Jira 통합

Jira와 Confluence를 통합하여 각각의 장점을 함께 이용할 수 있습니다.

예를 들어, Jira 프로젝트를 모든 프로젝트 설명서가 있는 Confluence 스페이스에 연결하면 공유 드라이브와 파일 폴더가 더 이상 필요하지 않고, 필요한 내용들을 그 어느 때보다도 쉽게 찾을 수 있게 됩니다.

1.1. Confluence 스페이스를 Jira 프로젝트에 연결

Confluence와 Jira를 통합하는 첫 번째 단계입니다.

image-20241010-082230.png

  1. Jira 왼쪽 사이드바에서 프로젝트 페이지(Project pages)로 이동합니다.

  2. Confluence에 연결(Connect to Confluence)을 클릭합니다.

  3. 연결하려는 Confluence 스페이스를 찾습니다.

  1. Jira 왼쪽 사이드바에서 프로젝트 페이지(Project pages)로 이동합니다.

  2. Confluence에 연결(Connect to Confluence)을 클릭합니다.

  3. 연결하려는 Confluence 스페이스를 찾습니다.

이렇게 Jira 내에서 페이지를 보고, 만들고, 편집할 준비가 되었습니다.

 

1.2. Confluence 페이지에 Jira 바로 가기 추가하기

바로 가기를 추가하면 필요할 때 제품 간에 쉽게 전환할 수 있습니다.

image-20241010-082622.png
Confluence 사이드바 SHORTCUTS → + 버튼

  1. Jira 프로젝트의 URL을 복사합니다

  2. 연결하려는 Confluence 스페이스로 이동합니다

  3. Confluence 왼쪽 사이드바에서 +(바로 가기 추가) 옵션을 누릅니다

  4. 스페이스 바로 가기 편집 대화 상자에 Jira 프로젝트 URL을 붙여넣고 쉽게 참조할 수 있도록 바로 가기의 이름을 지정합니다

  1. Jira 프로젝트의 URL을 복사합니다

  2. 연결하려는 Confluence 스페이스로 이동합니다

  3. Confluence 왼쪽 사이드바에서 +(바로 가기 추가) 옵션을 누릅니다

  4. 스페이스 바로 가기 편집 대화 상자에 Jira 프로젝트 URL을 붙여넣고 쉽게 참조할 수 있도록 바로 가기의 이름을 지정합니다

이제 왼쪽 사이드바에서 바로 가기를 클릭하여 Jira 프로젝트로 원활하게 이동할 수 있습니다.

바로 가기는 누구든지 사용할 수 있지만, Confluence 스페이스에 대한 새 바로 가기를 만들 수 있는 것은 사이트 관리자뿐입니다.

 

 

1.3. Jira 프로젝트로 연결되는 Confluence 바로 가기 추가하기

관리자는 Jira 프로젝트에 Confluence 바로 가기를 추가할 수 있습니다.

image-20241010-083205.png
Confluence 페이지 URL 복사

  1. Jira에 연결하려는 Confluence 페이지로 이동합니다.

  2. 우상단의 ‘공유’(Share)를 선택하여 페이지 URL을 복사합니다.

  1. Jira에 연결하려는 Confluence 페이지로 이동합니다.

  2. 우상단의 ‘공유’(Share)를 선택하여 페이지 URL을 복사합니다.

 

image-20241010-083501.png
Jira에서 Shortcut 추가하기

  1. 선택한 Jira 프로젝트의 왼쪽 사이드바에서 바로 가기 추가(Add shortcut)를 선택하고 바로 가기(shortcuts)를 선택합니다.

  2. Confluence 페이지 URL을 붙여넣고 바로 가기의 이름을 지정합니다.

  1. 선택한 Jira 프로젝트의 왼쪽 사이드바에서 바로 가기 추가(Add shortcut)를 선택하고 바로 가기(shortcuts)를 선택합니다.

  2. Confluence 페이지 URL을 붙여넣고 바로 가기의 이름을 지정합니다.

Jira 프로젝트와 Confluence 페이지를 연결하고 나면 공유나 멘션 및 댓글 같은 중요한 알림이 양 쪽 모두에 표시되어 중요한 알림을 놓치지 않을 수 있습니다.

 

 

2. Jira에서 포함된 Confluence 페이지 사용

Jira 프로젝트를 Confluence 스페이스에 연결하면 프로젝트에서 나가지 않고도 Confluence 페이지를 보고 편집하고 만들 수 있습니다.

  1. 사이드바 하단 프로젝트 페이지(Project pages)로 이동하여 원하는 페이지를 선택합니다. 이렇게 Confluence로의 전환 과정을 생략됩니다.

  2. 프로젝트 페이지에서 비어 있는 Confluence 페이지 또는 Confluence 템플릿을 통해
    새 콘텐츠를 추가할 수 있습니다.

  3. Jira 내에서도 Confluence 페이지를 편집할 수 있습니다. 프로젝트 페이지(Project pages)에서 페이지를 마우스로 가리켜서 연필 아이콘이 나타나면 클릭하여 편집합니다.

  1. 사이드바 하단 프로젝트 페이지(Project pages)로 이동하여 원하는 페이지를 선택합니다. 이렇게 Confluence로의 전환 과정을 생략됩니다.

  2. 프로젝트 페이지에서 비어 있는 Confluence 페이지 또는 Confluence 템플릿을 통해
    새 콘텐츠를 추가할 수 있습니다.

  3. Jira 내에서도 Confluence 페이지를 편집할 수 있습니다. 프로젝트 페이지(Project pages)에서 페이지를 마우스로 가리켜서 연필 아이콘이 나타나면 클릭하여 편집합니다.

 

 

3. Confluence 페이지를 Jira 이슈에 바로 추가

Confluence 페이지 URL을 복사하여 Jira 이슈 설명(Description)에 붙여 넣으면 스마트 링크가 나타납니다.

스마트 링크를 추가하는 방법은 다음과 같습니다.

  1. 브라우저 주소 표시줄에서, 또는 공유 및 링크 복사를 선택하여 페이지 URL을 복사합니다

  2. Jira 이슈 보기 페이지에서 설명(Description) 섹션에 URL을 붙여 넣습니다

  3. Confluence 스마트 링크가 나타납니다. 기존처럼 스마트 링크를 클릭하여 인라인, 카드 또는 포함(Embeded) 을 선택할 수 있습니다.

  4. Save 를 클릭하여 저장합니다.

  1. 브라우저 주소 표시줄에서, 또는 공유 및 링크 복사를 선택하여 페이지 URL을 복사합니다

  2. Jira 이슈 보기 페이지에서 설명(Description) 섹션에 URL을 붙여 넣습니다

  3. Confluence 스마트 링크가 나타납니다. 기존처럼 스마트 링크를 클릭하여 인라인, 카드 또는 포함(Embeded) 을 선택할 수 있습니다.

  4. Save 를 클릭하여 저장합니다.

링크한 Confluence 페이지에 삽입된 Jira 이슈 역시 Description 에서 함께 표시가 되어서 관련 문서를 쉽게 찾을 수 있습니다.

 

 

4. Confluence에서 Jira 이슈 생성

4.1. Confluence에 Jira issue 목록 표시

Confluence의 페이지에 동적 Jira issue 목록을 삽입할 수 있습니다.

 

image-20241010-135207.png

  1. 편집기에 /jira 를 입력하여 Jira Issues 를 선택하거나, 상단 메뉴 중 + 를 클릭하여 해당 매크로 검색 후 선택합니다.

  1. 편집기에 /jira 를 입력하여 Jira Issues 를 선택하거나, 상단 메뉴 중 + 를 클릭하여 해당 매크로 검색 후 선택합니다.

image-20241010-135232.png

  1. 주어진 필터 항목들 (프로젝트, 타입, 상태, 담당자) 을 설정하면 그 에 맞는 issue 가 검색됩니다. 여기서 표시하려는 issue만 선택할 수도 있습니다. Insert issues 를 클릭하여 삽입하면 아래 그림과 같이 해당 페이지에 Jira 이슈를 확인할 수 있는 매크로를 생성합니다.

  1. 주어진 필터 항목들 (프로젝트, 타입, 상태, 담당자) 을 설정하면 그 에 맞는 issue 가 검색됩니다. 여기서 표시하려는 issue만 선택할 수도 있습니다. Insert issues 를 클릭하여 삽입하면 아래 그림과 같이 해당 페이지에 Jira 이슈를 확인할 수 있는 매크로를 생성합니다.

 

image-20241010-141516.png

  1. 우상단에서 검색한 이슈를 표 형식으로 삽입할지, 단순히 issue의 개수만 나타낼지 선택할 수 있습니다.
    이후 Insert issues 클릭하여 매크로를 삽입하면 아래와 같이 확인됩니다.

  1. 우상단에서 검색한 이슈를 표 형식으로 삽입할지, 단순히 issue의 개수만 나타낼지 선택할 수 있습니다.
    이후 Insert issues 클릭하여 매크로를 삽입하면 아래와 같이 확인됩니다.

image-20241010-135628.png
List 형태의 Jira issue 매크로가 생성된 모습

 

 

4.2. Confluence에서 Jira issue를 생성

동일한 기능을 사용하여 Confluence의 페이지에서 Jira 이슈를 만들 수도 있습니다.

 

image-20241010-134308.png

  1. 페이지를 편집하는 동안 /Jira를 입력하거나 +를 누르고 Create Jira issue를 선택합니다

  1. 페이지를 편집하는 동안 /Jira를 입력하거나 +를 누르고 Create Jira issue를 선택합니다

 

image-20241010-134454.png

  1. 이슈 세부 정보를 작성한 후 삽입을 선택합니다. asterisk 표시가 된 사항은 전부 작성하여야 합니다.

  1. 이슈 세부 정보를 작성한 후 삽입을 선택합니다. asterisk 표시가 된 사항은 전부 작성하여야 합니다.

이슈는 선택한 Confluence 페이지 및 Jira 프로젝트에 자동으로 추가됩니다.

 

5. Confluence 페이지에 Jira 이슈 추적하기

5.1. Confluence에서 Jira 이슈 추적

앞서 보았듯 Confluence 페이지에서 Jira 매크로를 생성하는것이 아니라, Jira 링크를 직접적으로 붙여넣으면 Confluence 페이지에 단일 Jira 이슈 링크가 추가됩니다.

image-20241010-140844.png

  1. 페이지 편집기에서 Jira 이슈 링크를 직접 붙여넣으면 단일 링크가 생성됩니다.

  1. 페이지 편집기에서 Jira 이슈 링크를 직접 붙여넣으면 단일 링크가 생성됩니다.

페이지를 게시하고 나면 링크가 이슈 ID 및 제목, 이슈 범주(에픽, 작업 등), 워크플로에서의 이슈 상태(예정, 진행 중, 완료 등)를 표시합니다.

 

image-20241010-140947.png

  1. 해당 이슈를 붙여넣은 Confluence 의 페이지가 metioned on 항목에 표시됩니다.

  1. 해당 이슈를 붙여넣은 Confluence 의 페이지가 metioned on 항목에 표시됩니다.

 

5.2. Jira 이슈 수집기(Issue collector) 포함하기

이슈 수집기(Issue collector)는,

고객의 피드백을 수집하거나, 직원들이 시험 사용 시 버그 또는 이슈를 기록하도록 하거나, Confluence 사용자가 더 빠르고 간단하게 Jira에 티켓을 생성 하도록 하는 데 유용합니다.

  • 이슈 수집기를 생성하면 HTML 혹은 JavaScript 코드가 생성됩니다. 이 코드를 Confluence 페이지 또는 웹 사이트에 삽입하여 Jira 양식을 포함할 수 있습니다.

  • 수집기 코드가 페이지에 삽입되면 선택 시 Jira 이슈를 만드는 버튼이 나타납니다.

  • 이슈 수집기를 만들 수 있는 Jira 의 프로젝트 형식은 ‘회사 관리 프로젝트’ 입니다.

아래 링크에서 프로젝트 유형에 대해 알아보세요.

Jira의 프로젝트 유형 ( 회사 관리 / 팀 관리 )

 

Issue collector 는 ‘Jira’에서 생성합니다! 다음 방법을 따라 생성해 보세요.

 

  1. 원하는 Jira 프로젝트의 사이드바에서 Project settings → Issues → Collectors 탭으로 가
    Issue Collector를 구성합니다.

  1. 원하는 Jira 프로젝트의 사이드바에서 Project settings → Issues → Collectors 탭으로 가
    Issue Collector를 구성합니다.

image-20241010-142626.png
(1)

 

  1. 우측 상단의 Add issue collector 클릭

  1. 우측 상단의 Add issue collector 클릭

image-20241010-142757.png
(2)

 

  1. Asterisk 표시 항목은 전부 작성합니다. Trigger의 경우 Prominent - 중앙 상부, Subtle - 우측 하단, Vertical - 우측 에 위치하게 됩니다.

  1. Asterisk 표시 항목은 전부 작성합니다. Trigger의 경우 Prominent - 중앙 상부, Subtle - 우측 하단, Vertical - 우측 에 위치하게 됩니다.

image-20241010-143250.png
(3)

 

  1. 생성한 issue collector 에 대한 HTML 코드와 JavaScript 가 생성됩니다. 복사하여 원하는 페이지에 코드를 삽입합니다.

  1. 생성한 issue collector 에 대한 HTML 코드와 JavaScript 가 생성됩니다. 복사하여 원하는 페이지에 코드를 삽입합니다.

image-20241010-143523.png
(4)

 

Issue collector 사용법에 대해 더 자세히 알고 싶으시다면 아래 링크를 참고하세요.

Issue collector 설정 및 사용

 

 

5.3. Confluence에 Jira 로드맵 포함

실시간 로드맵을 포함할 수 있는 Jira Road Map 매크로를 통해, 작업 계획을 공유하고 상태 업데이트를 제공하는 등 팀이 같은 정보를 공유할 수 있게 됩니다.

 

image-20241010-145254.png

  1. 페이지를 편집하는 동안 /jira roadmap을 입력하거나 +를 누르고 Jira 로드맵을 선택합니다.

  2. 필요한 값을 설정한 다음 저장을 선택합니다.

  1. 페이지를 편집하는 동안 /jira roadmap을 입력하거나 +를 누르고 Jira 로드맵을 선택합니다.

  2. 필요한 값을 설정한 다음 저장을 선택합니다.

 

 

6. Confluence Cloud에서 Jira 보고서 만들기

Jira 보고서 템플릿을 사용하면 Jira 프로젝트에서 발생하는 작업을 빠르고 쉽게 확인 할 수 있습니다.

 

image-20241010-151118.png

  1. 페이지 생성 시, Jira report 템플릿을 선택합니다.

  1. 페이지 생성 시, Jira report 템플릿을 선택합니다.

 

image-20241010-151151.png
image-20241010-151209.png

  1. Status report 유형을 선택합니다.

  2. 원하는 Jira 프로젝트를 선택합니다. Create

  1. Status report 유형을 선택합니다.

  2. 원하는 Jira 프로젝트를 선택합니다. Create

 

image-20241010-151943.png

  1. 생성된 리포트를 확인합니다.

  1. 생성된 리포트를 확인합니다.

 

Related content