이슈 트리아지는 유형 및 심각도에 따라 분류하는 프로세스입니다. 프로젝트가 성장하고 사람들이 더 많은 이슈를 만들면, 들어오는 이슈를 트리아지하는 방법에 대한 워크플로를 만드는 것이 가치 있습니다.

이 튜토리얼에서는 이 시나리오를 위한 하위 그룹이 있는 GitLab 그룹을 설정하는 방법을 배웁니다.

이슈 트리아지를 위한 하위 그룹이 있는 복잡한 그룹으로 GitLab을 설정하려면:

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

시작하기 전에#

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

그룹 만들기#

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

새 그룹을 만들려면:

1. 오른쪽 상단에서 새로 만들기 (+)를 선택하고 새 그룹을 선택합니다.
2. 그룹 만들기를 선택합니다.
3. 그룹 세부 정보를 입력합니다:
   • 그룹 이름에 Web App Dev 또는 다른 값을 입력합니다.
4. 페이지 하단에서 그룹 만들기를 선택합니다.

그룹 내에 하위 그룹 만들기#

하위 그룹은 그룹 안의 그룹입니다. 하위 그룹은 대규모 프로젝트를 구성하고 권한을 관리하는 데 도움이 됩니다.

새 하위 그룹을 만들려면:

1. 상단 표시줄에서 검색 또는 이동을 선택하고 Web App Dev 그룹을 찾습니다.
2. 새로 만들기 (+)를 선택하고 새 하위 그룹을 선택합니다.
3. 하위 그룹 세부 정보를 입력합니다:
   • 하위 그룹 이름에 Frontend 또는 다른 값을 입력합니다.
4. 하위 그룹 만들기를 선택합니다.
5. 이 프로세스를 반복하여 Backend 또는 다른 값으로 두 번째 하위 그룹을 만듭니다.

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

여러 프로젝트에 걸쳐 이슈 추적을 관리하려면 하위 그룹에 프로젝트를 만들어야 합니다.

새 프로젝트를 만들려면:

1. 상단 표시줄에서 검색 또는 이동을 선택하고 Frontend 하위 그룹을 찾습니다.
2. 오른쪽 상단에서 새로 만들기 (+)를 선택하고 새 프로젝트/저장소를 선택합니다.
3. 빈 프로젝트 만들기를 선택합니다.
4. 프로젝트 세부 정보를 입력합니다:
   • 프로젝트 이름에 Web UI를 입력합니다. 자세한 내용은 프로젝트 명명 규칙을 참조합니다.
5. 페이지 하단에서 프로젝트 만들기를 선택합니다.
6. 이 프로세스를 반복하여 Frontend 하위 그룹에 Accessibility Audit라는 두 번째 프로젝트와 Backend 하위 그룹에 API라는 세 번째 프로젝트를 만듭니다.

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

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

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

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

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

영감을 위해 GitLab에서 이를 정의하는 방법을 참조합니다:

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

기준 문서화#

모든 기준에 동의한 후 팀원들이 항상 액세스할 수 있는 곳에 모두 기록합니다.

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

범위 레이블 만들기#

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

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

이전에 모은 유형, 심각도, 우선순위 목록을 확인하여 일치하는 범위 레이블을 만들어야 합니다.

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

레이블을 모든 하위 그룹의 모든 프로젝트에서 사용할 수 있도록 하려면 먼저 하위 그룹을 포함하는 상위 그룹으로 이동합니다. 특정 하위 그룹의 프로젝트에서만 레이블을 사용할 수 있도록 하려면 하위 그룹 내에서 다음 단계를 따릅니다.

각 레이블을 만들려면:

1. 상단 표시줄에서 검색 또는 이동을 선택하고 Web App Dev 그룹을 찾습니다.
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. 상단 표시줄에서 검색 또는 이동을 선택하고 Web App Dev 그룹을 찾습니다.
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에 대해 이전 단계를 반복합니다.

하위 그룹 이슈 보드를 만들려면 하위 그룹 내에서 3-10단계를 따릅니다.

지금은 보드의 목록이 비어 있어야 합니다. 다음으로 이슈로 채웁니다.

기능에 대한 이슈 만들기#

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

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

Issue triage (by severity) 보드에서 이슈를 만들려면:

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

   지금은 Open 목록을 사용하겠습니다.

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

3. 필드를 작성합니다:

   • 제목에 Dark mode toggle을 입력합니다.
   • 이 이슈가 적용되는 프로젝트를 선택합니다. Frontend / Web UI를 선택합니다.

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

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

   예를 들어 웹 API 앱을 만드는 경우 Frontend와 Backend는 서로 다른 엔지니어링 팀을 의미합니다. 프로젝트는 스택 개발의 다양한 측면을 나타냅니다. 다음 이슈를 만들고 적절한 프로젝트에 배정합니다:

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

첫 번째 트리아지 이슈 보드가 준비되었습니다! Open 목록의 일부 이슈를 레이블 목록 중 하나로 드래그하여 심각도 레이블 중 하나를 추가해 보십시오.

다음 단계#

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

• 이슈 보드 사용 방법 조정. 일부 옵션은 다음을 포함합니다:

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

• 각 레이블로 필터링된 이슈 목록에서 우선순위 또는 심각도별로 이슈를 탐색합니다. 사용 가능한 경우 "is one of" 필터 연산자를 활용합니다.

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

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

  

GitLab에서의 이슈 트리아지에 대해 자세히 알아보려면 이슈 트리아지 및 트리아지 작업을 참조합니다.