레이블

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

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

GitLab에서 프로젝트가 성장함에 따라 완료된 작업을 추적하는 것이 더 어려워집니다. 특히 몇 명에서 수백 명이나 수천 명으로 조직이 성장함에 따라 그 작업을 추적하기가 더 어려워집니다. 레이블을 사용하면 작업을 구성하고 태그를 지정하여 관심 있는 작업 항목을 추적할 수 있습니다.

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

에픽, 이슈 및 Merge Request에 레이블을 사용하여 다음을 수행할 수 있습니다.

  • bug, feature request, 또는 docs와 같이 색상 및 설명적인 제목을 사용하여 항목을 분류합니다.
  • 진행 중이거나 완료된 작업을 보기 위해 동적으로 필터링하고 관리합니다.
  • 디렉터리 및 보드를 검색합니다.
  • 범위 지정된 레이블을 사용하여 항목의 우선 순위 또는 심각도를 전달합니다.

레이블 유형

GitLab에서는 두 가지 유형의 레이블을 사용할 수 있습니다. - 프로젝트 레이블은 해당 프로젝트의 이슈 및 Merge Request에만 할당할 수 있습니다. - 그룹 레이블은 선택한 그룹이나 해당 하위 그룹에서 사용되는 이슈, Merge Request 및 에픽에 할당할 수 있습니다.

레이블 할당 및 해제

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

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

  • 에픽
  • 인ци던트
  • 이슈
  • Merge Request

레이블을 할당하거나 해제하려면 다음을 수행합니다.

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

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

또한 빠른 작업을 사용하여 레이블을 할당 및 해제할 수 있습니다.

  • /label로 레이블 할당
  • /unlabel로 레이블 제거
  • /relabel로 모든 레이블 제거 및 새로운 레이블 할당

사용 가능한 레이블 보기

프로젝트 레이블 보기

프로젝트의 레이블을 보려면 다음을 수행합니다.

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

또는:

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

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

그룹 레이블 보기

그룹의 레이블을 보려면 다음을 수행합니다.

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

또는:

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

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

레이블 생성

필수 사항:

  • 해당 프로젝트 또는 그룹에 적어도 리포터 역할이 있어야 합니다.

프로젝트 레이블 생성

프로젝트 레이블을 생성하려면 다음을 수행합니다.

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

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

이슈 또는 Merge Request에서 새 프로젝트 레이블을 생성할 수도 있습니다. 이 방법으로 생성하는 레이블은 해당 이슈 또는 Merge Request과 같은 프로젝트에 속합니다.

필수 사항:

  • 해당 프로젝트에 적어도 리포터 역할이 있어야 합니다.

다음을 수행합니다.

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

그룹 레이블 생성

그룹 레이블을 생성하려면 다음을 수행합니다.

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

에픽에서 그룹 레이블 생성

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. 하위 그룹 또는 상위 그룹에서 그룹 레이블을 삭제합니다. 이는 하위 수준 그룹에 속하는 레이블을 삭제할 수 있습니다.

이제 이제 상위 그룹에 이전과 동일한 이름의 레이블이 있고 동일한 이슈, MR 및 에픽에 추가되어 있을 것입니다.

기본 프로젝트 레이블 생성

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

전제 조건:

  • 프로젝트에 적어도 리포터 역할을 가져야 합니다.
  • 프로젝트에 레이블이 없어야 합니다.

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

  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 또는 에픽은 key::value 형식의 두 범위가 지정된 레이블을 가질 수 없습니다. 동일한 key로 다른 value를 사용하는 새 레이블을 추가하면 이전 key 레이블이 새 레이블로 대체됩니다.

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

특정 범주별로 이슈, Merge Request 또는 에픽 디렉터리을 필터링하려면 검색한 레이블 이름에 <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::reviewworkflow::backend::development 레이블을 동시에 할당할 수 없습니다. 왜냐하면 두 레이블 모두 workflow::backend 범위를 공유하기 때문입니다.

그러나 workflow::backend::reviewworkflow::frontend::review 레이블은 동시에 할당할 수 있습니다. 왜냐하면 두 레이블 모두 workflow::frontendworkflow::backend와 다른 범위를 가지고 있기 때문입니다.

레이블 사용 시 알림 수신

레이블을 구독하여 이슈, Merge Request 또는 epic에 레이블이 지정될 때 알림을 받을 수 있습니다.

레이블을 구독하려면:

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

레이블 우선 순위 설정

레이블에는 이슈 및 Merge Request 디렉터리을 정렬할 때 사용되는 상대적인 우선 순위가 있습니다. 레이블 우선 순위우선 순위에 의해 디렉터리을 정렬할 때 사용됩니다.

레이블의 우선 순위를 설정할 때, 프로젝트에서만 수행할 수 있습니다. 그룹 레이블 디렉터리에서는 우선 순위를 설정할 수 없습니다.

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

전제 조건:

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

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

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

레이블 우선 설정됨

해당 레이블은 이제 우선 순위가 지정된 레이블 아래의 레이블 디렉터리 상단에 나타납니다.

이러한 레이블의 상대적인 우선 순위를 변경하려면 해당 레이블을 디렉터리에서 위아래로 끌어옵니다. 디렉터리 상단에 있는 레이블일수록 더 높은 우선 순위를 가집니다.

우선 순위 또는 레이블 우선 순위로 정렬하는 경우 어떤 일이 발생하는지 알아보려면 이슈 디렉터리 정렬을 참조하세요.

레이블을 잠길 때 Merge Request이 Merge되었을 때 레이블 잠그기

Tier: Free, Premium, Ultimate Offering: GitLab.com Status: Beta
자체 호스팅 GitLab 및 GitLab Dedicated에서는 해당 기능을 사용할 수 없습니다. GitLab.com에서는 해당 기능을 사용할 수 있지만, GitLab.com 관리자만이 구성할 수 있습니다. 그룹 또는 프로젝트 단위로 사용하도록 설정하려면 관리자가 enforce_locked_labels_on_merge라는 플래그를 사용하도록 설정할 수 있습니다.

특정 감사 요구 사항을 준수하려면 레이블을 잠길 수 있습니다. 잠긴 레이블이 있는 Merge Request이 Merge되면 해당 레이블을 누구도 제거할 수 없습니다.

잠긴 레이블을 이슈 또는 epic에 추가하는 경우 일반적인 레이블과 동일하게 작동합니다.

전제 조건:

  • 프로젝트나 그룹에 적어도 기고자(Reporter) 역할이 있어야 합니다.
caution
한 번 레이블을 잠근 후에는 둘 수 없으며, 레이블을 삭제할 수 없습니다.

Merge Request이 Merge되면 레이블을 잠그려면:

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

관련 주제

다음 튜토리얼에서 레이블을 사용하는 방법을 실습하세요: