레이블

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

GitLab에서 이슈, Merge Request 및 에픽의 수가 늘어날수록 해당 항목을 추적하기가 더 어려워집니다. 특히 조직이 소수의 사람에서 수백 또는 수천 명으로 성장함에 따라 그렇습니다. 레이블을 사용하면 작업을 정리하고 태그를 달아 관심 있는 작업 항목을 추적할 수 있습니다.

레이블은 이슈 보드의 중요한 부분입니다. 레이블을 사용하면 다음을 할 수 있습니다:

  • bug, feature request, 또는 docs와 같은 색과 설명적인 제목을 사용하여 에픽, 이슈 및 Merge Request을 분류합니다.
  • 에픽, 이슈 및 Merge Request을 동적으로 필터링하고 관리합니다.
  • 이슈, Merge Request 및 에픽 디렉터리 및 이슈 보드를 검색합니다.

레이블의 종류

GitLab에서는 두 가지 유형의 레이블을 사용할 수 있습니다:

  • 프로젝트 레이블은 해당 프로젝트의 이슈와 Merge Request에만 할당할 수 있습니다.
  • 그룹 레이블은 선택한 그룹이나 해당 하위 그룹의 모든 프로젝트의 이슈, Merge Request 및 에픽에 할당할 수 있습니다.

레이블 할당 및 미할당

이슈, Merge Request 또는 에픽에 레이블을 할당할 수 있습니다.

변경된 레이블은 즉시 다른 사용자에게 바로 보이며 페이지 새로 고침 없이 다음에서 볼 수 있습니다:

  • 에픽
  • 인시던트
  • 이슈
  • Merge Request

레이블을 할당하거나 미할당하려면:

  1. 사이드바의 레이블 섹션에서 편집을 선택합니다.
  2. 레이블 할당 디렉터리에서 레이블 이름을 입력하여 레이블을 검색합니다. 여러 번 검색하여 더 많은 레이블을 추가할 수 있습니다. 선택한 레이블은 체크 표시로 표시됩니다.
  3. 할당하거나 미할당할 레이블을 선택합니다.
  4. 레이블에 대한 변경 사항을 적용하려면 레이블 할당 옆의 X를 선택하거나 레이블 섹션 외의 영역을 선택합니다.

또는 레이블을 미할당하려면 해당 레이블 옆의 X를 선택합니다.

또한 빠른 액션으로 레이블을 할당하거나 미할당할 수 있습니다:

  • /label로 레이블을 할당합니다.
  • /unlabel로 레이블을 제거합니다.
  • /relabel로 모든 레이블을 제거하고 새 레이블을 할당합니다.

사용 가능한 레이블 보기

프로젝트 레이블 보기

프로젝트의 레이블을 보려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. Manage > Labels를 선택합니다.

또는:

  1. 이슈 또는 Merge Request을 보고 있습니다.
  2. 오른쪽 사이드바에서 레이블 섹션에서 편집을 선택합니다.
  3. 프로젝트 레이블 관리를 선택합니다.

레이블 디렉터리에는 프로젝트에서 작성된 레이블과 프로젝트의 상위 그룹에서 생성된 모든 레이블이 포함됩니다. 각 레이블에는 레이블이 생성된 프로젝트 또는 그룹 경로를 볼 수 있습니다.

그룹 레이블 보기

그룹의 레이블을 보려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
  2. Manage > Labels를 선택합니다.

또는:

  1. 에픽을 보고 있습니다.
  2. 오른쪽 사이드바에서 레이블 섹션에서 편집을 선택합니다.
  3. 그룹 레이블 관리를 선택합니다.

디렉터리에는 해당 그룹에서만 작성된 모든 레이블이 포함됩니다. 그룹의 프로젝트에서 생성된 레이블은 나열되지 않습니다.

레이블 생성

필수 사항:

  • 프로젝트 또는 그룹에 대해 적어도 리포터 역할을 가지고 있어야 합니다.

프로젝트 레이블 생성

