InfoGrab Docs

레이블

요약

레이블은 GitLab 기능 전반에서 작업을 구성하고 추적합니다. GitLab에서 세 가지 유형의 레이블을 사용합니다: 이슈, 머지 요청 또는 에픽에 레이블을 할당할 수 있습니다. 변경된 레이블은 다음에서 페이지를 새로 고치지 않고 다른 사용자에게 즉시 표시됩니다:

레이블은 GitLab 기능 전반에서 작업을 구성하고 추적합니다. 프로젝트가 소규모 팀에서 대규모 조직으로 성장함에 따라 레이블은 증가하는 양의 작업을 추적하고 관리하는 데 도움이 됩니다. 레이블:

  • 이슈, 머지 요청 및 에픽을 사용자 정의 속성으로 분류합니다.
  • 목록과 보드에서 콘텐츠를 필터링합니다.
  • 색상과 설명적인 제목으로 작업 항목의 우선순위를 지정합니다.
  • 범위가 지정된 레이블로 우선순위와 심각도를 추적합니다.
  • 구성된 그룹화를 통해 워크플로우를 구조화합니다.

레이블 유형#

GitLab에서 세 가지 유형의 레이블을 사용합니다:

  • 프로젝트 레이블은 해당 프로젝트의 이슈 및 머지 요청에만 할당할 수 있습니다.
  • 그룹 레이블은 선택한 그룹이나 하위 그룹의 모든 프로젝트에서 이슈, 머지 요청 및 에픽에 할당할 수 있습니다.
  • 인스턴스 레이블은 인스턴스 관리자가 생성하며 모든 새 프로젝트에 복사됩니다.

레이블 할당 및 해제#

히스토리
  • GitLab 14.10에서 realtime_labels 기능 플래그가 있는 상태로 사이드바의 실시간 업데이트가 도입되었습니다. 기본적으로 비활성화됩니다.
  • GitLab 15.1에서 GitLab.com에서 활성화된 사이드바의 실시간 업데이트.
  • GitLab 15.5에서 기본적으로 활성화된 사이드바의 실시간 업데이트.
  • GitLab 15.6에서 일반 사용 가능한 사이드바의 실시간 업데이트. 기능 플래그 realtime_labels 제거됨.

이슈, 머지 요청 또는 에픽에 레이블을 할당할 수 있습니다.

변경된 레이블은 다음에서 페이지를 새로 고치지 않고 다른 사용자에게 즉시 표시됩니다:

  • 에픽
  • 인시던트
  • 이슈
  • 머지 요청

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

  1. 사이드바의 레이블 섹션에서 편집을 선택합니다.
  2. 레이블 할당 목록에서 이름을 입력하여 레이블을 검색합니다. 반복 검색하여 더 많은 레이블을 추가할 수 있습니다. 선택된 레이블은 체크 표시로 표시됩니다.
  3. 할당하거나 해제할 레이블을 선택합니다.
  4. 레이블 변경 사항을 적용하려면 레이블 할당 옆의 X를 선택하거나 레이블 섹션 외부의 아무 영역이나 선택합니다.

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

빠른 작업으로 레이블을 할당하거나 해제할 수도 있습니다:

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

사용 가능한 레이블 보기#

프로젝트 레이블 보기#

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

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

또는:

  1. 이슈 또는 머지 요청을 봅니다.
  2. 오른쪽 사이드바의 레이블 섹션에서 편집을 선택합니다.
  3. 프로젝트 레이블 관리를 선택합니다.

레이블 목록에는 프로젝트에서 만든 레이블과 프로젝트의 상위 그룹에서 만든 모든 레이블이 포함됩니다. 각 레이블에 대해 레이블이 만들어진 프로젝트 또는 그룹 경로를 볼 수 있습니다.

그룹 레이블 보기#

그룹의 레이블을 보려면:

  1. 상단 바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
  2. 왼쪽 사이드바에서 관리 > 레이블을 선택합니다.

또는:

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

목록에는 그룹에서만 만든 레이블이 포함됩니다. 그룹의 프로젝트에서 만든 레이블은 나열되지 않습니다.

레이블 만들기#

히스토리
  • GitLab 17.7에서 레이블을 만들기 위한 최소 역할이 Reporter에서 Planner로 변경되었습니다.

사전 요구 사항:

  • 프로젝트 또는 그룹에 대한 Planner, Reporter, Developer, Maintainer 또는 Owner 역할이 있어야 합니다.

프로젝트 레이블 만들기#

프로젝트 레이블을 만들려면:

  1. 상단 바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 관리 > 레이블을 선택합니다.
  3. 새 레이블을 선택합니다.
  4. 제목 필드에 레이블의 짧고 설명적인 이름을 입력합니다. 이 필드를 사용하여 범위가 지정된 상호 배타적 레이블을 만들 수도 있습니다.
  5. 선택 사항. 설명 필드에 이 레이블을 사용하는 방법과 시기에 대한 추가 정보를 입력합니다.
  6. 선택 사항. 사용 가능한 색상 중에서 선택하거나 배경 색상 필드에 특정 색상의 16진수 색상 값을 입력하여 색상을 선택합니다.
  7. 레이블 만들기를 선택합니다.

