이슈스티커이 문서가 필요한 경우
- 팀에서 Jira로 프로젝트를 관리하고 있는 경우
- 이슈스티커에서 생성하는 버그 리포트를 Jira 티켓으로 한 번에 관리하고 싶은 경우
- Jira에서 바뀐 상태와 담당자를 이슈스티커에도 반영하려는 경우
시작하기 전에
Jira 사이트와 프로젝트에 접근할 수 있는 계정이 필요합니다. 가능하면 프로젝트 관리자 권한이 있는 계정으로 연결하세요. 계정 권한에 따라 이슈스티커에 보이는 필드 목록이 달라집니다.
이슈스티커 프로젝트마다 Jira 프로젝트를 따로 선택할 수 있으니, 어느 프로젝트로 이슈를 보낼지 먼저 정해두세요.
끝나면 확인할 것
- 연결할 Jira 사이트, 프로젝트, 이슈 타입을 정했습니다.
- 이슈 생성 시 입력할 필드와 Jira에서 후속 정리할 필드를 나눴습니다.
- 테스트 이슈를 만들고 제목, 설명, URL, 캡처·녹화 링크가 들어갔는지 확인했습니다.
1. OAuth 연결하기
관리자 콘솔의 프로젝트 설정에서 Jira 연동을 시작합니다. Atlassian 로그인 화면이 열리면 사용할 계정을 고르고 권한을 허용합니다.
권한 목록에는 이슈 읽기·쓰기와 함께 변경 알림 수신 권한이 포함됩니다. 이 권한으로 이슈스티커가 Jira에 변경 알림을 직접 등록하므로, Jira 시스템 설정을 따로 만질 일은 없습니다.
2. 사이트와 프로젝트 선택하기
연동할 Jira 사이트와 이슈를 만들 프로젝트를 선택합니다. 선택한 프로젝트의 이슈 타입과 필드가 이슈스티커로 로드됩니다.
3. 연동할 필드 정하기
Jira가 노출한 필드 중 이슈스티커에서 실제로 입력받을 항목만 켭니다. 담당자, 우선순위, 컴포넌트, 스프린트처럼 리포트 단계에서 꼭 필요한 필드부터 켜고, 나머지는 Jira에서 후속 정리하도록 두세요.
필수 필드가 많으면 이슈를 남기는 사람이 멈칫하고, 값이 빠져 Jira가 생성을 거절할 수도 있습니다.
4. 이슈 생성 확인하기
Extension이나 SDK에서 이슈를 만들면 제목, 설명, URL, 캡처 이미지, 녹화 링크, 브라우저 정보가 함께 Jira로 전달됩니다.
Jira 이슈 설명 하단에는 발견된 페이지 링크와 함께 이슈스티커 원본 이슈로 돌아오는 링크가 자동으로 붙습니다. Jira만 보고 작업하는 팀원도 이 링크로 이슈스티커에 들어가 스크린샷, 콘솔·네트워크 로그, 세션 리플레이 같은 상세 정보를 바로 확인할 수 있습니다.
필수 필드가 빠져 생성이 거절되면 이슈스티커에 필요한 필드가 표시됩니다. 값을 채운 뒤 다시 생성하세요.
5. 동기화되는 범위 확인하기
제목은 양방향으로 동기화됩니다. 이슈스티커에서 제목을 고치면 Jira 요약(summary)이 바뀌고, Jira에서 요약을 고치면 이슈스티커 제목이 바뀝니다. 두 쪽을 동시에 고치면 Jira 쪽 값이 남습니다 — 별도의 충돌 해결 절차는 없으니 제목을 최종적으로 어디서 관리할지 팀 안에서 정해두세요.
설명은 Jira → 이슈스티커 방향으로만 동기화됩니다. Jira에서 설명을 고치면 이슈스티커에 반영되지만, 이슈스티커에서 설명을 고쳐도 그 내용은 Jira로 전달되지 않습니다. 설명을 Jira 쪽에서 계속 관리하고 싶다면 Jira에서 편집하세요.
이슈 생성 시 Jira 설명에 붙는 "이슈스티커 세부사항" 블록(발견된 페이지 링크·이슈스티커에서 보기 링크)도 이슈스티커로 되돌아오지 않습니다. Jira에서 온 설명을 반영할 때 이 블록은 자동으로 걸러내고 사람이 쓴 본문만 가져오므로, 매번 동기화될 때마다 꼬리표가 쌓이는 일은 없습니다.
Jira → 이슈스티커 방향 반영에는 별도 설정이 없습니다. 사이트와 프로젝트 선택이 끝나면 이슈스티커가 Jira에 변경 알림을 자동으로 등록하고 유효 기간도 알아서 연장합니다.
Jira에서 상태나 담당자를 바꾼 뒤 이슈스티커에 반영되는지 확인하세요. 알림 전달과 필드 재조회 때문에 몇 분 정도 차이가 날 수 있고, 바로 확인하려면 이슈 팝오버의 Jira 연동 영역에서 필드 동기화를 누르면 됩니다.
문제가 생겼을 때 먼저 확인할 것
- Jira 사이트가 보이지 않으면 Atlassian 계정이 해당 사이트에 접근할 수 있는지 확인합니다.
- 프로젝트가 보이지 않으면 프로젝트 권한을 확인합니다.
- 필드가 보이지 않으면 선택한 이슈 타입에 그 필드가 연결되어 있는지 Jira 설정에서 확인합니다.
- 자동 반영만 안 된다면 프로젝트 설정의 Jira 연동 화면에서 변경 알림 등록 상태를 먼저 확인합니다. 등록되지 않았다면 사유가 함께 표시되고, 관리자는 그 자리에서 다시 등록할 수 있습니다.
필드 동기화를 누르면 자동 반영과 무관하게 지금 값을 즉시 가져올 수 있습니다.