튜토리얼: 이슈 분류를 위한 프로젝트 설정


Tier: Free, Premium, Ultimate
Offering: GitLab.com, Self-managed, GitLab Dedicated

이슈 분류는 유형 및 심각도에 따라 분류하는 프로세스입니다.
프로젝트가 성장하고 사람들이 더 많은 이슈를 생성할수록, 들어오는 이슈를 분류하는 워크플로우를 만드는 것이 가치가 있습니다.

이 튜토리얼에서는 GitLab 프로젝트를 이슈 분류를 위해 설정하는 방법을 배웁니다.

GitLab에서 이슈 분류를 위해 GitLab을 설정하려면 다음을 수행하세요.

  1. 프로젝트 생성
  2. 유형, 심각도 및 우선 순위 기준 결정
  3. 기준 문서화
  4. 스코프 라벨 생성
  5. 새 라벨 우선화
  6. 이슈 분류 보드 생성
  7. 기능에 대한 이슈 생성

시작하기 전에

-이 튜토리얼에 기존 프로젝트를 사용하는 경우, 해당 프로젝트에 대한 적어도 리포터 역할이 있음을 확인하세요.
-아래 단계를 따라 나중에 프로젝트의 상위 그룹을 만들기로 결정하면, 라벨을 최대한 활용하려면 프로젝트 라벨을 그룹 라벨로 승격해야 합니다.
먼저 그룹을 만들고 고려해 보세요.

프로젝트 생성

프로젝트에는 향후 코드 변경을 계획하는 데 사용되는 이슈가 포함되어 있습니다.

이미 작업 중인 프로젝트가 있는 경우 유형, 심각도 및 우선 순위 결정으로 이동하세요.

빈 프로젝트를 만들려면:

  1. 왼쪽 사이드바에서 위쪽에 있는 만들기 () 및 새 프로젝트/저장소 만들기를 선택합니다.
  2. 빈 프로젝트 만들기를 선택합니다.
  3. 프로젝트 세부 정보 입력
    • 프로젝트 이름이슈 분류 튜토리얼을 입력합니다.
  4. 프로젝트 만들기를 선택합니다.

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

다음으로, 다음을 결정해야 합니다.

-인식하려는 이슈의 유형. 더 구체적인 접근이 필요한 경우 각 유형에 대한 하위 유형도 만들 수 있습니다. 유형은 요청된 작업의 종류에 대한 이해를 얻기 위해 작업을 범주화하는 데 도움이 됩니다.
-종류의 우선 순위심각도 수준은 들어오는 작업이 최종 사용자에게 미치는 영향을 정의하고 우선 순위를 지원하는 데 도움이 됩니다.

이 튜토리얼의 경우 다음을 가정해 봅시다.

-유형: 버그, 기능, 및 유지보수
-우선 순위: 1, 2, 3, 및 4
-심각도: 1, 2, 3, 및 4

영감을 얻으려면 GitLab에서 이러한 작업을 어떻게 정의하는지 확인해 보세요.

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

기준 문서화

모든 기준에 동의한 후 팀원들이 항상 액세스할 수 있는 위치에 모두 작성하세요.

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

스코프 라벨 생성


Tier: Premium, Ultimate
Offering: GitLab.com, Self-managed, GitLab Dedicated

다음으로, 이러한 문제를 범주화하기 위해 이슈에 추가할 라벨을 만듭니다.

가장 좋은 도구는 서로 배타적인 속성을 설정하는 데 사용할 수 있는 스코프 라벨입니다.

이전에 결정한 유형, 심각도 및 우선 순위 목록을 확인하여 일치하는 스코프 라벨을 만들어야 합니다.

스코프 라벨 이름에 있는 이중 콜론(::)은 동일한 범주의 두 라벨이 함께 사용되는 것을 방지합니다.
예를 들어 type::bug라는 라벨을 이슈에 추가하면 기존 type::bug가 제거됩니다.

참고:
스코프 라벨은 프리미엄 및 얼티메이트 티어에서 사용할 수 있습니다.
프리 티어를 사용하는 경우 일반 라벨을 대신 사용할 수 있습니다.
그러나 서로 배타적이지 않습니다.

각 라벨을 만들려면 다음을 수행하세요.

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 관리 > 라벨을 선택합니다.
  3. 새 라벨을 선택합니다.
  4. 제목 필드에 라벨의 이름을 입력합니다. type::bug부터 시작하세요.
  5. 선택 사항입니다. 사용 가능한 색상 중에서 선택하거나 배경 색상 필드에 특정 색상의 16진수 색상 값을 입력하여 색상을 선택할 수 있습니다.
  6. 라벨 만들기를 선택합니다.

필요한 모든 라벨을 만들기 위해 이러한 단계를 반복하세요.

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

새 라벨 우선화

이제 새 라벨을 우선 라벨로 설정하여 우선 순위가 가장 높은 이슈가 우선 순위 또는 라벨 우선 순위로 정렬할 때 이슈 목록의 맨 위에 표시되도록 설정합니다.