이슈 또는 머지 요청에서 프로젝트 레이블 만들기#

히스토리
  • GitLab 17.7에서 레이블을 만들기 위한 최소 역할이 Reporter에서 Planner로 변경되었습니다.

이슈나 머지 요청에서 새 프로젝트 레이블을 만들 수도 있습니다. 이런 방식으로 만든 레이블은 이슈나 머지 요청과 동일한 프로젝트에 속합니다.

사전 요구 사항:

  • 프로젝트에 대한 Planner, Reporter, Developer, Maintainer 또는 Owner 역할이 있어야 합니다.

이를 위해:

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

그룹 레이블 만들기#

그룹 레이블을 만들려면:

  1. 상단 바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
  2. 왼쪽 사이드바에서 관리 > 레이블을 선택합니다.
  3. 새 레이블을 선택합니다.
  4. 제목 필드에 레이블의 짧고 설명적인 이름을 입력합니다. 이 필드를 사용하여 범위가 지정된 상호 배타적 레이블을 만들 수도 있습니다.
  5. 선택 사항. 설명 필드에 이 레이블을 사용하는 방법과 시기에 대한 추가 정보를 입력합니다.
  6. 선택 사항. 사용 가능한 색상 중에서 선택하거나 배경 색상 필드에 특정 색상의 16진수 색상 값을 입력하여 색상을 선택합니다.
  7. 레이블 만들기를 선택합니다.

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

히스토리
  • GitLab 17.7에서 그룹 레이블을 만들기 위한 최소 역할이 Reporter에서 Planner로 변경되었습니다.

에픽에서 새 그룹 레이블을 만들 수도 있습니다. 이런 방식으로 만든 레이블은 에픽과 동일한 그룹에 속합니다.

사전 요구 사항:

  • 그룹에 대한 Planner, Reporter, Developer, Maintainer 또는 Owner 역할이 있어야 합니다.

이를 위해:

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

레이블 편집#

히스토리
  • GitLab 17.7에서 레이블을 편집하기 위한 최소 역할이 Reporter에서 Planner로 변경되었습니다.

사전 요구 사항:

  • 프로젝트 또는 그룹에 대한 Planner, Reporter, Developer, Maintainer 또는 Owner 역할이 있어야 합니다.

프로젝트 레이블 편집#

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

  1. 상단 바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 관리 > 레이블을 선택합니다.
  3. 편집할 레이블 옆에서 세로 줄임표 (⋮)를 선택한 다음 편집을 선택합니다.
  4. 변경 사항 저장을 선택합니다.

그룹 레이블 편집#

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

  1. 상단 바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
  2. 왼쪽 사이드바에서 관리 > 레이블을 선택합니다.
  3. 편집할 레이블 옆에서 세로 줄임표 (⋮)를 선택한 다음 편집을 선택합니다.
  4. 변경 사항 저장을 선택합니다.

레이블 삭제#

히스토리
  • GitLab 17.7에서 레이블을 삭제하기 위한 최소 역할이 Reporter에서 Planner로 변경되었습니다.
Warning

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

사전 요구 사항:

  • 프로젝트에 대한 Planner, Reporter, Developer, Maintainer 또는 Owner 역할이 있어야 합니다.

프로젝트 레이블 삭제#

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

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

그룹 레이블 삭제#

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

  1. 상단 바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.

  2. 왼쪽 사이드바에서 관리 > 레이블을 선택합니다.

  3. 다음 중 하나:

    • 구독 버튼 옆에서 (⋮)을 선택합니다.
    • 편집할 레이블 옆에서 편집 (✏️)을 선택합니다.
  4. 삭제를 선택합니다.

보관된 레이블#

히스토리
  • GitLab 18.3에서 labels_archive 플래그가 있는 상태로 도입되었습니다. 기본적으로 비활성화됩니다.
  • GitLab 18.7에서 그룹에 대해 켜고 끌 수 있도록 플래그 labels_archive변경되었습니다.
  • GitLab 18.11에서 일반 사용 가능. 기능 플래그 labels_archive 제거.

더 이상 적극적으로 사용되지 않지만 과거 기록과 검색 목적으로 보존해야 하는 레이블을 보관할 수 있습니다.

예를 들어, 릴리스가 완료된 후 Q4-25와 같은 릴리스 레이블을 보관하여 레이블 선택 드롭다운 목록에서는 제거하면서 검색에는 계속 사용할 수 있도록 할 수 있습니다.

레이블을 보관하면:

  • 레이블이 이슈, 머지 요청, 에픽의 레이블 선택 드롭다운 목록에서 숨겨집니다.
  • 레이블이 이전에 할당된 기존 이슈, 머지 요청 및 에픽에서는 계속 표시됩니다.
  • 여전히 레이블을 검색하고 기록 데이터를 볼 수 있습니다.
  • 레이블이 레이블 페이지의 별도 보관됨 탭에 표시됩니다.

레이블 보관#

사전 요구 사항:

  • 프로젝트 또는 그룹에 대한 Planner, Reporter, Developer, Maintainer 또는 Owner 역할이 있어야 합니다.

