• 라벨 유형
• 라벨 할당 및 해제
• 사용 가능한 라벨 보기
  • 프로젝트 라벨 보기
  • 그룹 레이블 보기
• 레이블 생성
  • 프로젝트 레이블 생성
  • 이슈 또는 머지 요청에서 프로젝트 레이블 생성
  • 그룹 레이블 생성
  • 에픽에서 그룹 레이블 생성
• 레이블 편집
  • 프로젝트 레이블 편집
  • 그룹 레이블 편집
• 레이블 삭제
  • 프로젝트 레이블 삭제
  • 그룹 레이블 삭제
• 프로젝트 레이블을 그룹 레이블로 승격
• 서브그룹 레이블을 상위 그룹으로 승격
• 기본 프로젝트 레이블 생성
• 스코프 레이블
  • 스코프 레이블로 필터링
  • 스코프 레이블 예제
  • 중첩 범위
• 레이블 사용 시 알림 받기
• 레이블 우선 순위 설정
• 머지 요청이 병합될 때 레이블 잠금
• 관련 주제

라벨

라벨은 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. 그룹 레이블 관리를 선택합니다.

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

레이블 생성

전제조건:

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

프로젝트 레이블 생성

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

1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
2. 관리 > 레이블을 선택합니다.
3. 새 레이블을 선택합니다.
4. 제목 필드에 레이블에 대한 짧고 설명적인 이름을 입력합니다.
   이 필드를 사용하여 스코프가 있는, 상호 배타적인 레이블을 생성할 수도 있습니다.
5. 선택 사항. 설명 필드에 이 레이블을 어떻게 언제 사용하는지에 대한 추가 정보를 입력합니다.
6. 선택 사항. 사용 가능한 색상 중에서 선택하여 색상을 선택하거나, 배경색 필드에 특정 색상을 위한 16진색 값 입력합니다.
7. 레이블 생성을 선택합니다.

이슈 또는 머지 요청에서 프로젝트 레이블 생성

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

전제조건:

• 프로젝트에 대해 최소한 Reporter 역할이 있어야 합니다.

방법은 다음과 같습니다:

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

그룹 레이블 생성

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

1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
2. 관리 > 레이블을 선택합니다.
3. 새 레이블을 선택합니다.
4. 제목 필드에 레이블에 대한 짧고 설명적인 이름을 입력합니다.
   이 필드를 사용하여 스코프가 있는, 상호 배타적인 레이블을 생성할 수도 있습니다.
5. 선택 사항. 설명 필드에 이 레이블을 어떻게 언제 사용하는지에 대한 추가 정보를 입력합니다.
6. 선택 사항. 사용 가능한 색상 중에서 선택하여 색상을 선택하거나, 배경색 필드에 특정 색상을 위한 16진색 값 입력합니다.
7. 레이블 생성을 선택합니다.

에픽에서 그룹 레이블 생성

에픽에서 새 그룹 레이블을 생성할 수도 있습니다.
이 방법으로 생성한 레이블은 에픽과 동일한 그룹에 속합니다.

전제조건:

• 그룹에 대해 최소한 Reporter 역할이 있어야 합니다.

방법은 다음과 같습니다:

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

레이블 편집

사전 조건:

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

프로젝트 레이블 편집

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

1. 왼쪽 사이드바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
2. Manage > Labels를 선택합니다.
3. 편집하려는 레이블 옆에서 수직 줄임표()를 선택한 다음, Edit를 선택합니다.
4. Save changes를 선택합니다.

그룹 레이블 편집

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

1. 왼쪽 사이드바에서 Search or go to를 선택하고 그룹을 찾습니다.
2. Manage > Labels를 선택합니다.
3. 편집하려는 레이블 옆에서 수직 줄임표()를 선택한 다음, Edit를 선택합니다.
4. Save changes를 선택합니다.

레이블 삭제

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

사전 조건:

• 프로젝트에 대해 최소한 Reporter 역할이 있어야 합니다.

프로젝트 레이블 삭제

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

1. 왼쪽 사이드바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
2. Manage > Labels를 선택합니다.
3. Subscribe 버튼 옆에서 ()를 선택한 다음, Delete를 선택합니다.

그룹 레이블 삭제

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

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

3. 또는:

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

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

같은 그룹의 다른 프로젝트에서 사용할 수 있도록 프로젝트 레이블을 만들고 싶을 수 있습니다. 그런 다음 레이블을 그룹 레이블로 승격할 수 있습니다.

