레이블

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

GitLab에서 이슈, 병합 요청 및 에픽의 개수가 늘어남에 따라 해당 항목을 추적하는 것이 점점 더 어려워집니다. 특히 몇 사람에서 수백 또는 수천 명으로 조직이 성장함에 따라 더욱 그렇습니다. 레이블을 사용하면 작업을 조직화하고 태그를 지정하여 관심 있는 작업 항목을 추적할 수 있습니다.

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

  • 버그, 기능 요청, 또는 문서와 같이 색상 및 설명적인 제목을 사용하여 에픽, 이슈 및 병합 요청을 분류합니다.
  • 이슈 보드에서 동적으로 필터링하고 관리합니다.
  • 이슈, 병합 요청 및 에픽 목록 및 이슈 보드를 검색합니다.

레이블의 유형

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

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

레이블 할당 및 미할당

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

변경된 레이블은 즉시 다른 사용자에게 보이며 페이지를 새로 고침할 필요가 없습니다. 다음에서 레이블을 할당하거나 미할당할 수 있습니다:

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

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

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

또는 다음과 같이 빠른 조치로 레이블을 할당하거나 미할당할 수 있습니다:

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

사용 가능한 레이블보기

프로젝트 레이블 보기

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

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

또는:

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

레이블 목록에는 프로젝트와 해당 상위 그룹에서 만들어진 레이블이 모두 포함되어 있습니다. 각 레이블에 대해 해당 레이블이 생성된 프로젝트 또는 그룹 경로를 볼 수 있습니다.

그룹 레이블 보기

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

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

또는:

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

목록에는 해당 그룹에서만 만들어진 모든 레이블이 포함되어 있습니다. 해당 그룹의 프로젝트에서 만들어진 레이블은 나열되지 않습니다.

레이블 만들기

필수 사항:

  • 프로젝트 또는 그룹의 기록자 역할을 최소한으로 할당 받아야 합니다.

프로젝트 레이블 만들기

프로젝트 레이블을 만들려면 다음을 수행합니다:

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

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

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

필수 사항:

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

다음과 같이 진행하세요:

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

그룹 레이블 생성

그룹 레이블을 만들려면:

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

이픽(에픽)에서 그룹 레이블 생성

상세 정보: Tier: Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated

에픽(에픽)에서도 새 그룹 레이블을 만들 수 있습니다. 이 방법으로 생성하는 레이블은 해당 에픽과 동일한 그룹에 속합니다.

필수 사항:

  • 해당 그룹에 적어도 기고자(Reporter) 역할이 있어야 합니다.

다음과 같이 진행하세요:

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

레이블 편집

필수 사항:

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

프로젝트 레이블 편집

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

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

그룹 레이블 편집

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

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하여 그룹을 찾습니다.
  2. 관리 > 레이블을 선택합니다.
  3. 편집하려는 레이블 옆에 수직 엘리프시스()를 선택한 다음 편집을 선택합니다.
  4. 변경 사항 저장을 선택합니다.

레이블 삭제

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

필수 사항:

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

프로젝트 레이블 삭제

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

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

그룹 레이블 삭제

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

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

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

    • 구독 버튼 옆에 ()를 선택합니다.
    • 편집하려는 레이블 옆에 편집({pencil}**)를 선택합니다.
  4. https://www.example.com 선택합니다.

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

동일한 그룹에 있는 다른 프로젝트에서 사용할 수 있도록 프로젝트 레이블을 그룹 레이블로 승격하려 할 수도 있습니다.그럼 승격

동일 그룹의 다른 프로젝트에 동일한 제목의 레이블이 있는 경우 그들은 새 그룹 레이블과 병합됩니다. 동일한 제목의 그룹 레이블이 있는 경우 그것도 병합됩니다.

경고: 레이블을 승격하면 해당 동작은 영구적이며 되돌릴 수 없습니다.

필수 사항:

  • 해당 프로젝트에 적어도 기고자(Reporter) 역할이 있어야 합니다.
  • 해당 프로젝트의 상위 그룹에 적어도 기고자(Reporter) 역할이 있어야 합니다.

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

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

모든 이슈, 병합 요청, 이슈 보드 목록, 이슈 보드 필터 및 레이블 구독은 이전 레이블에 할당됩니다.

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

부모 그룹으로 하위 그룹 레이블 승격

그룹 레이블을 직접적으로 부모 그룹으로 승격하는 것은 불가능합니다. 이를 달성하려면 다음의 해결책을 사용하세요.

