이슈 트리아지는 유형과 심각도에 따라 분류하는 프로세스입니다. 프로젝트가 성장하고 더 많은 이슈가 생성됨에 따라, 수신되는 이슈를 트리아지하는 워크플로우를 만드는 것이 좋습니다.

이 튜토리얼에서는 이 시나리오를 위해 여러 프로젝트가 있는 GitLab 그룹을 설정하는 방법을 배웁니다.

프로젝트에서 이슈 트리아지를 위해 GitLab을 설정하려면:

1. 그룹 만들기
2. 그룹 내에 프로젝트 만들기
3. 유형, 심각도, 우선순위 기준 결정
4. 기준 문서화
5. 범위 레이블 만들기
6. 새 레이블 우선순위 지정
7. 그룹 이슈 트리아지 보드 만들기
8. 기능에 대한 이슈 만들기

시작하기 전에#

• 이 튜토리얼에 기존 프로젝트를 사용하는 경우, 해당 프로젝트에서 Reporter, Developer, Maintainer 또는 Owner 권한이 있는지 확인합니다.
  • 기존 프로젝트에 상위 그룹이 없는 경우, 그룹을 만들고 프로젝트 레이블을 그룹 레이블로 승격합니다.

그룹 만들기#

그룹은 본질적으로 여러 프로젝트의 컨테이너입니다. 사용자가 여러 프로젝트를 관리하고 그룹 멤버들과 한 번에 소통할 수 있습니다.

새 그룹을 만들려면:

1. 오른쪽 상단에서 새로 만들기 (+)를 선택하고 새 그룹을 선택합니다.
2. 그룹 만들기를 선택합니다.
3. 그룹 세부 정보를 입력합니다.
   • 그룹 이름으로 triage-tutorial을 입력합니다.
4. 페이지 하단에서 그룹 만들기를 선택합니다.

그룹 내에 프로젝트 만들기#

여러 프로젝트 간에 이슈 추적을 관리하려면 그룹 내에 최소 두 개의 프로젝트를 만들어야 합니다.

새 프로젝트를 만들려면:

1. 오른쪽 상단에서 새로 만들기 (+)를 선택하고 새 프로젝트/리포지터리를 선택합니다.
2. 빈 프로젝트 만들기를 선택합니다.
3. 프로젝트 세부 정보를 입력합니다:
   • 프로젝트 이름으로 test-project-1을 입력합니다. 자세한 내용은 프로젝트 이름 규칙을 참조하세요.
4. 페이지 하단에서 프로젝트 만들기를 선택합니다.
5. 이 과정을 반복하여 test-project-2라는 두 번째 프로젝트를 만듭니다.

유형, 심각도, 우선순위 기준 결정#

다음으로 다음을 결정해야 합니다:

• 인식하려는 이슈의 유형. 더 세분화된 접근이 필요한 경우 각 유형에 대한 하위 유형도 만들 수 있습니다. 유형은 팀에 요청된 작업의 종류를 이해하기 위해 작업을 분류하는 데 도움이 됩니다.
• 수신 작업이 최종 사용자에게 미치는 영향을 정의하고 우선순위를 정하는 데 도움이 되는 우선순위 및 심각도 수준.

이 튜토리얼에서는 다음과 같이 결정했다고 가정합니다:

• 유형: Bug, Feature, Maintenance
• 우선순위: 1, 2, 3, 4
• 심각도: 1, 2, 3, 4

GitLab에서 이를 어떻게 정의하는지 참고하세요:

• 유형 및 하위 유형
• 우선순위
• 심각도

기준 문서화#

모든 기준에 합의한 후 팀원들이 항상 접근할 수 있는 곳에 기록해 두세요.

예를 들어, 프로젝트의 위키나 GitLab Pages로 게시된 회사 핸드북에 추가합니다.

범위 레이블 만들기#

다음으로 이슈를 분류하기 위해 추가할 레이블을 만듭니다.

이를 위한 최선의 도구는 범위 레이블이며, 상호 배타적인 속성을 설정하는 데 사용할 수 있습니다.

이전에 조합한 유형, 심각도, 우선순위 목록을 확인하고 그에 맞는 범위 레이블을 만들고 싶을 것입니다.

범위 레이블 이름의 이중 콜론(::)은 같은 범위의 두 레이블이 함께 사용되는 것을 방지합니다. 예를 들어, 이미 type::bug가 있는 이슈에 type::feature 레이블을 추가하면 이전 레이블이 제거됩니다.

각 레이블을 만들려면:

1. 상단 바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
2. 관리 > 레이블을 선택합니다.
3. 새 레이블을 선택합니다.
4. 제목 필드에 레이블 이름을 입력합니다. type::bug로 시작합니다.
5. 선택 사항. 사용 가능한 색상 중에서 색상을 선택하거나 배경색 필드에 특정 색상의 16진수 색상 값을 입력합니다.
6. 레이블 만들기를 선택합니다.

3-6단계를 반복하여 필요한 모든 레이블을 만듭니다. 다음은 몇 가지 예시입니다:

• type::bug
• type::feature
• type::maintenance
• priority::1
• priority::2
• priority::3
• priority::4
• severity::1
• severity::2
• severity::3
• severity::4

새 레이블 우선순위 지정#

이제 새 레이블을 우선순위 레이블로 설정합니다. 이렇게 하면 우선순위 또는 레이블 우선순위로 정렬할 때 가장 중요한 이슈가 이슈 목록 맨 위에 표시됩니다.

우선순위 또는 레이블 우선순위로 정렬할 때 어떤 일이 발생하는지 알아보려면 이슈 목록 정렬 및 순서 지정을 참조하세요.

레이블 우선순위를 지정하려면:

