하위 항목은 상위 작업 항목 아래에 중첩된 작업 항목입니다. 이를 통해 작업을 구성하고 추적하는 계층 구조를 만들 수 있습니다.

하위 항목은 다음과 같을 수 있습니다:

• 상위 에픽 아래에 중첩된 하위 에픽.

• 에픽에 할당된 기능이나 버그와 같은 이슈.

• 이슈의 하위 항목이 될 수 있는 태스크.

상위 에픽
|─ 하위 에픽
   |─ 이슈
      |- 태스크
   |─ 이슈
      |- 태스크
   |─ 이슈

하위 항목을 사용하면 여러 계획 및 조율 과제를 해결할 수 있습니다.

다음 예시는 하위 항목이 팀이 더욱 효과적으로 협업하는 데 어떻게 도움이 되는지 보여줍니다.

상위 작업 항목에 할당된 모든 하위 항목 보기#

Child items 섹션에서 에픽에 할당된 에픽, 이슈, 태스크를 확인할 수 있습니다.

하위 항목에서 상속된 에픽, 이슈, 태스크도 확인할 수 있습니다.

목록에는 사용자가 접근할 수 있는 에픽, 이슈, 태스크만 표시됩니다.

에픽에 할당된 이슈가 그룹의 하위 프로젝트에 있는 경우 해당 이슈를 볼 수 있습니다. 프로젝트의 공개 여부 설정이 상위 그룹과 동일하거나 덜 제한적이어야 하기 때문입니다.

작업 항목 진행 상황 추적#

다양한 기준을 사용하여 작업 항목의 진행 상황을 추적할 수 있습니다.

에픽의 이슈 수 및 가중치 보기#

에픽의 Child items 섹션 헤더에는 하위 작업 항목의 수와 총 가중치가 표시됩니다. 태스크 가중치는 이슈 총 가중치에 포함됩니다.

열린 항목과 닫힌 항목의 수를 확인하려면 섹션 헤더 또는 각 에픽 이름 아래의 총 개수 위에 커서를 올리세요.

이 수치는 사용자가 볼 권한이 없는 항목을 포함하여 에픽과 관련된 모든 하위 작업 항목을 반영합니다.

에픽 진행 상황 보기#

히스토리

• GitLab 17.1에서 도입됨.

에픽의 Child items 섹션 헤더에 에픽 진행 상황 백분율이 표시됩니다.

하위 항목의 완료된 가중치와 총 가중치를 확인하려면 섹션 헤더에서 백분율 위에 커서를 올리세요.

태스크는 하위 이슈 백분율의 일부로 진행 상황 백분율에 포함됩니다.

가중치와 진행 상황은 사용자가 볼 권한이 없는 이슈를 포함하여 에픽과 관련된 모든 이슈를 반영합니다.

하위 항목 추가#

다음 작업을 수행할 수 있습니다:

• 다른 그룹 계층의 프로젝트에 있는 작업 항목을 포함하여 기존 작업 항목을 하위 항목으로 추가.

• 하위 항목으로 자동 추가되는 새 작업 항목 생성.

에픽에 이슈 추가#

히스토리

• GitLab 17.1에서 하위 이슈 및 에픽의 최대 수가 5000개로 변경됨.

기존 이슈를 에픽에 추가하거나, 에픽에 자동으로 추가되는 새 이슈를 생성할 수 있습니다.

직접 하위 이슈 및 에픽의 최대 수는 5000개입니다.

에픽에 기존 이슈 추가#

에픽에 기존 이슈를 추가할 수 있으며, 다른 그룹 계층의 프로젝트에 있는 이슈도 추가할 수 있습니다.

새로 추가된 이슈는 Child items 섹션의 이슈 목록 맨 위에 나타납니다.

에픽에는 이슈 목록이 포함되며, 이슈는 최대 하나의 에픽의 하위 항목으로만 설정할 수 있습니다. 이미 에픽에 연결된 새 이슈를 추가하면, 해당 이슈는 현재 상위 에픽에서 자동으로 연결 해제됩니다.