프로젝트 레이블을 작성하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. Manage > Labels를 선택합니다.
  3. New label을 선택합니다.
  4. Title 필드에 레이블에 대한 짧고 설명적인 이름을 입력합니다. 또는 이 필드를 사용하여 범위가 지정된 상호 배타적 레이블을 작성할 수도 있습니다.
  5. 선택 사항. Description 필드에 추가 정보를 입력합니다. 레이블을 사용하는 방법과 시기에 대해 추가 정보를 입력할 수 있습니다.
  6. 선택 사항. 사용 가능한 색상 중에서 선택하여 색상을 선택하거나 특정 색상을 위해 16진수 색상 값을 입력합니다. Background color 필드에서.
  7. Create label을 선택합니다.

이슈 또는 Merge Request에서 프로젝트 레이블 생성

이슈 또는 Merge Request에서 새 프로젝트 레이블을 작성할 수도 있습니다. 이 방법으로 만든 레이블은 해당 이슈나 Merge Request과 동일한 프로젝트에 속합니다.

필수 사항:

  • 해당 프로젝트에 대해 적어도 리포터 역할을 가지고 있어야 합니다.

다음과 같이하면 됩니다:

  1. 이슈 또는 Merge Request을 보고 있습니다.
  2. 오른쪽 사이드바에서 레이블 섹션에서 편집을 선택합니다.
  3. 새 프로젝트 레이블 작성을 선택합니다.
  4. 이름 필드를 채웁니다. 이 방법으로 레이블을 만들 때는 설명을 지정할 수 없습니다. 나중에 레이블을 편집하여 설명을 추가할 수 있습니다.
  5. 사용 가능한 색상 중에서 선택하여 색상을 선택하거나 특정 색상을 위해 16진수 색상 값을 입력합니다.
  6. Create를 선택합니다. 레이블이 만들어집니다.

그룹 레이블 생성

그룹 레이블을 만들려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
  2. Manage > Labels를 선택합니다.
  3. New label을 선택합니다.
  4. Title 필드에 레이블에 대한 짧고 설명적인 이름을 입력합니다. 또는 이 필드를 사용하여 범위가 지정된 상호 배타적 레이블을 작성할 수도 있습니다.
  5. 선택 사항. Description 필드에 추가 정보를 입력합니다. 레이블을 사용하는 방법과 시기에 대해 추가 정보를 입력할 수 있습니다.
  6. 선택 사항. 사용 가능한 색상 중에서 선택하여 색상을 선택하거나 특정 색상을 위해 16진수 색상 값을 입력합니다. Background color 필드에서.
  7. Create label을 선택합니다.

Epic으로부터 그룹 라벨 생성

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

에픽으로부터 새 그룹 라벨을 생성할 수도 있습니다. 이 방법으로 생성하는 라벨은 에픽과 동일한 그룹에 속합니다.

전제 조건:

  • 해당 그룹에 대해 적어도 리포터 역할을 가져야 합니다.

수행 방법:

  1. 에픽을 보기.
  2. 오른쪽 사이드바의 라벨 섹션에서 편집을 선택합니다.
  3. 그룹 라벨 생성을 선택합니다.
  4. 이름 필드에 기입합니다. 이 방법으로 라벨을 생성하면 설명을 지정할 수 없습니다. 나중에 라벨 편집을 통해 설명을 추가할 수 있습니다.
  5. 사용 가능한 색상 중에서 선택하거나 특정 색상을 위한 16진수 색상 값을 입력하여 색상을 선택합니다.
  6. 생성을 선택합니다.

라벨 편집

전제 조건:

  • 프로젝트 또는 그룹에 대해 적어도 리포터 역할을 가져야 합니다.

프로젝트 라벨 편집

프로젝트 라벨을 편집하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하여 프로젝트를 찾습니다.
  2. 관리 > 라벨을 선택합니다.
  3. 편집할 라벨 옆에 수직 타원()을 선택한 다음 편집을 선택합니다.
  4. 변경 사항 저장을 선택합니다.

그룹 라벨 편집

그룹 라벨을 편집하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하여 그룹을 찾습니다.
  2. 관리 > 라벨을 선택합니다.
  3. 편집할 라벨 옆에 수직 타원()을 선택한 다음 편집을 선택합니다.
  4. 변경 사항 저장을 선택합니다.

라벨 삭제

caution
라벨을 삭제하면 영구적으로 삭제됩니다. 라벨에 대한 모든 참조가 시스템에서 제거되며 삭제를 취소할 수 없습니다.

전제 조건:

  • 프로젝트에 대해 적어도 리포터 역할을 가져야 합니다.

프로젝트 라벨 삭제