전제 조건:

  • 하위 그룹을 포함하는 그룹이 있어야 합니다(“부모 그룹”).
  • 승격하려는 레이블이 있는 부모 그룹 내에 하위 그룹이 있어야 합니다.
  • 두 그룹 모두에게 적어도 기자 역할이 있어야 합니다.

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

  1. 부모 그룹에서 원래 레이블과 동일한 이름의 레이블을 생성하세요. 이 작업 중에 두 개를 혼동하지 않도록 색깔을 다르게 하는 것을 권장합니다.

  2. 하위 그룹에서 레이블을 확인하세요. 두 개의 레이블과 그 출처를 확인해야 합니다:

    하위 그룹 레이블 목록에서 부모 그룹과 하위 그룹 레이블

  3. 하위 그룹 레이블(이전 레이블) 옆에 이슈, 병합 요청, 또는 에픽을 선택하세요.
  4. 새로운 레이블을 이전 레이블을 가진 이슈, 병합 요청 및 에픽에 추가하세요. 빠르게 하려면 일괄 편집을 사용하세요.
  5. 하위 그룹 또는 부모 그룹에서 소속된 그룹의 레이블을 삭제하세요.

이제 부모 그룹에는 기존 레이블과 동일한 이름의 레이블이 추가되었으며 이전과 동일한 이슈, MR 및 에픽에 추가되었습니다.

기본 프로젝트 레이블 생성

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

전제 조건:

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

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

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

다음과 같은 레이블이 생성됩니다:

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

범위가 지정된 레이블

세부 정보: Tier: Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated

팀은 상호 배타적인 레이블로 이슈, 병합 요청 및 에픽에 주석을 다는 데 범위가 지정된 레이블을 사용할 수 있습니다. 특정 레이블을 함께 사용하는 것을 방지하여 더 복잡한 워크플로우를 생성할 수 있습니다.

범위가 지정된 레이블

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

이슈, 병합 요청 또는 에픽은 동일한 key로 형식이 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::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. 선택 사항. 프로젝트의 그룹 레이블을 구독하는 경우, 다음 중 하나를 선택합니다:
    • 이 프로젝트에서 발생하는 이벤트에 대해 알림을 받으려면 프로젝트 수준에서 구독을 선택합니다.
    • 그룹 전체에서 발생하는 이벤트에 대해 알림을 받으려면 그룹 수준에서 구독을 선택합니다.

레이블 우선 순위 설정

레이블에는 상대적인 우선 순위가 있으며, 이는 레이블 우선 순위로 이슈와 병합 요청 목록을 정렬하거나 우선 순위로 정렬할 때 사용됩니다.

레이블의 우선 순위를 설정할 때, 프로젝트에서만 할 수 있습니다. 그룹 레이블 목록에서는 불가능합니다.

참고: 우선 순위 정렬은 가장 높은 우선 순위 레이블에 기반합니다. 이 토론은 이를 변경하는 것을 고려합니다.

전제 조건: 프로젝트에 대해 적어도 기고자 역할을 가져야 합니다.

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

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

우선 순위가 지정된 레이블

이 레이블은 이제 우선 순위가 지정된 레이블 아래의 레이블 목록 상단에 나타납니다.

이러한 레이블의 상대적인 우선 순위를 변경하려면 목록에서 위아래로 끌어 올리십시오. 목록 상위에 있는 레이블일수록 높은 우선 순위를 가집니다.

우선 순위 또는 레이블 우선 순위로 정렬할 때 어떻게 작동하는지에 대한 자세한 내용은 이슈 목록 정렬하기를 참조하세요.

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

세부 정보: Tier: Free, Premium, Ultimate Offering: GitLab.com Status: Beta

플래그: 자체 호스팅하는 GitLab 및 GitLab Dedicated에서는 이 기능을 사용할 수 없습니다. GitLab.com에서는 관리자만이 이 기능을 구성할 수 있습니다. 그룹 또는 프로젝트별로 사용하도록 만들려면 관리자가 enforce_locked_labels_on_merge이름의 피처 플래그를 활성화할 수 있습니다.

특정 감사 요구 사항을 준수하기 위해 레이블을 잠급니다. 잠긴 레이블이 있는 병합 요청이 병합되면 해당 레이블을 아무도 제거할 수 없습니다.

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

전제 조건: 프로젝트 또는 그룹에 대해 적어도 보고자 역할을 가져야 합니다.

주의: 레이블을 잠그면 누구도 이를 실행 취소하거나 레이블을 삭제할 수 없습니다.

병합 요청이 병합될 때 레이블을 잠그려면:

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

관련 주제

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

문제 해결

일부 레이블 제목이 _duplicate<number>로 끝남

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

GitLab 13.2에서 나중에, 일부 중복된 레이블의 제목에는 _duplicate<number>가 붙는 방식으로 해결되었습니다.

선호하는 경우 이러한 레이블의 제목을 안전하게 변경할 수 있습니다. 원래 문제의 자세한 내용은 이슈 30390을 참조하세요.