레이블을 보관하려면:

  1. 상단 바에서 검색 또는 이동을 선택하고 프로젝트 또는 그룹을 찾습니다.
  2. 왼쪽 사이드바에서 관리 > 레이블을 선택합니다.
  3. 보관할 레이블 옆에서 편집 (✏️)을 선택합니다.
  4. 보관됨 체크박스를 선택합니다.
  5. 변경 사항 저장을 선택합니다.

레이블이 보관되고 우선순위가 낮아집니다.

보관된 레이블 보기#

보관된 레이블을 보려면:

  1. 상단 바에서 검색 또는 이동을 선택하고 프로젝트 또는 그룹을 찾습니다.
  2. 왼쪽 사이드바에서 관리 > 레이블을 선택합니다.
  3. 프로젝트 또는 그룹의 레이블 페이지로 이동합니다.
  4. 보관됨 탭을 선택합니다.

레이블 보관 취소#

사전 요구 사항:

  • 프로젝트 또는 그룹에 대한 Planner, Reporter, Developer, Maintainer 또는 Owner 역할이 있어야 합니다.

레이블 보관을 취소하려면:

  1. 상단 바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 관리 > 레이블을 선택합니다.
  3. 보관됨 탭을 선택합니다.
  4. 보관을 취소할 레이블 옆에서 편집 (✏️)을 선택합니다.
  5. 보관됨 체크박스를 지웁니다.
  6. 변경 사항 저장을 선택합니다.

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

히스토리
  • GitLab 17.7에서 레이블을 승격하기 위한 최소 역할이 Reporter에서 Planner로 변경되었습니다.

동일한 그룹의 다른 프로젝트에서 프로젝트 레이블을 사용 가능하게 만들고 싶을 수 있습니다. 그러면 레이블을 그룹 레이블로 승격할 수 있습니다.

동일한 그룹의 다른 프로젝트에 동일한 제목의 레이블이 있는 경우 모두 새 그룹 레이블과 합쳐집니다. 동일한 제목의 그룹 레이블이 있는 경우에도 합쳐집니다.

Warning

레이블 승격은 영구적인 작업이며 취소할 수 없습니다.

사전 요구 사항:

  • 프로젝트에 대한 Planner, Reporter, Developer, Maintainer 또는 Owner 역할이 있어야 합니다.
  • 프로젝트의 상위 그룹에 대한 Planner, Reporter, Developer, Maintainer 또는 Owner 역할이 있어야 합니다.

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

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

이전 레이블이 있는 모든 이슈, 머지 요청, 이슈 보드 목록, 이슈 보드 필터 및 레이블 구독이 새 그룹 레이블에 할당됩니다.

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

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

히스토리
  • GitLab 17.7에서 레이블을 승격하기 위한 최소 역할이 Reporter에서 Planner로 변경되었습니다.

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

사전 요구 사항:

  • 하위 그룹을 포함하는 그룹("상위 그룹")이 있어야 합니다.
  • 상위 그룹에 승격하려는 레이블이 있는 하위 그룹이 있어야 합니다.
  • 두 그룹 모두에 대한 Planner, Reporter, Developer, Maintainer 또는 Owner 역할이 있어야 합니다.

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

  1. 상위 그룹에서 원래 레이블과 동일한 이름으로 레이블을 만듭니다. 이 두 레이블을 혼동하지 않도록 다른 색상으로 만드는 것이 좋습니다.

  2. 하위 그룹에서 레이블을 봅니다. 두 레이블과 출처를 볼 수 있어야 합니다:

    하위 그룹의 레이블 목록에서 상위 그룹과 하위 그룹 레이블

  3. 하위 그룹 레이블(이전 레이블) 옆에서 이슈, 머지 요청 또는 에픽을 선택합니다.

  4. 이전 레이블이 있는 이슈, 머지 요청 및 에픽에 새 레이블을 추가합니다. 더 빠르게 하려면 일괄 편집을 사용합니다.

  5. 하위 그룹이나 상위 그룹에서 하위 수준 그룹에 속하는 레이블을 삭제합니다.

이제 상위 그룹에 이전 레이블과 동일한 이름을 가진 레이블이 있으며, 동일한 이슈, MR 및 에픽에 추가됩니다.

기본 프로젝트 레이블 생성#

히스토리
  • GitLab 17.7에서 기본 레이블을 생성하기 위한 최소 역할이 Reporter에서 Planner로 변경되었습니다.

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

사전 요구 사항:

  • 프로젝트에 대한 Planner, Reporter, Developer, Maintainer 또는 Owner 역할이 있어야 합니다.
  • 프로젝트에 레이블이 없어야 합니다.

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

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

다음 레이블이 만들어집니다:

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

범위가 지정된 레이블#

팀은 범위가 지정된 레이블을 사용하여 이슈, 머지 요청 및 에픽에 상호 배타적인 레이블을 주석으로 달 수 있습니다. 특정 레이블이 함께 사용되지 않도록 하여 더 복잡한 워크플로우를 만들 수 있습니다.

범위가 지정된 레이블

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

이슈, 머지 요청 또는 에픽은 동일한 key를 가진 key::value 형식의 두 범위 레이블을 가질 수 없습니다. 동일한 key이지만 다른 value의 새 레이블을 추가하면 이전 key 레이블이 새 레이블로 교체됩니다.