라벨을 삭제하려면 프로젝트에서:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하여 프로젝트를 찾습니다.
  2. 관리 > 라벨을 선택합니다.
  3. 구독 버튼 옆에 ()를 선택한 다음 삭제를 선택합니다.

그룹 라벨 삭제

그룹 라벨을 삭제하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하여 그룹을 찾습니다.
  2. 관리 > 라벨을 선택합니다.

  3. 한 가지를 선택합니다:

    • 구독 버튼 옆에 ()를 선택합니다.
    • 편집할 라벨 옆에 편집 ()을 선택합니다.
  4. 삭제를 선택합니다.

프로젝트 라벨을 그룹 라벨로 승격

같은 그룹 내 다른 프로젝트에서 프로젝트 라벨을 사용할 수 있게 하려면 라벨을 그룹 라벨로 승격할 수 있습니다.

같은 제목을 가진 그룹 라벨이 있는 경우 해당 그룹 라벨과 Merge됩니다. 같은 제목을 가진 다른 프로젝트에서 기존의 라벨도 Merge됩니다.

caution
라벨 승격은 영구적인 작업으로 되돌릴 수 없습니다.

전제 조건:

  • 프로젝트에 대해 적어도 리포터 역할을 가져야 합니다.
  • 프로젝트의 상위 그룹에 대해 적어도 리포터 역할을 가져야 합니다.

프로젝트 라벨을 그룹 라벨로 승격하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하여 프로젝트를 찾습니다.
  2. 관리 > 라벨을 선택합니다.
  3. 구독 버튼 옆에 있는 세 개의 점()을 선택하고 그룹 라벨로 승격을 선택합니다.

이전 라벨과 관련된 모든 이슈, Merge Request, 이슈 보드 디렉터리, 이슈 보드 필터 및 라벨 구독은 새 그룹 라벨에 할당됩니다.

새 그룹 라벨은 이전 프로젝트 라벨과 동일한 ID를 가집니다.

하위 그룹 라벨을 상위 그룹으로 승격

직접적으로 하위 그룹 라벨을 상위 그룹으로 승격하는 것은 불가능합니다. 이를 위해 다음 해결책을 사용하세요.

전제 조건:

  • 하위 그룹을 포함하는 그룹이 있어야 합니다(“상위 그룹”).
  • 승격하려는 라벨을 가진 상위 그룹의 하위 그룹이 있어야 합니다.
  • 두 그룹에 대해 적어도 리포터 역할을 가져야 합니다.

라벨을 상위 그룹으로 “승격”하려면:

  1. 상위 그룹에서 원본과 동일한 이름의 라벨을 생성합니다. 이 과정에서 두 라벨이 서로 헷갈리지 않도록 색상을 다르게 설정하는 것을 권장합니다.

  2. 하위 그룹에서 라벨 보기를 합니다. 두 라벨이 어디에서 왔는지 확인할 수 있습니다:

    하위 그룹의 라벨 디렉터리에 있는 상위 그룹과 하위 그룹 라벨

  3. 하위 그룹 라벨(원래의 라벨) 옆에 이슈, Merge Request 또는 에픽을 선택합니다.
  4. 원래의 라벨을 가진 이슈, Merge Request 및 에픽에 새 라벨을 추가합니다. 빠르게 진행하려면 일괄 편집을 사용하세요.
  5. 하위 그룹 또는 상위 그룹에서 라벨을 삭제합니다.

이제 상위 그룹에는 이전과 동일한 이름의 라벨이 있고 이전과 동일한 이슈, Merge Request 및 에픽에 추가되어 있어야 합니다.

기본 프로젝트 라벨 생성

프로젝트 또는 해당 상위 그룹에 라벨이 없는 경우, 프로젝트 라벨의 기본 세트를 생성할 수 있습니다.

전제 조건:

  • 프로젝트에 대해 적어도 리포터 역할을 가져야 합니다.
  • 해당 프로젝트에는 어떠한 라벨도 없어야 합니다.

기본 라벨을 프로젝트에 추가하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하여 프로젝트를 찾습니다.
  2. 관리 > 라벨을 선택합니다.
  3. 기본 라벨 세트 생성을 선택합니다.

다음과 같은 라벨이 생성됩니다:

  • bug
  • confirmed
  • critical
  • discussion
  • documentation
  • enhancement
  • suggestion
  • support

