[Jira Server/Data Center] 이미 생성된 그룹의 그룹 이름 변경하기

 문제

Jira에서 그룹은 이름이 Key 값으로, 그룹 생성 후 그룹 이름을 변경할 수 없습니다.
조직 변경 등으로 그룹 이름 변경이 불가피할 경우,

  • Jira Database 접근을 통해 그룹 이름과 이와 관련된 값(그룹 이름이 포함된 값)들을 DB 쿼리를 통해 수동으로 변경하거나

  • Jira 관리자에서 기존 그룹을 삭제하고 신규 그룹을 생성하여 동일하게 구성원 추가 및 권한 재설정하는 방법이 있습니다.

상기 2가지 방법 모두 필터 및 워크플로우에서 사용된 그룹 이름은 쿼리를 통해 확인한 후, Jira에서 직접 편집합니다.

해결책

본 작업은 Jira Database 변경 작업으로, 작업 진행 전에 DB 백업을 권장합니다.

Jira Database에서 그룹 이름과 이와 관련된 값을 변경하는 방법은 다음과 같습니다.

1) Jira Database 작업을 위해 Jira를 종료

2) Jira Database에서 SQL 조회를 실행

  • <NEW_GROUP_NAME>, <NEW_GROUP_NAME_LOWERCASE>, <OLD_GROUP_NAME>을 그룹의 실제 이름으로 변경

3) 그룹 이름 쿼리를 통해 변경

4) 그룹 이름이 사용되는 모든 엔티티에서 새로운 이름으로 변경

5) Jira 재시작

 


 

Jira 관리자에서 신규 그룹을 생성하여 재설정을 진행하는 방법은 다음과 같습니다.

1) 신규 그룹 생성하여 기존 그룹의 구성원을 동일하게 추가

1. [Jira 관리 > 사용자 관리 > 그룹] 페이지로 이동

2. 그룹 추가 영역의 이름 인풋박스에 신규 그룹 이름 입력 후, [그룹 추가] 버튼 클릭

image-20240223-020145.png

3. 필터 그룹 영역의 필터 인풋박스에 삭제하고자 하는 그룹 이름을 입력 후, [필터] 버튼 클릭하여 조회

image-20240223-020527.png

4. 조회된 그룹 이름의 구성원 확인을 위해 [구성원 편집] 버튼 클릭

5. 전환된 ‘그룹 구성원 편집’ 화면에서 선택된 그룹에 포함된 구성원을 확인

6. 다시 신규 생성된 그룹 이름을 조회하여 ‘그룹 구성원 편집’ 화면에서 동일하게 구성원을 추가

a. 사용자 아이콘을 클릭 > 출력된 팝업을 통해 구성원을 조회 및 추가 > [Add Selected Users] 버튼 클릭 > 선택된 그룹에 사용자를 추가

b. 선택된 그룹에 사용자를 추가 > 그룹 목록으로 다시 이동

7. 신규 그룹 이름 조회를 통해 구성원 추가 확인

2) DB 쿼리를 통해 기존 그룹 이름이 사용되는 모든 엔티티 확인

기존 그룹의 삭제 작업은 신규 그룹에 대한 권한 재설정 및 충분한 테스트 과정을 거친 후에 진행하는 것이 안전합니다.

 


 

Jira Database에서 그룹 이름이 포함된 필터와 워크플로우를 조회하는 방법은 다음과 같습니다.

1) 그룹 이름이 포함된 필터 조회

1. 쿼리를 통해 그룹 이름이 사용된 필터 목록을 확인

2. 헤더 영역의 [이슈 > 필터 관리] 페이지로 이동

3. 확인된 필터 목록에 새로운 그룹 이름으로 업데이트

2) 그룹 이름이 포함된 워크플로우 목록 확인

1. 쿼리를 통해 그룹 이름이 사용된 워크플로우 목록을 확인

2. [Jira 관리 > 이슈 > 워크플로우] 페이지로 이동

3. 확인된 워크플로우에서 조건 또는 다른 세부 사항에서 ‘새로운 그룹 이름’으로 업데이트

필터 및 워크플로우에서 사용된 그룹 이름은 쿼리를 통해 변경하는 것은 오류가 발생할 가능성이 큽니다. 쿼리를 실행하여 그룹 이름이 포함된 필터 및 워크플로우 목록을 확인한 후, Jira에서 직접 편집합니다

 

 관련 문서