사전 요구사항:

• 이슈의 프로젝트와 에픽의 그룹에 대해 Guest, Planner, Reporter, Developer, Maintainer, 또는 Owner 권한이 있어야 합니다.

에픽에 기존 이슈를 추가하려면:

• 에픽 페이지의 Child items 아래에서 Add를 선택합니다.

• Existing issue를 선택합니다.

• 다음 방법 중 하나를 사용하여 추가할 이슈를 확인합니다:

이슈의 링크를 붙여넣습니다.

• 이슈 제목의 일부를 입력하여 원하는 이슈를 검색한 다음, 원하는 결과를 선택합니다. 다른 그룹 계층의 이슈는 검색 결과에 나타나지 않습니다. 해당 이슈를 추가하려면 전체 URL을 입력하세요.

추가할 이슈가 여러 개인 경우, Space를 누르고 이 단계를 반복합니다.

• Add를 선택합니다.

에픽에서 이슈 생성#

에픽에서 이슈를 생성하면 에픽의 넓은 맥락에 집중하면서 작업을 더 작은 부분으로 나눌 수 있습니다.

에픽에서 새 이슈를 생성할 수 있는 것은 에픽의 그룹 또는 하위 그룹에 있는 프로젝트에서만 가능합니다. 에픽의 그룹과 공유된 프로젝트에서 새 이슈를 생성하려면, 먼저 프로젝트에서 직접 이슈를 생성한 다음, 에픽에 기존 이슈를 추가하세요.

사전 요구사항:

• 이슈의 프로젝트와 에픽의 그룹에 대해 Guest, Planner, Reporter, Developer, Maintainer, 또는 Owner 권한이 있어야 합니다.

에픽에서 이슈를 생성하려면:

• 에픽 페이지의 Child items 아래에서 Add를 선택합니다.

• Add a new issue를 선택합니다.

• Title 아래에 새 이슈의 제목을 입력합니다.

• Project 드롭다운 목록에서 이슈를 생성할 프로젝트를 선택합니다.

• Create issue를 선택합니다.

새 이슈가 에픽에 할당됩니다.

하위 항목 재구성#

하위 항목의 순서를 변경하고 계층 내에서 재구성할 수 있습니다.

에픽에 할당된 이슈 순서 변경#

새 이슈는 Child items 섹션의 목록 맨 위에 나타납니다. 이슈를 드래그하여 목록 순서를 변경할 수 있습니다.

사전 요구사항:

• 이슈의 프로젝트와 에픽의 그룹에 대해 Guest, Planner, Reporter, Developer, Maintainer, 또는 Owner 권한이 있어야 합니다.

에픽에 할당된 이슈의 순서를 변경하려면:

• Child items 섹션으로 이동합니다.

• 이슈를 원하는 순서로 드래그합니다.

에픽 간 이슈 이동#

새 이슈는 Child items 탭의 목록 맨 위에 나타납니다. 이슈를 한 에픽에서 다른 에픽으로 이동할 수 있습니다.

사전 요구사항:

• 이슈의 프로젝트와 에픽의 그룹에 대해 Guest, Planner, Reporter, Developer, Maintainer, 또는 Owner 권한이 있어야 합니다.

이슈를 다른 에픽으로 이동하려면:

• Child items 섹션으로 이동합니다.

• 이슈를 보이는 계층 내 원하는 상위 에픽으로 드래그합니다.

상위 이슈 이동 시 하위 항목 이동#

히스토리

• GitLab 16.9에서 move_issue_children이라는 플래그와 함께 도입됨. 기본적으로 비활성화되어 있음.

• GitLab 16.11에서 GitLab.com 및 GitLab Self-Managed에서 활성화됨.

• GitLab 17.3에서 일반적으로 사용 가능해짐. 기능 플래그 move_issue_children 제거됨.

