Jira 연동 가이드

이 문서가 필요한 경우

Jira 사이트와 프로젝트에 접근할 수 있는 계정이 필요합니다. 가능하면 프로젝트 관리자 권한이 있는 계정으로 연결하세요. 필드 목록과 webhook 설정은 Jira 권한에 따라 보이는 범위가 달라질 수 있습니다.

먼저 어떤 프로젝트로 이슈스티커 이슈를 보낼지 정합니다. 여러 팀이 한 Jira 사이트를 쓰더라도 이슈스티커 프로젝트마다 Jira 프로젝트를 따로 선택할 수 있습니다.

연결 전에는 “어떤 Jira 티켓이 만들어져야 성공인가”를 먼저 정하세요. 예를 들어 Bug 이슈 타입, 우선순위, 컴포넌트, 담당자 정도만 첫 범위로 잡으면 검증이 쉽습니다.

이슈스티커 관리자에서 프로젝트 설정으로 들어가 Jira 연동을 시작합니다. Atlassian 로그인 화면이 열리면 사용할 계정을 고르고 권한을 허용합니다.

연결이 끝나면 Jira 사이트 목록이 표시됩니다. 회사가 여러 사이트를 쓰는 경우 이름이 비슷할 수 있으니 URL까지 확인하세요.

연동할 Jira 사이트를 고른 뒤 이슈를 만들 프로젝트를 선택합니다. 선택한 프로젝트의 이슈 타입과 필드가 이슈스티커에 로드됩니다.

처음에는 팀이 실제로 처리하는 기본 이슈 타입을 선택하세요. 예를 들어 버그 처리 흐름이 Bug 타입에 맞춰져 있다면 Bug로 시작하는 편이 좋습니다.

Jira에는 팀마다 다른 커스텀 필드가 많습니다. 이슈스티커에서는 실제로 입력받을 필드만 노출하는 방식이 좋습니다.

필드가 너무 많으면 QA가 이슈를 만들 때 멈칫하게 됩니다. 반드시 필요한 필드부터 켜고, 나머지는 Jira에서 후속 정리하도록 두는 편이 안정적입니다.

Extension이나 SDK에서 이슈를 만든 뒤 Jira로 보내기를 실행합니다. 제목, 설명, URL, 캡처 이미지, 녹화 링크, 브라우저 정보가 함께 전달됩니다.

필수 필드가 빠져 있으면 Jira가 이슈 생성을 거절할 수 있습니다. 이 경우 이슈스티커에서 표시되는 필드 안내를 보고 필요한 값을 채운 뒤 다시 생성하세요.

첫 테스트에서는 필수 필드가 가장 적은 이슈 타입으로 시작하세요. 생성이 안정적으로 된 뒤 팀별 커스텀 필드를 하나씩 늘리는 편이 문제 원인을 찾기 쉽습니다.

Jira에서 상태나 담당자가 바뀐 뒤 이슈스티커에 반영되는지 확인합니다. 즉시 반영되지 않으면 잠시 기다린 뒤 새로고침하세요. Jira API 응답과 webhook 처리 시간 때문에 몇 분 정도 차이가 날 수 있습니다.

동기화가 반복해서 늦다면 webhook 설정을 확인합니다.

Webhook은 Jira에서 바뀐 이슈 상태를 이슈스티커로 알려주는 장치입니다. 관리자 화면에서 webhook URL과 secret을 확인한 뒤 Jira의 시스템 설정에 등록합니다.

등록 후에는 테스트 이슈의 상태를 바꾸고 이슈스티커에서 변경이 들어오는지 봅니다. secret이 맞지 않으면 요청이 거절되므로, 복사할 때 앞뒤 공백이 들어가지 않았는지 확인하세요.

Jira 사이트가 보이지 않으면 Atlassian 계정이 해당 사이트에 접근 가능한지 확인합니다. 프로젝트가 보이지 않으면 프로젝트 권한을 확인합니다. 필드가 보이지 않으면 선택한 이슈 타입에 그 필드가 실제로 연결되어 있는지 Jira 설정에서 확인해야 합니다.