1. 레이블 페이지에서 우선순위를 지정할 레이블 옆에 있는 우선순위 지정 ([star-o])을 선택합니다. 이 레이블은 이제 우선순위 레이블 아래의 레이블 목록 상단에 나타납니다.
2. 이 레이블들의 상대적 우선순위를 변경하려면 목록에서 위아래로 드래그합니다. 목록에서 더 위에 있는 레이블이 더 높은 우선순위를 갖습니다.
3. 이전에 만든 모든 레이블의 우선순위를 지정합니다. 더 높은 우선순위 및 심각도의 레이블이 낮은 값의 레이블보다 목록에서 더 위에 있는지 확인합니다.

그룹 이슈 트리아지 보드 만들기#

수신 이슈 백로그를 준비하기 위해 레이블별로 이슈를 구성하는 이슈 보드를 만듭니다. 카드를 다양한 목록으로 드래그하여 이슈를 빠르게 만들고 레이블을 추가하는 데 사용합니다.

이슈 보드를 설정하려면:

1. 보드의 범위를 결정합니다. 예를 들어, 이슈에 심각도를 할당하는 데 사용할 그룹 이슈 보드를 만듭니다.
2. 상단 바에서 검색 또는 이동을 선택하고 triage-tutorial 그룹을 찾습니다.
3. 플랜 > 이슈 보드를 선택합니다.
4. 이슈 보드 페이지 왼쪽 상단에서 현재 보드 이름이 있는 드롭다운 목록을 선택합니다.
5. 새 보드 만들기를 선택합니다.
6. 제목 필드에 Issue triage (by severity)를 입력합니다.
7. 열린 목록 표시 체크박스를 선택된 상태로 유지하고 닫힌 목록 표시 체크박스를 해제합니다.
8. 보드 만들기를 선택합니다. 빈 보드가 표시됩니다.
9. severity::1 레이블에 대한 목록을 만듭니다:
   1. 이슈 보드 페이지 오른쪽 상단에서 목록 만들기를 선택합니다.
   2. 나타나는 열에서 값 드롭다운 목록의 severity::1 레이블을 선택합니다.
   3. 목록 하단에서 보드에 추가를 선택합니다.
10. severity::2, severity::3, severity::4 레이블에 대해 이전 단계를 반복합니다.

지금은 보드의 목록이 비어 있어야 합니다. 다음으로 몇 가지 이슈를 채울 것입니다.

기능에 대한 이슈 만들기#

예정된 기능 및 버그를 추적하려면 몇 가지 이슈를 만들어야 합니다. 이슈는 프로젝트에 속하지만 그룹 이슈 보드에서 직접 만들 수도 있습니다.

계획된 기능에 대한 이슈를 만드는 것부터 시작합니다. 버그가 발견되면 이슈를 만들 수 있습니다(너무 많지 않기를 바랍니다!).

이슈 트리아지(심각도 기준) 보드에서 이슈를 만들려면:

1. 열기 목록으로 이동합니다. 이 목록은 다른 보드 목록에 맞지 않는 이슈를 보여줍니다. 이슈에 어떤 심각도 레이블이 있어야 하는지 이미 알고 있다면 해당 레이블 목록에서 직접 만들 수 있습니다. 레이블 목록에서 만들어진 각 이슈에는 해당 레이블이 부여됩니다.

   지금은 열기 목록을 사용하여 진행합니다.

2. 열기 목록에서 새 이슈 만들기 아이콘 (+)을 선택합니다.

3. 필드를 작성합니다:

   • 제목에 User registration을 입력합니다.
   • 이 이슈가 적용되는 프로젝트를 선택합니다. test-project-1을 선택합니다.

4. 이슈 만들기를 선택합니다.

5. 이 단계를 반복하여 몇 가지 이슈를 더 만듭니다.

   예를 들어, 앱을 만든다면 test-project-1과 test-project-2가 애플리케이션의 백엔드와 프론트엔드를 가리킨다고 상상해 보세요. 다음 이슈들을 만들고 적절히 프로젝트에 할당합니다:

   • User registration
   • Profile creation
   • Search functionality
   • Add to favorites
   • Push notifications
   • Social sharing
   • In-app messaging
   • Track progress
   • Feedback and ratings
   • Settings and preferences

첫 번째 트리아지 이슈 보드가 준비되었습니다! 열기 목록에서 이슈를 레이블 목록 중 하나로 드래그하여 심각도 레이블 중 하나를 추가해 보세요.

다음 단계#

다음으로 다음을 수행할 수 있습니다:

• 이슈 보드 사용 방법을 조정합니다. 몇 가지 옵션은 다음과 같습니다:

  • 현재 이슈 보드를 편집하여 우선순위 및 유형 레이블에 대한 목록도 추가합니다. 이렇게 하면 보드가 더 넓어지고 수평 스크롤이 필요할 수 있습니다.
  • Issue triage (by priority) 및 Issue triage (by type)라는 별도의 이슈 보드를 만듭니다. 이렇게 하면 다양한 유형의 트리아지 작업이 분리되지만 보드 간에 전환이 필요합니다.
  • 팀 인계를 위한 이슈 보드 설정.

• 이슈 목록에서 우선순위 또는 심각도별로 이슈를 검색하되, 각 레이블로 필터링합니다. 사용 가능한 경우 "다음 중 하나" 필터 연산자를 활용합니다.

• 이슈를 작업으로 분해합니다.

• gitlab-triage gem을 사용하여 프로젝트에서 이슈 트리아지를 자동화하는 정책을 만듭니다. 다음과 같은 히트맵으로 요약 보고서를 생성합니다:

  

GitLab에서의 이슈 트리아지에 대해 자세히 알아보려면 이슈 트리아지 및 트리아지 운영을 참조하세요.