지라(JIRA) 자동화 오류 해결하는 법
JIRA 자동화
일부 아니잖아.. 그냥 오류잖아..양날의 검
지라(JIRA)를 사용하다 보면 그 장점이 확실히 두드러진다. 하지만 높은 자유도가 때로는 단점으로 작용하기도 한다. 특히 초기 설정 단계에서는 상당한 어려움을 겪을 수 있는데, 그중에서도 자동화 관련 이슈가 가장 큰 스트레스 요인이었다.
지라(JIRA) 커뮤니티는 활성화되어 있지만, 개인이 겪는 특정 이슈가 커뮤니티의 일반적인 문제와 미묘하게 다를 수 있다. 광범위한 커뮤니티에서 유사한 사례를 찾지 못하는 경우, 해결책을 찾는 과정이 더욱 복잡해질 수 있다. 구글 검색 결과도 항상 정확한 해답을 제공하지는 않았다. 지금은 좀 괜찮으려나..?
*멘탈이 갈렸던 내가 못 찾았을 수도 있다..
지라의 핵심
지라(JIRA) 초기 설정에서 가장 중요한 두 가지 요소는 워크플로와 자동화다. 워크플로는 이슈의 생성부터 완료까지의 전체 프로세스를 정의한다. 쉽게 말해, 작업의 진행 경로를 설정하는 것이다.
자동화는 지라(JIRA)의 가장 강력한 기능 중 하나로 볼 수 있다. 높은 자유도와 다양한 기능을 제공하지만, 이는 동시에 복잡성을 증가시키는 요인이 된다. 올바른 설정 방법을 모를 경우, 다양한 오류와 문제에 직면할 수 있으며, 이는 상당한 시행착오를 필요로 할 수 있다. 과거의 나처럼. 수많은 삽질을 마주할 것이다...
그래서 나는
같은 오류를 만나서 열심히 해결책을 찾고 있는 사람들에게 조금이나마 도움이 될 수 있도록 완전 쌩 초반에 겪었던 사례와 해결책을 소개하겠다.
1. 모든 하위 이슈가 완료 → 상위 이슈 종료 or 상위 이슈가 완료 → 현재 모든 하위 이슈 종료
이 두 개의 자동화는 템플릿에 처음 진입 시, 추천하는 가장 기본 규칙이다.
이 자동화들이 에러를 뱉지 않는다면 당신은 이 글을 패스해도 괜찮은 사용자이거나 아마 워크플로를 아직 건들지 않았을 확률이 높다. 다른 자동화도 마찬가지지만 특히 이 규칙들은 그럴 확률이 높다.
아마 세팅 초기라면 두 가지 정도의 에러가 발생할 것이다.
case 1. 대상 상태를 확인하지 못하는 에러
대상 상태를 확인하지 못하는 에러이슈 내용 : 대상 상태를 확인하지 못했습니다. 스마트 값을 사용하는 경우(현재 상태의) 이슈에 대해 숫자 상태 ID 또는 버역되지 않은 이름으로 확인되어야 합니다.
워크플로를 건드렸다면 이 에러가 발생할 것이다. 원래 완료 부분에 워크플로 기본값은 모든 티켓이 완료 탭으로 이동가능하게 설정되어 있지만, 워크플로를 세팅하면서 그 부분을 수정하여 특정 티켓에서 완료 표시로 넘어가지 못하게 됨으로써 에러가 발생하는 것이다.
당신의 워크 플로가 다음처럼 생겼다고 가정하자
백로그 -> 개발하기로됨 -> 진행 중 -> 완료
쉽게 말해서. 완료로 가는 방법은 진행 중에서 완료로 가는 것밖에 없다!라고 설정해 놓으면
자동화에서 해당 설정이 우선시되기 때문에 자동화로 인해 백로그나 개발하기로됨에 있던 티켓이 완료로 가지 못하고 에러를 뱉게 되는 것이다.
추가 예시로 사이드를 했던 간단한 워크플로를 보도록 하자.
사이드 프로젝트 워크플로(변경 전)위 플로면 다음과 같이 진행될 것이다.
1. "모든 하위 이슈가 완료 → 상위 이슈 종료" 규칙을 기대하며 세팅
2. 에픽(BACKLOG) - 태스크 1(IN PROGRESS) 다음과 같은 상태에서 태스크 1을 작업 완료로 보냄
3. 1의 규칙 충족
4. 에픽(BACKLOG) -> 에픽(DONE)을 기대하지만 에러발생.
case 1. 해결책
이를 해결하기 위해서는 옮겨지길 기대하는 플로에 전부 권한을 줘야 한다.
워크플로를 다음처럼 수정해 보자.
사이드 프로젝트 워크플로(변경 후)마지막 Done 부분만 수정하였는데 하나하나 세팅해 줘도 되지만 편의상 전부 허용했다.
그렇게 작업해 보면 문제가 해결될 것이다.
그러나, 두 개의 오류를 함께 품을 수도 있으니 아래 오류도 같이 보는 것을 권장한다.
case2. 전환 중에 알 수 없는 필드 설정 에러
전환 중에 알 수 없는 필드 설정 에러이슈내용 : 전환 중에 알 수 없는 필드가 설정되었습니다. 전환 화면에 필드가 없을 수 있습니다. 필드 무시됨 - Resolution
이 경우는 말 그대로 필드 쪽을 검토해야 한다. 여기서 "나는 필드 설정한 게 없는데??"라고 생각할 수 있으나 자동화 기본값 때문에 설정이 되어 있는 부분들을 해제해줘야 한다.
case2. 해결책
규칙 상세(변경 전)1. 해당 규칙 상세 진입.
2. "설정할 필드 선택..." 클릭 후, 해결 체크박스를 해제.
3. 업데이트 클릭.
그렇다면 아래처럼 해결 드롭다운이 사라질 것이다.
규칙 상세(변경 후)결과
그럼 이제 잘 작동하는지 확인해 보자
문제없이 잘 진행된다!
마치며
지라(JIRA)는 확실히 강력한 도구지만 그만큼 복잡한 문제를 일으킬 수 있다. 이 글에서 다룬 내용은 빙산의 일각에 불과하다,, 지라 관련 이슈 보따리는 상당히 많기 때문에 시간이 날 때마다 유용한 팁과 해결책을 공유해 나갈 예정이다. 다음 글에서는 더 심화된 자동화 기법과 트러블 슈팅 방법을 다뤄볼 예정이다.