범위가 지정된 레이블로 필터링#

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

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

Note

범위가 지정된 레이블로 필터링은 이슈 또는 머지 요청 대시보드 페이지에서는 사용할 수 없습니다.

범위가 지정된 레이블 예시#

예시 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::reviewworkflow::backend::development 레이블을 가질 수 없습니다. 둘 다 동일한 범위를 공유하기 때문입니다: workflow::backend.

반면에, 이슈는 동시에 workflow::backend::reviewworkflow::frontend::review 레이블을 가질 수 있습니다. 이 두 레이블은 서로 다른 범위(workflow::frontendworkflow::backend)를 가지기 때문입니다.

레이블이 사용될 때 알림 받기#

레이블이 이슈, 머지 요청 또는 에픽에 할당될 때마다 알림을 받으려면 레이블을 구독할 수 있습니다.

레이블을 구독하려면:

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

레이블 우선순위 설정#

히스토리
  • GitLab 17.7에서 레이블 우선순위를 설정하기 위한 최소 역할이 Reporter에서 Planner로 변경되었습니다.

레이블은 상대적 우선순위를 가질 수 있으며, 이슈와 머지 요청 목록을 레이블 우선순위우선순위로 정렬할 때 사용됩니다.

레이블 우선순위를 지정할 때는 프로젝트에서 해야 합니다. 그룹 레이블 목록에서는 할 수 없습니다.

Note

우선순위 정렬은 가장 높은 우선순위 레이블에만 기반합니다. 이슈 14523에서 이를 변경하는 것을 고려하고 있습니다.

사전 요구 사항:

  • 프로젝트에 대한 Planner, Reporter, Developer, Maintainer 또는 Owner 역할이 있어야 합니다.

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

  1. 상단 바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 관리 > 레이블을 선택합니다.
  3. 우선순위를 지정할 레이블 옆에서 별표 ([star-o])를 선택합니다.

우선순위가 지정된 레이블

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

이 레이블의 상대적 우선순위를 변경하려면 목록에서 위아래로 끌어다 놓습니다. 목록에서 더 높은 레이블이 더 높은 우선순위를 갖습니다.

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

머지 요청이 병합될 때 레이블 잠금#

히스토리
  • GitLab 16.3에서 enforce_locked_labels_on_merge 플래그가 있는 상태로 도입되었습니다. 이 기능은 베타 버전입니다. 기본적으로 비활성화됩니다.
  • GitLab 17.7에서 레이블을 잠그기 위한 최소 역할이 Reporter에서 Planner로 변경되었습니다.
Feature flag

이 기능의 가용성은 기능 플래그에 의해 제어됩니다. 자세한 내용은 기록을 참조하세요. 이 기능은 테스트용으로 제공되지만 프로덕션 사용에는 아직 준비되지 않았습니다.

특정 감사 요구 사항을 준수하기 위해 레이블을 잠금으로 설정할 수 있습니다. 잠긴 레이블이 있는 머지 요청이 병합되면 아무도 MR에서 레이블을 제거할 수 없습니다.

잠긴 레이블을 이슈나 에픽에 추가하면 일반 레이블처럼 동작합니다.

사전 요구 사항:

  • 프로젝트 또는 그룹에 대한 Planner, Reporter, Developer, Maintainer 또는 Owner 역할이 있어야 합니다.
Warning

레이블을 잠금으로 설정하면 아무도 취소하거나 레이블을 삭제할 수 없습니다.

병합 시 잠기도록 레이블을 설정하려면:

  1. 상단 바에서 검색 또는 이동을 선택하고 그룹 또는 프로젝트를 찾습니다.
  2. 관리 > 레이블을 선택합니다.
  3. 편집할 레이블 옆에서 세로 줄임표 (⋮)를 선택한 다음 편집을 선택합니다.
  4. 머지 요청이 병합된 후 레이블 잠금 체크박스를 선택합니다.
  5. 변경 사항 저장을 선택합니다.

레이블 감사 이벤트#

GitLab은 프로젝트 및 그룹 레이블을 생성, 업데이트 또는 삭제할 때 감사 이벤트를 기록합니다. 이 이벤트를 사용하여 디버깅 또는 규정 준수 목적으로 레이블 변경 사항을 추적하세요.

다음 레이블 작업은 감사 이벤트를 생성합니다:

  • label_created: 프로젝트 또는 그룹 레이블이 생성됩니다.
  • label_updated: 프로젝트 또는 그룹 레이블이 업데이트됩니다. 제목이 변경되면 감사 메시지에 이전 제목과 새 제목이 포함됩니다 (예: Changed label title from Foo to Bar). 다른 필드 변경의 경우 메시지는 일반적입니다 (예: Updated label Foo).
  • label_deleted: 프로젝트 또는 그룹 레이블이 삭제됩니다.
Note

GitLab이 자동으로 생성하는 레이블(예: Jira 가져오기 중)은 감사 이벤트를 생성하지 않습니다. 직접 사용자 작업을 통해 생성된 레이블만 감사됩니다.

관련 항목#

레이블

