레이블 관리

GitLab에서 이슈, 병합 요청 및 에픽 수가 증가함에 따라, 이러한 항목을 추적하는 것이 점점 더 어려워집니다. 특히 조직이 소수에서 수백 또는 수천으로 성장함에 따라 더욱 그렇습니다. 여기에 레이블이 필요한 것입니다. 작업을 구성하고 태그를 지정하여 관심 있는 작업 항목을 추적하고 찾을 수 있도록 도와줍니다.

레이블은 이슈 보드의 핵심 부분입니다. 레이블을 사용하여 다음을 수행할 수 있습니다.

  • 색상 및 bug, feature request 또는 docs와 같은 설명 제목을 사용하여 에픽, 이슈, 병합 요청을 분류합니다.
  • 에픽, 이슈 및 병합 요청을 동적으로 필터링하고 관리합니다.
  • 이슈, 병합 요청 및 에픽의 목록뿐만 아니라 이슈 보드를 검색합니다.

프로젝트 레이블 및 그룹 레이블​

GitLab에는 두 가지 유형의 레이블이 있습니다.

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

레이블 할당 및 할당 해제​

모든 이슈, 병합 요청 및 에픽에는 원하는 수의 레이블을 할당할 수 있습니다. 레이블은 오른쪽 사이드바에서 관리되며, 필요에 따라 레이블을 할당하거나 할당 해제할 수 있습니다.

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

  1. 사이드바의 Labels 섹션에서 Edit을 클릭합니다.
  2. Assign labels 목록에서, 이름을 입력하여 레이블을 검색합니다. 더 많은 레이블을 추가하기 위해 반복적으로 검색할 수 있습니다. 선택한 레이블에는 체크 표시가 있습니다.
  3. 할당하거나 할당 해제할 레이블을 클릭합니다.
  4. 레이블에 변경사항을 적용하려면, Assign labels 옆의 X 또는 레이블 섹션 외부의 아무 곳이나 클릭합니다.

다른 방법으로 레이블을 할당 해제하려면, 할당을 해제하려는 레이블에서 X를 클릭합니다.

/label 빠른 작업(quick action)을 사용하여 레이블을 할당하고, /unlabel을 사용하여 레이블을 제거하며, /relabel를 사용하여 레이블을 다시 할당(모두 제거하고 새 레이블을 할당)할 수도 있습니다.

레이블 관리​

Reporter 이상의 권한 수준을 가진 사용자는 레이블을 만들고 수정할 수 있습니다.

프로젝트 레이블​

프로젝트 레이블 목록을 보려면 프로젝트에서 Project information > Labels로 이동합니다. 목록에는 프로젝트 수준에서 정의된 모든 레이블과 상위 그룹에서 정의한 모든 레이블이 포함됩니다. 각 레이블에 대해 생성된 프로젝트 또는 그룹 경로를 볼 수 있습니다. Filter 필드에 검색어를 입력하고 검색 아이콘을 클릭하면 목록을 필터링할 수 있습니다.

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

  1. 프로젝트에서 Project information > Labels로 이동합니다.
  2. New label 버튼을 클릭합니다.
  3. Title 필드에 레이블의 설명이 포함된 짧은 이름을 입력합니다.
  4. (선택 사항) Description 필드에 이 레이블을 사용하는 방법과 시기에 대한 추가 정보를 입력할 수 있습니다.
  5. (선택 사항) Background color 필드에 사용 가능한 색상 중 하나를 선택하거나 특정 색상에 대한 Hex 값을 입력합니다.
  6. Create label를 클릭하여 레이블을 만듭니다.

이슈 또는 병합 요청 내에서 새 프로젝트 레이블을 생성할 수도 있습니다. 이슈 또는 병합 요청의 오른쪽 사이드바에 있는 레이블 섹션에서 :

  1. Edit을 클릭합니다.
  2. Create project label를 클릭합니다.
    • Name 필드를 채웁니다. 이 방법으로 레이블을 만드는 경우, 설명을 지정할 수 없습니다. 나중에 레이블을 편집하여 설명을 추가할 수 있습니다(아래 참조).
    • (선택 사항) 사용 가능한 색상 중 하나를 선택하거나 특정 색상에 대한 Hex 값을 입력합니다.
  3. Create를 클릭합니다.

레이블을 생성한 후 편집하려면 연필 아이콘을 선택합니다.

레이블을 삭제하려면 Subscribe 버튼 옆에 있는 (⋮)을 클릭하고 Delete를 선택하거나 레이블을 편집할 때 Delete 버튼을 클릭합니다.

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

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

GitLab 13.6에 도입 : 프로젝트 레이블을 승격하면 해당 레이블의 ID가 유지되고 그룹 레이블로 변경됩니다. 이전에는 프로젝트 레이블을 승격하면 새 ID로 새 그룹 레이블이 생성되고 이전 레이블이 삭제되었습니다.

이전에 프로젝트 레이블을 만들었고 이제 동일한 그룹 내의 다른 프로젝트에서 사용할 수 있도록 하려면 그룹 레이블로 승격할 수 있습니다.

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

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

새 그룹 라벨에는 이전 프로젝트 라벨과 동일한 ID를 가집니다.

주의 : 레이블 승격은 영구적인 작업이며 되돌릴 수 없습니다.

프로젝트 라벨을 그룹 라벨로 승격하려면 :

  1. 프로젝트에서 Project information > Labels로 이동합니다.
  2. Subscribe 버튼 옆에 있는 세 개의 점(⋮)을 클릭하고 Promote to group label을 선택합니다.

그룹 레이블​

그룹 레이블 목록을 보려면, 그룹으로 이동하여 Group information > Labels을 클릭합니다. 목록에는 그룹 수준에서 정의된 모든 레이블만 포함되고 프로젝트에 정의된 레이블은 나열되지 않습니다. 상단에 검색어를 입력하고 검색 아이콘을 클릭하면 목록을 필터링할 수 있습니다.

그룹 레이블을 생성하려면, 그룹에서 Group information > Labels로 이동하고 프로젝트 레이블을 생성하는 것과 동일한 프로세스를 따릅니다.

GitLab 원문 보기