같은 그룹의 다른 프로젝트에서 동일한 제목을 가진 레이블이 있는 경우, 모두 새 그룹 레이블로 병합됩니다. 동일한 제목의 그룹 레이블이 존재하는 경우에도 병합됩니다.

경고:
레이블을 승격하는 것은 영구적인 작업이며 되돌릴 수 없습니다.

사전 조건:

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

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

1. 왼쪽 사이드바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
2. Manage > Labels를 선택합니다.
3. Subscribe 버튼 옆에서 세 점()을 선택하고 Promote to group label을 선택합니다.

이전 레이블이 있는 모든 문제, 병합 요청, 문제 보드 목록, 문제 보드 필터 및 레이블 구독은 새 그룹 레이블에 할당됩니다.

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

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

그룹 레이블을 상위 그룹으로 직접 승격할 수는 없습니다. 이를 위해 다음 우회 방법을 사용하세요.

사전 조건:

• 하위 그룹을 포함하는 그룹(“상위 그룹”)이 있어야 합니다.
• 승격하려는 레이블이 있는 하위 그룹이 상위 그룹에 있어야 합니다.
• 두 그룹 모두에 대해 최소한 Reporter 역할이 있어야 합니다.

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

1. 상위 그룹에서 원래와 동일한 이름의 라벨을 생성합니다. 실수하지 않도록 다른 색상으로 만드는 것이 좋습니다.

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

   

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

이제 상위 그룹에 이전 레이블과 동일한 이름의 레이블이 있으며, 동일한 문제, 병합 요청 및 에픽에 추가되어야 합니다.

기본 프로젝트 레이블 생성

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

사전 조건:

• 프로젝트에 대해 최소한 Reporter 역할을 가져야 합니다.
• 프로젝트에 현재 레이블이 없어야 합니다.

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

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

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

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

스코프 레이블

팀은 스코프 레이블을 사용하여 문제, 병합 요청 및 에픽에 상호 배타적 레이블을 주석으로 추가할 수 있습니다. 특정 레이블이 함께 사용되는 것을 방지함으로써, 더 복잡한 워크플로우를 생성할 수 있습니다.

스코프 레이블은 제목에 이중 콜론(::) 구문을 사용합니다. 예: workflow::in-review.

문제, 병합 요청 또는 에픽에는 동일한 key를 가진 두 개의 스코프 레이블이 있을 수 없습니다. 동일한 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::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를 가지고 있기 때문입니다.

레이블 사용 시 알림 받기

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

레이블을 구독하려면:

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

레이블 우선 순위 설정

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

레이블의 우선 순위를 설정할 때는 프로젝트에서 설정해야 합니다.

그룹 레이블 목록에서 설정하는 것은 불가능합니다.

이 논의는 이를 변경하는 것을 고려합니다.

전제 조건:

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

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

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

이 레이블은 이제 우선 순위가 매겨진 레이블 아래 레이블 목록의 맨 위에 나타납니다.

이 레이블의 상대적인 우선 순위를 변경하려면 목록에서 위아래로 드래그합니다.

목록에서 더 높은 위치에 있는 레이블이 더 높은 우선 순위를 가집니다.

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

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

Offering: Self-managed

Status: Beta

• GitLab 16.3에서 도입됨 플래그 명칭 enforce_locked_labels_on_merge. 이 기능은 베타입니다. 기본적으로 비활성화되어 있습니다.

이 기능의 사용 가능성은 기능 플래그에 의해 제어됩니다.

자세한 내용은 기록을 참고하세요.

이 기능은 테스트용으로 사용할 수 있지만 프로덕션 사용에 준비되지 않았습니다.

특정 감사 요건을 준수하기 위해 레이블을 잠글 수 있습니다.

잠긴 레이블이 있는 머지 요청이 병합될 때, 누구도 MR에서 레이블을 제거할 수 없습니다.

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

전제 조건:

• 프로젝트나 그룹에 대해 적어도 Reporter 역할을 가져야 합니다.

레이블을 잠금으로 설정한 후에는 누구도 이를 취소하거나 레이블을 삭제할 수 없습니다.

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

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

관련 주제

다음 튜토리얼에서 레이블 작업을 연습하세요:

• 이슈 분류를 위한 단일 프로젝트 설정하기

• 팀 인수인계를 위한 이슈 보드 설정하기