Tier: Premium, Ultimate
Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
원문 보기
요약

레이블은 GitLab 기능 전반에서 작업을 구성하고 추적합니다. GitLab에서 세 가지 유형의 레이블을 사용합니다: 이슈, 머지 요청 또는 에픽에 레이블을 할당할 수 있습니다. 변경된 레이블은 다음에서 페이지를 새로 고치지 않고 다른 사용자에게 즉시 표시됩니다:

레이블은 GitLab 기능 전반에서 작업을 구성하고 추적합니다. 프로젝트가 소규모 팀에서 대규모 조직으로 성장함에 따라 레이블은 증가하는 양의 작업을 추적하고 관리하는 데 도움이 됩니다. 레이블:

  • 이슈, 머지 요청 및 에픽을 사용자 정의 속성으로 분류합니다.
  • 목록과 보드에서 콘텐츠를 필터링합니다.
  • 색상과 설명적인 제목으로 작업 항목의 우선순위를 지정합니다.
  • 범위가 지정된 레이블로 우선순위와 심각도를 추적합니다.
  • 구성된 그룹화를 통해 워크플로우를 구조화합니다.

레이블 유형#

GitLab에서 세 가지 유형의 레이블을 사용합니다:

  • 프로젝트 레이블은 해당 프로젝트의 이슈 및 머지 요청에만 할당할 수 있습니다.
  • 그룹 레이블은 선택한 그룹이나 하위 그룹의 모든 프로젝트에서 이슈, 머지 요청 및 에픽에 할당할 수 있습니다.
  • 인스턴스 레이블은 인스턴스 관리자가 생성하며 모든 새 프로젝트에 복사됩니다.

레이블 할당 및 해제#

히스토리
  • GitLab 14.10에서 realtime_labels 기능 플래그가 있는 상태로 사이드바의 실시간 업데이트가 도입되었습니다. 기본적으로 비활성화됩니다.
  • GitLab 15.1에서 GitLab.com에서 활성화된 사이드바의 실시간 업데이트.
  • GitLab 15.5에서 기본적으로 활성화된 사이드바의 실시간 업데이트.
  • GitLab 15.6에서 일반 사용 가능한 사이드바의 실시간 업데이트. 기능 플래그 realtime_labels 제거됨.

이슈, 머지 요청 또는 에픽에 레이블을 할당할 수 있습니다.

변경된 레이블은 다음에서 페이지를 새로 고치지 않고 다른 사용자에게 즉시 표시됩니다:

  • 에픽
  • 인시던트
  • 이슈
  • 머지 요청

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

  1. 사이드바의 레이블 섹션에서 편집을 선택합니다.
  2. 레이블 할당 목록에서 이름을 입력하여 레이블을 검색합니다. 반복 검색하여 더 많은 레이블을 추가할 수 있습니다. 선택된 레이블은 체크 표시로 표시됩니다.
  3. 할당하거나 해제할 레이블을 선택합니다.
  4. 레이블 변경 사항을 적용하려면 레이블 할당 옆의 X를 선택하거나 레이블 섹션 외부의 아무 영역이나 선택합니다.

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

빠른 작업으로 레이블을 할당하거나 해제할 수도 있습니다:

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

사용 가능한 레이블 보기#

프로젝트 레이블 보기#

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

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

또는:

  1. 이슈 또는 머지 요청을 봅니다.
  2. 오른쪽 사이드바의 레이블 섹션에서 편집을 선택합니다.
  3. 프로젝트 레이블 관리를 선택합니다.

레이블 목록에는 프로젝트에서 만든 레이블과 프로젝트의 상위 그룹에서 만든 모든 레이블이 포함됩니다. 각 레이블에 대해 레이블이 만들어진 프로젝트 또는 그룹 경로를 볼 수 있습니다.

그룹 레이블 보기#

그룹의 레이블을 보려면:

  1. 상단 바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
  2. 왼쪽 사이드바에서 관리 > 레이블을 선택합니다.

또는:

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

목록에는 그룹에서만 만든 레이블이 포함됩니다. 그룹의 프로젝트에서 만든 레이블은 나열되지 않습니다.

레이블 만들기#

히스토리
  • GitLab 17.7에서 레이블을 만들기 위한 최소 역할이 Reporter에서 Planner로 변경되었습니다.

사전 요구 사항:

  • 프로젝트 또는 그룹에 대한 Planner, Reporter, Developer, Maintainer 또는 Owner 역할이 있어야 합니다.

프로젝트 레이블 만들기#

프로젝트 레이블을 만들려면:

  1. 상단 바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 관리 > 레이블을 선택합니다.
  3. 새 레이블을 선택합니다.
  4. 제목 필드에 레이블의 짧고 설명적인 이름을 입력합니다. 이 필드를 사용하여 범위가 지정된 상호 배타적 레이블을 만들 수도 있습니다.
  5. 선택 사항. 설명 필드에 이 레이블을 사용하는 방법과 시기에 대한 추가 정보를 입력합니다.
  6. 선택 사항. 사용 가능한 색상 중에서 선택하거나 배경 색상 필드에 특정 색상의 16진수 색상 값을 입력하여 색상을 선택합니다.
  7. 레이블 만들기를 선택합니다.

