Jira
LaunchCal 출시를 Jira 에픽이나 이슈에 연동하면 출시가 그것을 따릅니다. 상태, 진행률, 댓글이 매일, 그리고 원할 때마다 동기화됩니다.
Taktoria에서 Jira가 하는 일
LaunchCal에서는 출시가 그 작업을 추적하는 Jira 에픽이나 아무 이슈를 따르게 할 수 있습니다. 이슈의 상태가 바뀌면 출시의 상태도 바뀌고, 에픽의 하위 이슈 중 몇 개가 완료되었는지 표시되며, 이슈의 댓글이 출시에 나타납니다.
Jira 프로젝트 전체에는 자체 상태가 없으므로 프로젝트로 가는 링크는 일반 링크로 보관됩니다. 따르게 하려면 그 프로젝트의 에픽이나 이슈를 연동하세요.
Taktoria는 Jira에서 읽기만 하며(이슈와 그 상태, 하위 이슈, 댓글, 그리고 댓글을 쓴 사람의 이름), 그곳에서 무엇도 만들거나 바꾸거나 댓글을 달지 않습니다.
Jira 연결하기
Jira는 워크스페이스 소유자나 관리자만 연결할 수 있습니다.
- 설정 → 통합을 엽니다.
- 티켓 시스템 아래에서 Jira 연결을 선택합니다.
- Atlassian에 로그인하고 연결할 Jira 사이트를 고른 뒤 승인합니다.
Taktoria는 Jira를 연결한 Atlassian 계정으로 Jira를 읽습니다. 그 계정이 볼 수 있는 이슈라면 출시를 수정할 수 있는 누구나 출시에 연동할 수 있고, 그 댓글도 출시에 표시됩니다. Jira에서 그 이슈를 열 수 없는 사람이라도 마찬가지입니다. 그러니 본인 계정 대신, 출시가 따르는 프로젝트만 볼 수 있는 Taktoria 전용 계정으로 Jira를 연결하세요. 개인 계정으로 만든 연결은 그 사람이 떠나거나 접근 권한을 잃으면 동기화도 멈춥니다.
출시를 에픽이나 이슈에 연동하기
출시를 수정할 수 있는 사람은 누구나 연동, 동기화, 연동 해제를 할 수 있습니다.
- 출시의 세부 정보 탭을 엽니다.
- 티켓 프로젝트에서 에픽이나 이슈의 주소를 프로젝트 링크에 붙여 넣습니다. 이슈 자체 페이지나, 그 이슈를 연 보드 또는 목록의 주소도 됩니다.
- 프로젝트 연동을 선택합니다.
이슈는 연결된 Jira 사이트에 있어야 하고, 연결한 계정이 볼 수 있어야 합니다. 바로 동기화됩니다. Jira가 연결되기 전에 붙여 넣은 링크는 일반 링크로 보관되고, 연결되면 동기화가 시작됩니다.
LaunchCal에 연결된 AI 어시스턴트와 REST API도 같은 규칙에 따라 출시를 연동, 동기화, 연동 해제할 수 있습니다.
동기화되는 내용과 시점
연동된 출시는 출시될 때까지 하루에 한 번, 그리고 누군가 지금 동기화를 선택할 때마다 동기화됩니다.
- 상태: 이슈의 상태가 바뀌면 출시의 상태도 따라갑니다. 할 일은 범위 설정, 진행 중은 개발 중(이미 디자인이나 테스트에 있는 출시는 그대로), 하지 않음이나 중복으로 완료된 이슈는 일시 중지가 됩니다. LaunchCal에서 고른 상태는 이슈의 상태가 다시 바뀔 때까지 유지됩니다.
- 진행률: 에픽의 하위 이슈 중 완료된 비율입니다.
- 댓글: 이슈의 댓글은 각각 출시의 활동 탭에 댓글로 추가되고, Jira에서 가져옴 표시와 원본 링크가 붙습니다. Jira에서 일부 사람에게만 공개된 댓글은 가져오지 않습니다. Jira에서 수정하면 다음 동기화 때 변경 사항이 반영됩니다.
- 완료: 이슈가 완료되면 출시에 준비되었다고 표시되고 담당자에게 알립니다.
동기화로 바뀐 내용은 출시 기록, 담당자에게 보내는 알림, 감사 로그에서 Jira가 바꾼 것으로 표시됩니다. 감사 로그에는 댓글이 들어오거나 바뀌었다는 사실만 기록되며, 댓글 내용이나 언급된 사람은 기록되지 않습니다.
절대 하지 않는 일
- 무엇도 출시하지 않습니다. 완료된 이슈는 출시를 준비 완료로 만들 뿐이며, 필수 검토가 결정되면 누군가 **눌러서 출시하기!**를 선택해야 합니다.
- 이미 출시된 출시는 바꾸지 않습니다.
- Jira에 쓰지 않습니다.
- 일부 사람에게만 공개된 댓글은 가져오지 않습니다.
- 이슈의 상태가 다시 바뀌지 않는 한, LaunchCal에서 고른 상태를 되돌리지 않습니다.
연동 해제와 연결 해제
출시의 세부 정보 탭에서 연동 해제를 하면 그 출시의 동기화가 멈추며, 이미 가져온 내용은 그대로 남습니다.
설정 → 통합에서 연결 해제를 하면 Jira에서 오는 모든 출시의 동기화가 멈춥니다. 출시는 연동된 대상과 그때까지 동기화된 내용을 모두 유지하며, Jira를 다시 연결하면 동기화를 이어 갑니다. Atlassian의 요구에 따라 Jira 연결을 해제하면 가져온 댓글에서 Jira 사용자의 이름도 제거됩니다. 댓글 내용은 남지만 작성자 이름은 남지 않으며, 멘션은 @someone으로 표시됩니다. Atlassian이 어떤 사람의 계정이 해지되었다고 알려 오면 그 사람의 이름도 같은 방식으로 처리됩니다.
Atlassian은 Taktoria가 Jira에 대한 자체 접근 권한을 철회할 방법을 제공하지 않습니다. 완전히 제거하려면 Atlassian 계정의 연결된 앱에서도 Taktoria를 제거하세요.
문제 해결
- 이슈를 찾을 수 없음: 삭제되었거나, 옮겨졌거나, 연결한 계정이 볼 수 없는 곳에 있습니다. 그 계정에 이슈가 있는 프로젝트의 접근 권한을 주거나 현재 주소로 연동하세요.
- Jira가 연결을 거부함: 워크스페이스 소유자나 관리자가 설정 → 통합에서 Jira를 다시 연결합니다. 연결한 계정의 사람이 떠나거나 접근 권한을 잃으면 일어납니다.
- 지난 동기화에 Jira가 응답하지 않음: 다음 동기화 때 다시 시도하며, 나중에 지금 동기화를 선택해도 됩니다.
- 프로젝트 전체가 동기화되지 않음: 프로젝트에는 자체 상태가 없습니다. 대신 그 프로젝트의 에픽이나 이슈를 연동하세요.
- 댓글이 보이지 않음: Jira에서 일부 사람에게만 공개된 댓글은 가져오지 않습니다.