우선 순위 또는 라벨 우선 순위로 정렬하면 무엇이 발생하는지 알아 보려면 이슈 목록 정렬 및 정렬을 참조하세요.

라벨을 우선화하려면 다음을 수행합니다.

  1. 라벨 페이지에서 우선화하려는 라벨 옆에 별표()를 선택합니다.
    이제이 라벨은 우선화 라벨 아래의 라벨 목록의 맨 위에 나타납니다.
  2. 상대적인 우선 순위를 변경하려면 목록을 위아래로 끌어옵니다.
    목록 상단에 있는 라벨이 우선 순위가 높습니다.
  3. 이전에 만든 라벨의 우선 순위를 모두 지정하세요.
    낮은 값보다 높은 우선 순위와 심각도의 라벨이 목록 상단에 표시되도록 합니다.

우선 순위 라벨 목록

이슈 트리지 보드 생성

들어오는 이슈 대기열을 준비하기 위해 이슈 보드를 생성하여 레이블에 의해 이슈를 구성합니다. 카드를 드래그하여 여러 목록으로 빠르게 이슈를 생성하고 레이블을 추가하는 데 사용됩니다.

이슈 보드를 설정하는 방법:

  1. 보드의 범위를 결정합니다. 예를 들어, 이슈에 심각도를 할당하는 데 사용할 하나를 생성합니다.
  2. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 이슈 트리지 튜토리얼 프로젝트를 찾습니다.
  3. 계획 > 이슈 보드를 선택합니다.
  4. 이슈 보드 페이지의 왼쪽 상단에서 현재 보드명이 표시된 드롭다운 목록을 선택합니다.
  5. 새 보드 생성을 선택합니다.
  6. 제목 필드에 이슈 트리지 (심각도 별)를 입력합니다.
  7. 열린 목록 표시 확인란을 선택하고 닫힌 목록 표시 확인란을 해제합니다.
  8. 보드 생성을 선택합니다. 빈 보드가 표시되어야 합니다.
  9. severity::1 레이블을 위한 목록을 생성합니다.
    1. 이슈 보드 페이지의 오른쪽 상단에서 목록 생성을 선택합니다.
    2. 나타나는 열에서 드롭다운 목록에서 severity::1 레이블을 선택합니다.
    3. 보드에 추가를 선택합니다.
  10. severity::2, severity::3, 그리고 severity::4 레이블에 대해 이전 단계를 반복합니다.

현재 보드의 목록은 비어 있어야 합니다. 이제 목록을 몇 가지 이슈로 채워야 합니다.

기능을 위한 이슈 생성

다가오는 기능 및 버그를 추적하기 위해 몇 가지 이슈를 생성해야 합니다. 이슈는 프로젝트에 속하지만 이슈 보드에서 직접 생성할 수도 있습니다.

이슈 트리지 (심각도 별) 보드에서 이슈를 생성하려면:

  1. 열린 목록에서 이슈 생성 ()를 선택합니다. 열린 목록은 다른 보드 목록의 아무 곳에도 속하지 않는 이슈를 표시합니다.

    이미 어떤 심각도 레이블로 이슈를 만들어야 하는지 알고 있다면 해당 레이블 목록에서 직접 만들 수 있습니다. 레이블 목록에서 생성된 각 이슈에는 해당 레이블이 지정됩니다.

  2. 필드를 작성합니다:
    • 제목 아래에 사용자 등록을 입력합니다.
  3. 이슈 생성을 선택합니다.
  4. 이러한 단계를 몇 번 반복합니다.

    예를 들어, 앱을 만들고 있다면 다음과 같은 이슈를 생성합니다:

    • 사용자 등록
    • 프로필 생성
    • 검색 기능
    • 즐겨찾기에 추가
    • 푸시 알림
    • 소셜 공유
    • 앱 내 메시지
    • 진행 상황 추적
    • 피드백 및 평가
    • 설정 및 기본 설정

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

예제 이슈가 있는 트리지 이슈 보드

다음 단계

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

  • 이슈 보드 사용 방법 조정. 몇 가지 옵션은 다음과 같습니다:
    • 현재 이슈 보드를 수정하여 우선순위 및 유형 레이블을 가진 목록도 포함시킵니다. 이렇게 하면 보드가 더 커지고 수평 스크롤이 필요할 수 있습니다.
    • 이슈 트리지 (우선순위 별)이슈 트리지 (유형 별)라는 별도의 이슈 보드를 생성합니다. 이렇게 하면 다양한 유형의 트리지 작업을 따로 유지할 수 있지만 보드 간 전환이 필요할 수 있습니다.
    • 팀 인계를 위한 이슈 보드 설정.
  • 이슈 목록에서 우선순위 또는 심각도별로 이슈를 찾아보고, 각 레이블로 필터링하여 검색하세요. 가능하다면 «중 하나» 필터 연산자를 활용하십시오.
  • 이슈를 작업으로 분해.
  • gitlab-triage을 사용하여 프로젝트에서 이슈 트리지를 자동화하는 데 도움이 되는 정책 생성. 다음과 같은 히트맵과 같은 요약 보고서 생성:

    예제 트리지 보고서 히트맵

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