이슈 또는 머지 요청에서 프로젝트 레이블 만들기#

히스토리
  • GitLab 17.7에서 레이블을 만들기 위한 최소 역할이 Reporter에서 Planner로 변경되었습니다.

이슈나 머지 요청에서 새 프로젝트 레이블을 만들 수도 있습니다. 이런 방식으로 만든 레이블은 이슈나 머지 요청과 동일한 프로젝트에 속합니다.

사전 요구 사항:

  • 프로젝트에 대한 Planner, Reporter, Developer, Maintainer 또는 Owner 역할이 있어야 합니다.

이를 위해:

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

그룹 레이블 만들기#

그룹 레이블을 만들려면:

  1. 상단 바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
  2. 왼쪽 사이드바에서 관리 > 레이블을 선택합니다.
  3. 새 레이블을 선택합니다.
  4. 제목 필드에 레이블의 짧고 설명적인 이름을 입력합니다. 이 필드를 사용하여 범위가 지정된 상호 배타적 레이블을 만들 수도 있습니다.
  5. 선택 사항. 설명 필드에 이 레이블을 사용하는 방법과 시기에 대한 추가 정보를 입력합니다.
  6. 선택 사항. 사용 가능한 색상 중에서 선택하거나 배경 색상 필드에 특정 색상의 16진수 색상 값을 입력하여 색상을 선택합니다.
  7. 레이블 만들기를 선택합니다.

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

히스토리
  • GitLab 17.7에서 그룹 레이블을 만들기 위한 최소 역할이 Reporter에서 Planner로 변경되었습니다.

에픽에서 새 그룹 레이블을 만들 수도 있습니다. 이런 방식으로 만든 레이블은 에픽과 동일한 그룹에 속합니다.

사전 요구 사항:

  • 그룹에 대한 Planner, Reporter, Developer, Maintainer 또는 Owner 역할이 있어야 합니다.

이를 위해:

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

레이블 편집#

히스토리
  • GitLab 17.7에서 레이블을 편집하기 위한 최소 역할이 Reporter에서 Planner로 변경되었습니다.

사전 요구 사항:

  • 프로젝트 또는 그룹에 대한 Planner, Reporter, Developer, Maintainer 또는 Owner 역할이 있어야 합니다.

프로젝트 레이블 편집#

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

  1. 상단 바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 관리 > 레이블을 선택합니다.
  3. 편집할 레이블 옆에서 세로 줄임표 (⋮)를 선택한 다음 편집을 선택합니다.
  4. 변경 사항 저장을 선택합니다.

그룹 레이블 편집#

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

  1. 상단 바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
  2. 왼쪽 사이드바에서 관리 > 레이블을 선택합니다.
  3. 편집할 레이블 옆에서 세로 줄임표 (⋮)를 선택한 다음 편집을 선택합니다.
  4. 변경 사항 저장을 선택합니다.

레이블 삭제#

히스토리
  • GitLab 17.7에서 레이블을 삭제하기 위한 최소 역할이 Reporter에서 Planner로 변경되었습니다.
Warning

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

사전 요구 사항:

  • 프로젝트에 대한 Planner, Reporter, Developer, Maintainer 또는 Owner 역할이 있어야 합니다.

프로젝트 레이블 삭제#

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

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

그룹 레이블 삭제#

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

  1. 상단 바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.

  2. 왼쪽 사이드바에서 관리 > 레이블을 선택합니다.

  3. 다음 중 하나:

    • 구독 버튼 옆에서 (⋮)을 선택합니다.
    • 편집할 레이블 옆에서 편집 (✏️)을 선택합니다.
  4. 삭제를 선택합니다.

보관된 레이블#

히스토리
  • GitLab 18.3에서 labels_archive 플래그가 있는 상태로 도입되었습니다. 기본적으로 비활성화됩니다.
  • GitLab 18.7에서 그룹에 대해 켜고 끌 수 있도록 플래그 labels_archive변경되었습니다.
  • GitLab 18.11에서 일반 사용 가능. 기능 플래그 labels_archive 제거.

더 이상 적극적으로 사용되지 않지만 과거 기록과 검색 목적으로 보존해야 하는 레이블을 보관할 수 있습니다.

예를 들어, 릴리스가 완료된 후 Q4-25와 같은 릴리스 레이블을 보관하여 레이블 선택 드롭다운 목록에서는 제거하면서 검색에는 계속 사용할 수 있도록 할 수 있습니다.

레이블을 보관하면:

  • 레이블이 이슈, 머지 요청, 에픽의 레이블 선택 드롭다운 목록에서 숨겨집니다.
  • 레이블이 이전에 할당된 기존 이슈, 머지 요청 및 에픽에서는 계속 표시됩니다.
  • 여전히 레이블을 검색하고 기록 데이터를 볼 수 있습니다.
  • 레이블이 레이블 페이지의 별도 보관됨 탭에 표시됩니다.

레이블 보관#

사전 요구 사항:

  • 프로젝트 또는 그룹에 대한 Planner, Reporter, Developer, Maintainer 또는 Owner 역할이 있어야 합니다.