이슈를 다른 프로젝트로 이동하면 모든 하위 항목도 타깃 프로젝트로 이동되며 이동된 이슈의 하위 항목으로 유지됩니다. 각 항목은 상위 항목과 동일한 방식으로 이동됩니다. 즉, 원래 프로젝트에서 닫히고 타깃 프로젝트에 복사됩니다.

에픽에서 이슈 제거#

에픽의 세부 정보 페이지에서 에픽의 이슈를 제거할 수 있습니다. 에픽에서 이슈를 제거하면 해당 이슈는 더 이상 이 에픽과 연결되지 않습니다.

사전 요구사항:

• 이슈의 프로젝트와 에픽의 그룹에 대해 Guest, Planner, Reporter, Developer, Maintainer, 또는 Owner 권한이 있어야 합니다.

에픽에서 이슈를 제거하려면:

• 제거할 이슈 옆에서 Remove ( close )를 선택합니다. Remove issue 경고가 나타납니다.

• Remove를 선택합니다.

다중 레벨 계층 구조 사용#

에픽은 여러 개의 중첩된 하위 에픽을 포함할 수 있습니다. 다음과 같은 방법으로 이 다중 레벨 하위 에픽을 사용할 수 있습니다:

• 기존 에픽에 상위 에픽을 추가하여 에픽 계층 구조를 만듭니다.

• 상위 에픽의 그룹과 다른 그룹에 속하는 하위 에픽을 추가합니다.

• 로드맵에서 에픽의 하위 에픽 및 관련 마일스톤을 봅니다.

• 에픽에서 하위 에픽을 추가, 이동, 순서 변경, 제거합니다.

에픽은 최대 7단계 깊이까지 여러 개의 중첩된 하위 에픽을 포함할 수 있습니다.

에픽에 상위 에픽 추가#

히스토리

• GitLab 17.5에서 도입됨.

에픽 계층 구조를 만들려면 기존 에픽에 상위 에픽을 추가합니다. 이를 통해 여러 에픽에 걸친 관련 작업을 구성하고 추적할 수 있습니다.

사전 요구사항:

• 상위 에픽의 그룹 또는 하위 에픽의 그룹에 대해 Guest, Planner, Reporter, Developer, Maintainer, 또는 Owner 권한이 있어야 합니다.

상위 에픽을 추가하려면:

• 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.

• Plan > Work items를 선택합니다.

• 에픽을 선택합니다.

• 오른쪽 사이드바의 Parent 섹션에서 Edit를 선택합니다.

• 검색 창에 상위 에픽 제목의 일부를 입력합니다. 동일한 그룹 계층의 에픽만 검색할 수 있습니다.

• 검색 결과에서 상위 에픽으로 추가할 에픽을 선택합니다.

상위 에픽이 추가됩니다.

다른 그룹의 하위 에픽#

상위 에픽의 그룹과 다른 그룹에 속하는 하위 에픽을 추가할 수 있습니다.

사전 요구사항:

• 하위 에픽과 상위 에픽의 그룹 모두에 대해 Guest, Planner, Reporter, Developer, Maintainer, 또는 Owner 권한이 있어야 합니다.

• 하위 에픽과 상위 에픽의 그룹 모두에서 다중 레벨 하위 에픽을 사용할 수 있어야 합니다.

다른 그룹의 하위 에픽을 추가하려면 기존 에픽 추가 시 에픽의 URL을 붙여넣습니다.

로드맵에서 하위 에픽 보기#

에픽에서 로드맵의 하위 에픽 및 관련 마일스톤을 볼 수 있습니다.

사전 요구사항:

• 상위 에픽의 그룹에 대해 Guest, Planner, Reporter, Developer, Maintainer, 또는 Owner 권한이 있어야 합니다.

상위 에픽에서 하위 에픽을 보려면:

• Child items 섹션 헤더에서 Display options ( preferences ) > View on a roadmap을 선택합니다.

에픽에 하위 에픽 추가#