범위 지정된 라벨

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

팀은 상호 배타적인 라벨로 이슈, Merge Request 및 에픽을 주석 처리하기 위해 범위 지정된 라벨을 사용할 수 있습니다. 특정 라벨이 함께 사용되지 못하도록하여 더 복잡한 워크플로우를 생성할 수 있습니다.

범위 지정된 라벨

범위 지정된 라벨은 제목에 이중 콜론(::) 구문을 사용합니다. 예를 들어: workflow::in-review.

이중 콜론(::) 구문으로 작성된 동일한 키를 가진 이슈, Merge Request 또는 에픽은 둘을 가질 수 없습니다. 다른 값을 가진 동일한 키의 새 라벨을 추가하면 이전 키 라벨은 새 라벨로 대체됩니다.

비디오 시청: 조직을 GitLab과 함께 설정하는 범위 지정된 라벨.

스코프가 지정된 라벨로 필터링

특정 범위로 문제, Merge Request 또는 epic 디렉터리을 필터링하려면 검색된 라벨 이름에 <scope>::*를 입력하십시오.

예를 들어 platform::* 라벨로 필터링하면 platform::iOS, platform::Android, 또는 platform::Linux 라벨을 가진 문제가 반환됩니다.

note
스코프가 지정된 라벨로 필터링은 문제 또는 Merge Request 대시보드 페이지에서 사용할 수 없습니다.

스코프가 지정된 라벨 예시

예시 1. 문제 우선 순위 업데이트:

  1. 문제의 우선 순위가 낮다고 결정하고 priority::low 라벨을 할당합니다.
  2. 더 많은 검토 후, 문제의 우선 순위가 높아진 것을 깨닫고 priority::high 라벨을 할당합니다.
  3. 문제가 동시에 두 가지의 우선 순위 라벨을 가질 수 없으므로, GitLab은 priority::low 라벨을 제거합니다.

예시 2. 기능이 타겟팅하는 운영 체제 플랫폼을 추적하기 위해 문제에 사용자 정의 필드를 원하는 경우, 각 문제는 단 하나의 플랫폼을 타겟팅해야 합니다.

다음과 같이 세 가지 라벨을 만듭니다:

  • platform::iOS
  • platform::Android
  • platform::Linux

이러한 라벨 중 하나를 문제에 할당하면 자동으로 platform::으로 시작하는 기존 라벨을 제거합니다.

예시 3. 스코프가 지정된 라벨을 사용하여 팀의 워크플로 상태를 표현할 수 있습니다.

다음과 같은 라벨이 있는 경우:

  • workflow::development
  • workflow::review
  • workflow::deployed

문제가 이미 workflow::development 라벨을 가지고 있고 개발자가 문제가 이제 검토 중임을 표시하고 싶어하는 경우, workflow::review를 할당하면 workflow::development 라벨이 제거됩니다.

이는 이슈 보드에서 라벨 디렉터리을 이동할 때도 동일합니다. 스코프가 지정된 라벨을 사용하면 이슈 보드에서 작업하지 않는 팀 멤버도 이슈 자체에서 일관되게 워크플로 상태를 진행할 수 있습니다.

비디오 설명은 다음을 참조하십시오:

비디오 보기: 사용자 정의 필드 및 사용자 정의 워크플로에 스코프가 지정된 라벨 사용.

중첩된 스코프

여러 개의 이중 콜론 ::을 사용하여 라벨에 중첩된 스코프를 가진 라벨을 만들 수 있습니다. 이 경우, 마지막 :: 이전의 모든 것이 스코프가 됩니다.

예를 들어, 프로젝트에 다음과 같은 라벨이 있는 경우:

  • workflow::backend::review
  • workflow::backend::development
  • workflow::frontend::review

문제는 동시에 workflow::backend::review 및 workflow::backend::development 라벨을 가질 수 없습니다. 이는 둘 다 workflow::backend를 공유하기 때문입니다.

반면에, 문제는 workflow::backend::review 및 workflow::frontend::review 라벨을 동시에 가질 수 있습니다. 이는 둘 다 다른 스코프 workflow::frontend 및 workflow::backend를 가지고 있기 때문입니다.

라벨 사용 시 알림 받기

라벨을 구독하여 라벨이 이슈, Merge Request 또는 epic에 할당될 때 알림을 받을 수 있습니다.