레이블을 보관하려면:

  1. 상단 바에서 검색 또는 이동을 선택하고 프로젝트 또는 그룹을 찾습니다.
  2. 왼쪽 사이드바에서 관리 > 레이블을 선택합니다.
  3. 보관할 레이블 옆에서 편집 (✏️)을 선택합니다.
  4. 보관됨 체크박스를 선택합니다.
  5. 변경 사항 저장을 선택합니다.

레이블이 보관되고 우선순위가 낮아집니다.

보관된 레이블 보기#

보관된 레이블을 보려면:

  1. 상단 바에서 검색 또는 이동을 선택하고 프로젝트 또는 그룹을 찾습니다.
  2. 왼쪽 사이드바에서 관리 > 레이블을 선택합니다.
  3. 프로젝트 또는 그룹의 레이블 페이지로 이동합니다.
  4. 보관됨 탭을 선택합니다.

레이블 보관 취소#

사전 요구 사항:

  • 프로젝트 또는 그룹에 대한 Planner, Reporter, Developer, Maintainer 또는 Owner 역할이 있어야 합니다.

레이블 보관을 취소하려면:

  1. 상단 바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 관리 > 레이블을 선택합니다.
  3. 보관됨 탭을 선택합니다.
  4. 보관을 취소할 레이블 옆에서 편집 (✏️)을 선택합니다.
  5. 보관됨 체크박스를 지웁니다.
  6. 변경 사항 저장을 선택합니다.

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

히스토리
  • GitLab 17.7에서 레이블을 승격하기 위한 최소 역할이 Reporter에서 Planner로 변경되었습니다.

동일한 그룹의 다른 프로젝트에서 프로젝트 레이블을 사용 가능하게 만들고 싶을 수 있습니다. 그러면 레이블을 그룹 레이블로 승격할 수 있습니다.

동일한 그룹의 다른 프로젝트에 동일한 제목의 레이블이 있는 경우 모두 새 그룹 레이블과 합쳐집니다. 동일한 제목의 그룹 레이블이 있는 경우에도 합쳐집니다.

Warning

레이블 승격은 영구적인 작업이며 취소할 수 없습니다.

사전 요구 사항:

  • 프로젝트에 대한 Planner, Reporter, Developer, Maintainer 또는 Owner 역할이 있어야 합니다.
  • 프로젝트의 상위 그룹에 대한 Planner, Reporter, Developer, Maintainer 또는 Owner 역할이 있어야 합니다.

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

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

이전 레이블이 있는 모든 이슈, 머지 요청, 이슈 보드 목록, 이슈 보드 필터 및 레이블 구독이 새 그룹 레이블에 할당됩니다.

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

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

히스토리
  • GitLab 17.7에서 레이블을 승격하기 위한 최소 역할이 Reporter에서 Planner로 변경되었습니다.

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

사전 요구 사항:

  • 하위 그룹을 포함하는 그룹("상위 그룹")이 있어야 합니다.
  • 상위 그룹에 승격하려는 레이블이 있는 하위 그룹이 있어야 합니다.
  • 두 그룹 모두에 대한 Planner, Reporter, Developer, Maintainer 또는 Owner 역할이 있어야 합니다.

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

  1. 상위 그룹에서 원래 레이블과 동일한 이름으로 레이블을 만듭니다. 이 두 레이블을 혼동하지 않도록 다른 색상으로 만드는 것이 좋습니다.

  2. 하위 그룹에서 레이블을 봅니다. 두 레이블과 출처를 볼 수 있어야 합니다:

    하위 그룹의 레이블 목록에서 상위 그룹과 하위 그룹 레이블

  3. 하위 그룹 레이블(이전 레이블) 옆에서 이슈, 머지 요청 또는 에픽을 선택합니다.

  4. 이전 레이블이 있는 이슈, 머지 요청 및 에픽에 새 레이블을 추가합니다. 더 빠르게 하려면 일괄 편집을 사용합니다.

  5. 하위 그룹이나 상위 그룹에서 하위 수준 그룹에 속하는 레이블을 삭제합니다.

이제 상위 그룹에 이전 레이블과 동일한 이름을 가진 레이블이 있으며, 동일한 이슈, MR 및 에픽에 추가됩니다.

기본 프로젝트 레이블 생성#

히스토리
  • GitLab 17.7에서 기본 레이블을 생성하기 위한 최소 역할이 Reporter에서 Planner로 변경되었습니다.

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

사전 요구 사항:

  • 프로젝트에 대한 Planner, Reporter, Developer, Maintainer 또는 Owner 역할이 있어야 합니다.
  • 프로젝트에 레이블이 없어야 합니다.

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

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

다음 레이블이 만들어집니다:

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

범위가 지정된 레이블#

팀은 범위가 지정된 레이블을 사용하여 이슈, 머지 요청 및 에픽에 상호 배타적인 레이블을 주석으로 달 수 있습니다. 특정 레이블이 함께 사용되지 않도록 하여 더 복잡한 워크플로우를 만들 수 있습니다.

범위가 지정된 레이블

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

이슈, 머지 요청 또는 에픽은 동일한 key를 가진 key::value 형식의 두 범위 레이블을 가질 수 없습니다. 동일한 key이지만 다른 value의 새 레이블을 추가하면 이전 key 레이블이 새 레이블로 교체됩니다.

