JIRA에 이슈 한번에 대량 등록하기

이번 프로젝트를 진행하며 JIRA에 이슈를 대량으로 한번에 등록해야 하는 일이 생겼다.

하나의 api 작업에 대해서 서비스단 / 컨트롤러단 / 리포지토리단 3번에 나눠서 반복해서 이슈를 등록해야 하는 상황이다.

일일이 등록하기에는 많은 양이어서 일괄로 등록하는 방법을 활용하였다. 

등록하는 과정 자체는 어렵지 않은데, 다음에 또 사용할 일이 있을 것 같아 기록을 위해 정리하였다.

 

 

먼저, 이슈 일괄 등록을 할 때 기존에 프로젝트에 등록된 이슈들을 이용할 것이 때문에 이슈 탭에서 내보내기를 눌러 csv 파일을 내려받는다.

위의 'csv 내보내기 (내 기본값)'을 선택하여 내려받았다.

 

 

그리고 내려받은 csv 파일을 구글 스프레드 시트를 통해서 필요한 부분을 수정하였다.

위의 내보내기를 하면 모든 이슈가 다 저장되는데, 그중에서 내가 등록하고 싶은 이슈만 남기고 모두 삭제하였고, 

이슈 등록할 때 일괄로 수정해야 할 부분이 있으면(예: 요약) 파일에서 수정하고 파일을 저장한 후 이후 절차를 진행하면 된다.

 

 

위에서 저장한 csv 파일을 통해 이슈를 등록하는 방법이다.

JIRA의 [이슈] 탭에서  '···' 을 누른 후, 'CSV에서 이슈 가져오기'를 선택하여 위에서 저장한 csv 파일을 선택한다.

 

그러면 위와 같은 페이지가 나타난다. 다음을 누른다.

 

설정에서는 '프로젝트로 가져오기'에서 프로젝트만 선택하였고, 나머지는 기본값으로 두었다.

 

 

 

그다음으로는 필드를 매핑하는 페이지이다.

여기서는 필드들을 살펴보고 필요한 필드를 매칭하면 된다.

내 경우, 담당자 ID, 상위항목, 요약, 이슈 유형 4가지를 매핑하였고, 필드값 매핑에 체크를 하였다.

 

담당자의 경우 위 사진에 네모로 표시한 담당자ID의 위의 '담당자'를 지정해서 매핑했을 때는 이름으로 매핑하는데, 이렇게 하고 진행하니 담당자를 찾을 수 없다는 오류가 발생하였다. 그래서 담당자ID로 매핑하니 오류 없이 잘 매핑이 되었다.

 

상위 항목은 에픽에 포함시키기 위해 지정하였다. 그리고 요약은 필수로 매핑해야 한다.

 

 

 

그리고 나서 값 매핑으로 넘어가는데, 여기서 값이 잘 매핑이 되는지 확인하면 된다.

 

아래로 스크롤을 내리면 '가져오기 시작'과 '유효성 평가'가 있다.

'유효성 평가'를 누른다.

 

 

그러면 유효성 평가를 진행해주고, 성공, 경고, 오류 수를 알려주며, 오류가 난 경우 어떤 이유인지도 알려준다.

위의 사진은 예시를 위한 사진이며, 실제 과정을 진행할 때는 오류가 없음을 확인하고 '가져오기 시작'을 누르면 자동으로 이슈가 생성된다. 

 

 

 

 

생성한 이슈들은 백로그에서 확인할 수 있다.

 

위의 설명은 기존 이슈를 내려받아 활용하는 방식으로 작성하였지만, 위 내용을 적용하면 새롭게 csv 파일을 만드는 방식으로도 이슈의 일괄 등록을 쉽게 처리할 수 있을 것이다.