라벨 구독 방법:

  1. 라벨 디렉터리 페이지를 봅니다.
  2. 라벨 오른쪽에서 구독을 선택합니다.
  3. 선택 사항. 프로젝트에서 그룹 라벨을 구독하는 경우 다음 중 하나를 선택하십시오:
    • 이 프로젝트에서 이벤트에 대해 알림을 받도록 프로젝트 수준에서 구독을 선택합니다.
    • 전체 그룹에서 이벤트에 대해 알림을 받도록 그룹 수준에서 구독을 선택합니다.

라벨 우선 순위 설정

라벨에는 상대적 우선순위가 있을 수 있습니다. 이는 이슈 및 Merge Request 디렉터리을 라벨 우선 순위로 정렬하고 우선 순위로 정렬할 때 사용됩니다.

라벨을 우선 순위로 설정하려면 프로젝트에서 수행해야 합니다. 그룹 라벨 디렉터리에서는 불가능합니다.

note
우선 순위 정렬은 가장 높은 우선 순위 라벨을 기준으로 합니다. 이 토론에서 이를 변경하는 것을 고려하고 있습니다.

전제 조건:

  • 프로젝트에 대해 적어도 기고자 역할이 있어야 합니다.

라벨을 우선 순위로 설정하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 관리 > 라벨을 선택합니다.
  3. 우선 순위를 설정하려는 라벨 옆에 별표()를 선택합니다.

라벨 우선 순위 지정

이제 이 라벨은 우선순위 Labels 아래 라벨 디렉터리 상단에 표시됩니다.

이 라벨의 상대적 우선 순위를 변경하려면 디렉터리에서 끌어 올리거나 내립니다. 디렉터리 상단에 있는 라벨일수록 더 높은 우선 순위를 갖습니다.

우선 순위 또는 라벨 우선 순위로 정렬했을 때의 결과는 이슈 디렉터리 정렬과 순서를 참조하십시오.

Merge Request이 Merge될 때 라벨 잠금

Tier: Free, Premium, Ultimate Offering: GitLab.com Status: Beta
  • GitLab 16.3에서 enforce_locked_labels_on_merge라는 플래그와 함께 도입되었습니다. 이 기능은 베타 상태입니다.

플래그: Self-managed GitLab 및 GitLab Dedicated에서는 이 기능을 사용할 수 없습니다. GitLab.com에서는 이 기능을 사용할 수 있지만 GitLab.com 관리자만 구성할 수 있습니다. 그룹 또는 프로젝트 단위로 사용하려면 관리자가 enforce_locked_labels_on_merge라는 피처 플래그를 활성화할 수 있습니다.

특정 감사 요구 사항을 준수하기 위해 라벨을 잠금 설정할 수 있습니다. 잠금된 라벨이 있는 Merge Request이 Merge되면 누구도 해당 라벨을 삭제할 수 없습니다.

잠겨진 라벨을 문제 또는 epic에 추가하면 일반적인 라벨처럼 작동합니다.

전제 조건:

  • 프로젝트 또는 그룹에 대해 적어도 기고자 역할이 있어야 합니다.
caution
라벨을 잠그 려면 그것을 누구도 취소할 수 없거나 라벨을 삭제할 수 없습니다.

라벨을 Merge 시에 잠그려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹 또는 프로젝트를 찾습니다.
  2. 관리 > 라벨을 선택합니다.
  3. 편집하려는 라벨 옆에 수직 열거호()를 선택하고 편집을 선택합니다.
  4. Merge Request이 Merge된 후 라벨 잠금 확인란을 선택합니다.
  5. 변경 사항을 저장합니다을 선택합니다.

관련 주제

다음 튜토리얼에서 레이블을 사용하는 연습을 해보세요:

문제 해결

일부 레이블 제목이 _duplicate<number>로 끝납니다

특정 상황에서는 동일한 네임스페이스에 중복된 제목의 레이블을 생성하는 것이 가능했습니다.

중복을 해결하기 위해, GitLab 13.2부터 몇 가지 중복된 레이블의 제목 뒤에 _duplicate<number>가 추가되었습니다.

원하신다면, 이러한 레이블의 제목을 안전하게 변경할 수 있습니다. 원본 문제의 자세한 내용은 이슈 30390을 참조하세요.