범위가 지정된 레이블로 필터링#

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

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

Note

범위가 지정된 레이블로 필터링은 이슈 또는 머지 요청 대시보드 페이지에서는 사용할 수 없습니다.

범위가 지정된 레이블 예시#

예시 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::reviewworkflow::backend::development 레이블을 가질 수 없습니다. 둘 다 동일한 범위를 공유하기 때문입니다: workflow::backend.

반면에, 이슈는 동시에 workflow::backend::reviewworkflow::frontend::review 레이블을 가질 수 있습니다. 이 두 레이블은 서로 다른 범위(workflow::frontendworkflow::backend)를 가지기 때문입니다.

레이블이 사용될 때 알림 받기#

레이블이 이슈, 머지 요청 또는 에픽에 할당될 때마다 알림을 받으려면 레이블을 구독할 수 있습니다.

레이블을 구독하려면:

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

레이블 우선순위 설정#

히스토리
  • GitLab 17.7에서 레이블 우선순위를 설정하기 위한 최소 역할이 Reporter에서 Planner로 변경되었습니다.

레이블은 상대적 우선순위를 가질 수 있으며, 이슈와 머지 요청 목록을 레이블 우선순위우선순위로 정렬할 때 사용됩니다.

레이블 우선순위를 지정할 때는 프로젝트에서 해야 합니다. 그룹 레이블 목록에서는 할 수 없습니다.

Note

우선순위 정렬은 가장 높은 우선순위 레이블에만 기반합니다. 이슈 14523에서 이를 변경하는 것을 고려하고 있습니다.

사전 요구 사항:

  • 프로젝트에 대한 Planner, Reporter, Developer, Maintainer 또는 Owner 역할이 있어야 합니다.

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

  1. 상단 바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 관리 > 레이블을 선택합니다.
  3. 우선순위를 지정할 레이블 옆에서 별표 ([star-o])를 선택합니다.

우선순위가 지정된 레이블

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

이 레이블의 상대적 우선순위를 변경하려면 목록에서 위아래로 끌어다 놓습니다. 목록에서 더 높은 레이블이 더 높은 우선순위를 갖습니다.

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

머지 요청이 병합될 때 레이블 잠금#

히스토리
  • GitLab 16.3에서 enforce_locked_labels_on_merge 플래그가 있는 상태로 도입되었습니다. 이 기능은 베타 버전입니다. 기본적으로 비활성화됩니다.
  • GitLab 17.7에서 레이블을 잠그기 위한 최소 역할이 Reporter에서 Planner로 변경되었습니다.
Feature flag

이 기능의 가용성은 기능 플래그에 의해 제어됩니다. 자세한 내용은 기록을 참조하세요. 이 기능은 테스트용으로 제공되지만 프로덕션 사용에는 아직 준비되지 않았습니다.

특정 감사 요구 사항을 준수하기 위해 레이블을 잠금으로 설정할 수 있습니다. 잠긴 레이블이 있는 머지 요청이 병합되면 아무도 MR에서 레이블을 제거할 수 없습니다.

잠긴 레이블을 이슈나 에픽에 추가하면 일반 레이블처럼 동작합니다.

사전 요구 사항:

  • 프로젝트 또는 그룹에 대한 Planner, Reporter, Developer, Maintainer 또는 Owner 역할이 있어야 합니다.
Warning

레이블을 잠금으로 설정하면 아무도 취소하거나 레이블을 삭제할 수 없습니다.

병합 시 잠기도록 레이블을 설정하려면:

  1. 상단 바에서 검색 또는 이동을 선택하고 그룹 또는 프로젝트를 찾습니다.
  2. 관리 > 레이블을 선택합니다.
  3. 편집할 레이블 옆에서 세로 줄임표 (⋮)를 선택한 다음 편집을 선택합니다.
  4. 머지 요청이 병합된 후 레이블 잠금 체크박스를 선택합니다.
  5. 변경 사항 저장을 선택합니다.

레이블 감사 이벤트#

GitLab은 프로젝트 및 그룹 레이블을 생성, 업데이트 또는 삭제할 때 감사 이벤트를 기록합니다. 이 이벤트를 사용하여 디버깅 또는 규정 준수 목적으로 레이블 변경 사항을 추적하세요.

다음 레이블 작업은 감사 이벤트를 생성합니다:

  • label_created: 프로젝트 또는 그룹 레이블이 생성됩니다.
  • label_updated: 프로젝트 또는 그룹 레이블이 업데이트됩니다. 제목이 변경되면 감사 메시지에 이전 제목과 새 제목이 포함됩니다 (예: Changed label title from Foo to Bar). 다른 필드 변경의 경우 메시지는 일반적입니다 (예: Updated label Foo).
  • label_deleted: 프로젝트 또는 그룹 레이블이 삭제됩니다.
Note

GitLab이 자동으로 생성하는 레이블(예: Jira 가져오기 중)은 감사 이벤트를 생성하지 않습니다. 직접 사용자 작업을 통해 생성된 레이블만 감사됩니다.

관련 항목#