레이블

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

레이블은 GitLab에서 이슈, 병합 요청 및 에픽을 분류하고 필터링하는 방법입니다.

GitLab에서 프로젝트가 커지면 완료된 작업을 추적하는 것이 점점 더 어려워집니다. 특히 몇 명에서 수백 명 또는 수천 명까지 조직이 성장할 때 더 그렇습니다. 레이블을 사용하면 작업을 구성하고 태그를 붙이며 원하는 작업 항목을 추적할 수 있습니다.

레이블은 이슈 보드의 중요한 부분입니다.

에픽, 이슈 및 병합 요청에 레이블을 사용하여 다음을 수행할 수 있습니다:

  • bug, feature request, 또는 docs와 같은 색 및 기술적인 제목을 사용하여 항목을 분류합니다.
  • 진행 중이거나 완료된 작업을 보는 데 동적으로 필터링하고 관리합니다.
  • 목록 및 보드를 검색합니다.
  • scoped labels을 사용하여 항목의 우선 순위 또는 심각성을 전달합니다.

레이블의 종류

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

  • 프로젝트 레이블은 해당 프로젝트의 이슈 및 병합 요청에만 할당할 수 있습니다.
  • 그룹 레이블은 선택한 그룹 또는 해당 하위 그룹의 모든 프로젝트의 이슈, 병합 요청 및 에픽에 할당할 수 있습니다.

레이블 할당 및 취소

  • 기본적으로 비활성화된 feature flag realtime_labels를 사용하여 GitLab 14.10에서 사이드바의 실시간 업데이트가 도입되었습니다.
  • GitLab 15.1에서 GitLab.com에서 사이드바의 실시간 업데이트가 활성화되었습니다.
  • GitLab 15.5에서 사이드바의 실시간 업데이트가 기본적으로 활성화되었습니다.
  • GitLab 15.6에서 사이드바의 실시간 업데이트가 일반적으로 사용 가능하게 되었습니다. realtime_labels 기능 플래그가 제거되었습니다.

레이블은 이슈, 병합 요청 또는 에픽에 할당할 수 있습니다.

변경된 레이블은 다음에서 다른 사용자에게 즉시 표시됩니다 (페이지 새로 고침 없이):

  • 에픽
  • 인시던트
  • 이슈
  • 병합 요청

레이블을 할당하거나 취소하려면 다음을 수행하세요:

  1. 사이드바의 Labels 섹션에서 Edit를 선택합니다.
  2. Labels 목록에서 레이블을 이름으로 검색합니다. 레이블을 계속해서 추가하려면 여러 번 검색할 수 있습니다. 선택한 레이블에는 확인 표시가 붙습니다.
  3. 할당하거나 취소할 레이블을 선택합니다.
  4. 레이블 변경 사항을 적용하려면 Assign labels 옆의 X를 선택하거나 레이블 섹션 외의 영역을 선택합니다.

대안으로 레이블을 취소하려면 원하는 레이블 옆의 X를 선택합니다.

또한 빠른 작업으로 레이블을 할당하거나 취소할 수 있습니다:

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

사용 가능한 레이블 보기

프로젝트 레이블 보기

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

  1. 왼쪽 사이드바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
  2. Manage > Labels를 선택합니다.

또는:

  1. 이슈 또는 병합 요청을 보고하는 있습니다.
  2. 오른쪽 사이드바의 Labels 섹션에서 Edit를 선택합니다.
  3. Manage project labels를 선택합니다.

레이블 목록에는 프로젝트에서 생성된 레이블과 프로젝트의 상위 그룹에서 생성된 모든 레이블이 포함됩니다. 각 레이블에는 생성된 프로젝트 또는 그룹 경로가 표시됩니다.

그룹 레이블 보기

그룹의 레이블을 보려면:

  1. 왼쪽 사이드바에서 Search or go to를 선택하고 그룹을 찾습니다.
  2. Manage > Labels를 선택합니다.

또는:

  1. 에픽을 보고 있습니다.
  2. 오른쪽 사이드바의 Labels 섹션에서 Edit를 선택합니다.
  3. Manage group labels를 선택합니다.

목록에는 그룹에서만 생성된 모든 레이블이 포함됩니다. 그룹의 프로젝트에서 생성된 레이블은 목록에 표시되지 않습니다.

레이블 생성

전제 조건:

  • 프로젝트 또는 그룹에 적어도 기고자 역할을 할당받아야 합니다.