사전 요구사항:

• 상위 에픽의 그룹에 대해 Guest, Planner, Reporter, Developer, Maintainer, 또는 Owner 권한이 있어야 합니다.

새 에픽#

새 에픽을 하위 에픽으로 추가하려면:

• 에픽의 Child items 섹션에서 Add > Add a new epic을 선택합니다.

• 드롭다운 목록에서 그룹을 선택합니다. 기본적으로 에픽의 그룹이 선택됩니다.

• 새 에픽의 제목을 입력합니다.

• Create epic을 선택합니다.

기존 에픽#

기존 에픽을 하위 에픽으로 추가하려면:

• 에픽의 Child items 섹션에서 Add > Existing epic을 선택합니다.

• 다음 방법 중 하나를 사용하여 추가할 에픽을 확인합니다:

에픽의 링크를 붙여넣습니다.

• 에픽 제목의 일부를 입력하여 원하는 에픽을 검색한 다음, 원하는 결과를 선택합니다. 이 검색은 동일한 그룹 계층의 에픽에 대해서만 사용할 수 있습니다.

추가할 에픽이 여러 개인 경우, Space를 누르고 이 단계를 반복합니다.

• Add를 선택합니다.

에픽 간 하위 에픽 이동#

새 하위 에픽은 Child items 섹션의 목록 맨 위에 나타납니다. 하위 에픽을 한 에픽에서 다른 에픽으로 이동할 수 있습니다. 이미 상위 에픽에 연결된 새 에픽을 추가하면 현재 상위 에픽과의 연결이 제거됩니다. 이슈와 하위 에픽을 혼합하여 사용할 수 없습니다.

사전 요구사항:

• 상위 에픽의 그룹에 대해 Guest, Planner, Reporter, Developer, Maintainer, 또는 Owner 권한이 있어야 합니다.

하위 에픽을 다른 에픽으로 이동하려면:

• Child items 섹션으로 이동합니다.

• 에픽을 원하는 상위 에픽으로 드래그합니다.

에픽에 할당된 하위 에픽 순서 변경#

새 하위 에픽은 Child items 섹션의 목록 맨 위에 나타납니다. 하위 에픽의 목록 순서를 변경할 수 있습니다.

사전 요구사항:

• 상위 에픽의 그룹에 대해 Guest, Planner, Reporter, Developer, Maintainer, 또는 Owner 권한이 있어야 합니다.

에픽에 할당된 하위 에픽의 순서를 변경하려면:

• Child items 섹션으로 이동합니다.

• 에픽을 원하는 순서로 드래그합니다.

상위 에픽에서 하위 에픽 제거#

사전 요구사항:

• 상위 에픽의 그룹에 대해 Guest, Planner, Reporter, Developer, Maintainer, 또는 Owner 권한이 있어야 합니다.

상위 에픽에서 하위 에픽을 제거하려면:

• 상위 에픽의 에픽 목록에서 Remove ( close )를 선택합니다. Remove epic 경고가 나타납니다.

• Remove를 선택합니다.

하위 항목 표시 설정 구성#

Child items 섹션에 표시되는 정보를 구성하여 워크플로에 가장 중요한 항목에 집중할 수 있습니다.

히스토리

• GitLab 18.10에서 하위 항목의 표시 옵션이 확장됨.

Child items 섹션에 표시되는 정보를 구성하여 워크플로에 가장 중요한 항목에 집중할 수 있습니다.

• Child items 섹션 헤더의 오른쪽 상단에서 Display options ( preferences )를 선택합니다.

기본적으로 모든 옵션과 필드가 표시됩니다.

• 표시되는 정보를 변경하려면 다음 토글을 켜거나 끕니다:

표시 옵션:

Show closed items

• 표시되는 필드:

Status

• Assignee

• Labels

• Weight

• Milestone

• Iteration

• Dates

• Health

• Blocked/Blocking

관련 항목#

• 에픽 관리

• 이슈 관리