프로젝트 레이블 생성

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

  1. 왼쪽 사이드바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
  2. Manage > Labels를 선택합니다.
  3. New label을 선택합니다.
  4. Title 필드에 레이블의 간결하고 설명적인 이름을 입력합니다. 이때 이 필드를 사용하여 scoped, mutually exclusive labels을 만들 수도 있습니다.
  5. 필요한 경우 Description 필드에 레이블 사용 방법 및 시기에 대한 추가 정보를 입력합니다.
  6. 선택 사항. 사용 가능한 색 중에서 선택하거나 특정 색상을 위해 16진수 색상 값을 입력하여 색상을 선택합니다.
  7. Create label을 선택합니다.

이슈나 병합 요청에서 프로젝트 레이블 생성

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

전제 조건:

  • 해당 프로젝트에 적어도 기고자 역할을 할당받아야 합니다.

진행 방법:

  1. 이슈나 병합 요청을 보고 있습니다.
  2. 오른쪽 사이드바의 Labels 섹션에서 Edit를 선택합니다.
  3. Create project label을 선택합니다.
  4. 이름 필드에 정보를 입력합니다. 이 방법으로 레이블을 만드는 경우 설명을 지정할 수 없습니다. 나중에 레이블을 편집하여 설명을 추가할 수 있습니다.
  5. 사용 가능한 색 중에서 선택하거나 특정 색상을 위해 16진수 색상 값을 입력합니다.
  6. Create를 선택합니다. 레이블이 생성되고 선택됩니다.

그룹 레이블 생성

그룹 레이블을 생성하려면:

  1. 왼쪽 사이드바에서 Search or go to를 선택하고 그룹을 찾습니다.
  2. Manage > Labels를 선택합니다.
  3. New label을 선택합니다.
  4. Title 필드에 레이블의 간결하고 설명적인 이름을 입력합니다. 이때 이 필드를 사용하여 scoped, mutually exclusive labels을 만들 수도 있습니다.
  5. 필요한 경우 Description 필드에 레이블 사용 방법 및 시기에 대한 추가 정보를 입력합니다.
  6. 선택 사항. 사용 가능한 색 중에서 선택하거나 특정 색상을 위해 16진수 색상 값을 입력하여 색상을 선택합니다.
  7. Create label을 선택합니다.

에픽에서 그룹 레이블 만들기

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

에픽에서도 새로운 그룹 레이블을 만들 수 있습니다.
이 방법으로 만드는 레이블은 해당 에픽이 속한 그룹에 속합니다.

필수 조건:

  • 그룹에 대해 적어도 Reporter 역할이 있어야 합니다.

다음 단계를 따르세요:

  1. 에픽을 보기.
  2. 오른쪽 사이드바에서 Labels 섹션에서 Edit을 선택합니다.
  3. Create group label을 선택합니다.
  4. 이름 필드에 채웁니다. 이 방법으로 레이블을 만들 때는 설명을 지정할 수 없습니다. 레이블을 편집하여 나중에 설명을 추가할 수 있습니다.
  5. 사용 가능한 색상에서 선택하여 색상을 선택하거나 특정 색상을 위해 16진수 색상 값을 입력합니다.
  6. Create을 선택합니다.

레이블 편집

필수 조건:

  • 프로젝트 또는 그룹에 대해 적어도 Reporter 역할이 있어야 합니다.

프로젝트 레이블 편집

프로젝트 레이블을 편집하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. Manage > Labels을 선택합니다.
  3. 편집하려는 레이블 옆에 있는 수직 엘리미네이터 ()를 선택하고 Edit을 선택합니다.
  4. Save changes을 선택합니다.

그룹 레이블 편집

그룹 레이블을 편집하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
  2. Manage > Labels를 선택합니다.
  3. 편집하려는 레이블 옆에 있는 수직 엘리미네이터 ()를 선택하고 Edit을 선택합니다.
  4. Save changes을 선택합니다.

레이블 삭제

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

필수 조건:

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

프로젝트 레이블 삭제

프로젝트 레이블을 삭제하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. Manage > Labels를 선택합니다.
  3. Subscribe 버튼 옆에 있는 ()을 선택하고 Delete을 선택합니다.

그룹 레이블 삭제

그룹 레이블을 삭제하려면:

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

  3. 다음 중 하나를 선택합니다:

    • Subscribe 버튼 옆에 있는 ()을 선택합니다.
    • 편집하려는 레이블 옆에 Edit을 () 선택합니다.
  4. Delete을 선택합니다.

프로젝트 레이블을 그룹 레이블로 승격

동일 그룹의 다른 프로젝트에서 사용 가능하도록 프로젝트 레이블을 그룹 레이블로 승격할 수 있습니다. 이후로는 해당 레이블을 그룹 레이블로 사용할 수 있습니다.

동일한 제목을 가진 다른 그룹 레이블이 있는 경우 이전의 프로젝트 레이블이 새 그룹 레이블과 병합됩니다. 동일한 제목의 그룹 레이블이 이미 존재하는 경우에도 병합됩니다.

경고: 레이블을 승격하는 것은 영구적인 조치이며 취소할 수 없습니다.

필수 조건:

  • 프로젝트에 대해 적어도 Reporter 역할이 있어야 합니다.
  • 프로젝트의 상위 그룹에 대해 적어도 Reporter 역할이 있어야 합니다.

프로젝트 레이블을 그룹 레이블로 승격하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. Manage > Labels를 선택합니다.
  3. Subscribe 버튼 옆에 있는 세 개의 점 ()을 선택하고 Promote to group label을 선택합니다.

이전 레이블과 관련된 모든 이슈, 병합 요청, 이슈 보드 목록 및 이슈 보드 필터, 그리고 레이블 구독은 새 그룹 레이블에 할당됩니다.

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

하위 그룹 레이블을 상위 그룹으로 승격

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

필수 조건:

  • 하위 그룹을 포함하는 그룹(“상위 그룹”)이 있어야 합니다.
  • 상위 그룹에 하위 그룹에 승격하려는 레이블이 있는 서브그룹이 있어야 합니다.
  • 양쪽 그룹에 대해 적어도 Reporter 역할이 있어야 합니다.

상위 그룹으로 레이블을 “승격”하려면:

  1. 상위 그룹에서 원래와 동일한 이름으로 레이블을 만듭니다. 이 작업하는 동안에 두 레이블이 서로 혼동되지 않도록 다른 색상으로 만드는 것을 권장합니다.

  2. 서브그룹에서 레이블을 보세요. 두 레이블과 그들의 출처를 볼 수 있어야 합니다:

    서브그룹의 레이블 목록에서 상위 그룹 및 서브그룹 레이블

  3. 서브그룹 레이블(이전 레이블) 옆에서 Issues, Merge requests, 또는 Epics를 선택합니다.
  4. 이전 레이블을 사용하는 이슈, 병합 요청 및 에픽에 새 레이블을 추가하세요. 빠르게 하려면 일괄 편집을 사용하세요.
  5. 서브그룹 또는 상위 그룹에서 그룹 레이블을 삭제하면 됩니다. 이는 하위 수준 그룹에 속하는 레이블입니다.

이제 이전과 같은 이름을 가진 레이블과 동일한 이슈, MR, 그리고 에픽을 상위 그룹에 가지고 있게 될 것입니다.

기본 프로젝트 레이블 생성

프로젝트 또는 상위 그룹에 레이블이 없는 경우, 레이블 목록에서 기본 프로젝트 레이블을 생성할 수 있습니다.

필수 조건:

  • 프로젝트에 대해 적어도 Reporter 역할이 있어야 합니다.
  • 프로젝트에 레이블이 없어야 합니다.

프로젝트에 기본 레이블을 추가하려면:

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

다음 레이블이 생성됩니다:

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

범위 지정된 레이블

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

팀은 상호 배타적인 레이블로 이슈, 병합 요청 및 에픽에 주석을 달기 위해 범위 지정된 레이블을 사용할 수 있습니다. 특정 레이블을 함께 사용하지 못하도록 함으로써 더 복잡한 워크플로우를 생성할 수 있습니다.

범위 지정된 레이블

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

이중 콜론으로 형식화된 레이블에 대해 동일한 key를 가진 다른 value의 key::value 레이블이 없습니다. 새 레이블에 동일한 key로 다른 value를 추가하면 이전 key 레이블이 새 레이블로 교체됩니다.

스코프 지정된 레이블로 필터링

주어진 범위로 이슈, 병합 요청 또는 에픽 목록을 필터링하려면 검색된 레이블 이름에 <scope>::*를 입력하십시오.

예를 들어, platform::* 레이블로 필터링하면 platform::iOS, platform::Android, 또는 platform::Linux 레이블을 가진 이슈가 반환됩니다.

참고: 스코프 지정된 레이블로 필터링은 이슈나 병합 요청 대시보드 페이지에서 사용할 수 없습니다.

스코프 지정된 레이블 예제

예제 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::development 레이블은 제거되고 workflow::review가 할당됩니다.

레이블 목록에서 이슈를 이동하는 경우에도 똑같은 일이 발생합니다. 스코프 지정된 레이블을 사용하면 이슈 보드에서 작업 중이 아닌 팀원들도 이슈 자체에서 일관되게 워크플로 상태를 진행시킬 수 있습니다.

비디오 설명을 보려면 다음을 참조하세요:

비디오 보기: 사용자 정의 필드 및 사용자 정의 워크플로에 대한 스코프 지정된 레이블 사용.

중첩된 범위

여러 개의 이중 콜론 ::을 사용하여 중첩된 범위의 레이블을 생성할 수 있습니다. 이 경우 마지막 :: 이전의 모든 것이 범위가 됩니다.

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

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

이슈가 동시에 workflow::backend::review 및 workflow::backend::development 레이블을 가질 수 없으며, 이는 두 레이블이 동일한 범위를 공유하기 때문입니다. 반대로, workflow::frontend와 workflow::backend의 다른 범위를 가지므로 두 레이블을 동시에 가질 수 있습니다.

레이블 사용 시 알림 수신

이슈, 병합 요청 또는 에픽에 레이블이 할당될 때 알림을 받기 위해 해당 레이블을 구독할 수 있습니다.

레이블을 구독하려면:

  1. 레이블 목록 페이지를 확인합니다.
  2. 원하는 레이블 오른쪽에 구독을 선택합니다.
  3. 선택 사항. 프로젝트에서 그룹 레이블을 구독하는 경우 다음 중 하나를 선택합니다:
    • 이 프로젝트의 이벤트에 대해 알림을 받으려면 프로젝트 수준에서 구독을 선택합니다.
    • 전체 그룹의 이벤트에 대해 알림을 받으려면 그룹 수준에서 구독을 선택합니다.

레이블 우선순위 설정

레이블에는 이슈 및 병합 요청 목록을 레이블 우선순위에 따라 정렬할 때 사용되는 상대적인 우선순위가 있습니다.

레이블 우선순위를 설정하려면 프로젝트에서 수행해야 합니다. 그룹 레이블 목록에서 설정할 수 있는 것은 아닙니다.

참고: 우선순위 정렬은 가장 높은 우선순위 레이블에 의해 결정됩니다. 이 토론에서 이를 변경하는 것이 고려됩니다.

전제 조건:

  • 해당 프로젝트에 적어도 보고자 권한이 있어야 합니다.

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

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

우선순위 지정된 레이블

해당 레이블은 이제 우선순위 지정된 레이블 아래의 레이블 목록 상단에 표시됩니다.

이 레이블의 상대적인 우선순위를 변경하려면 해당 레이블을 목록에서 위아래로 드래그하면 됩니다. 목록 상단에 있는 레이블일수록 높은 우선순위를 가집니다.

우선순위 또는 레이블 우선순위에 따라 정렬 시 일어나는 일에 대해 더 알아보려면 이슈 목록 정렬을 참조하세요.

병합 요청이 병합될 때 레이블 잠그기

Tier: Free, Premium, Ultimate Offering: Self-Managed Status: Beta
  • 이슈에서 enforce_locked_labels_on_merge라는 플래그로 GitLab 16.3에서 도입되었습니다. 이 기능은 베타로, 기본값으로 비활성화되어 있습니다.

플래그: 이 기능의 이용 가능성은 플래그로 제어됩니다. 자세한 정보는 히스토리를 참조하세요. 이 기능은 테스트용으로 제공되지만 실제 운영에는 준비되지 않았습니다.

특정 감사 요건을 준수하기 위해 레이블을 잠근 상태로 설정할 수 있습니다. 잠긴 레이블이 포함된 병합 요청이 병합되면 해당 레이블을 더 이상 해제할 수 없습니다.

이슈나 에픽에 잠긴 레이블을 추가하는 경우 이는 일반 레이블과 마찬가지로 작동합니다.

전제 조건:

  • 해당 프로젝트 또는 그룹에 적어도 보고자 권한이 있어야 합니다.

경고: 한 번 레이블을 잠그면 더 이상 취소하거나 레이블을 삭제할 수 없습니다.

레이블을 병합 시 잠금 상태로 설정하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하여 그룹 또는 프로젝트를 찾습니다.
  2. 관리 > 레이블을 선택합니다.
  3. 편집하려는 레이블 옆의 수직 엘리먼트()를 선택한 후 편집을 선택합니다.
  4. 병합 요청이 병합될 때 레이블 잠금 확인란을 선택합니다.
  5. 변경 사항 저장을 선택합니다.

관련 주제

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