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

하위 항목은 다음 중 하나일 수 있습니다:

• 상위 에픽 아래에 중첩된 하위 에픽입니다.
• 에픽에 할당된 기능이나 버그와 같은 이슈입니다.
• 이슈의 하위 항목이 될 수 있는 태스크입니다.

Parent epic
|─ Child epic
   |─ Issue
      |- Task
   |─ Issue
      |- Task
   |─ Issue

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

다음 예시는 하위 항목이 팀의 협업에 어떻게 도움이 되는지 보여 줍니다.

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

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

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

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

에픽에 할당된 이슈가 그룹의 하위 프로젝트에 있으면 해당 이슈를 볼 수 있습니다. 프로젝트의 공개 범위 설정은 상위 그룹과 같거나 그보다 덜 제한적이어야 하기 때문입니다.

작업 항목 진행 상황 추적#

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

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

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

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

이 수치는 볼 권한이 없는 항목을 포함하여 에픽과 연결된 모든 하위 작업 항목을 반영합니다.

에픽 진행 상황 보기#

히스토리

• GitLab 17.1에서 도입되었습니다.

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

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

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

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

하위 항목 추가#

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

• 다른 그룹 계층의 프로젝트에 있는 작업 항목을 포함하여 기존 작업 항목을 하위 항목으로 추가합니다.
• 하위 항목으로 자동 추가되는 새 작업 항목을 생성합니다.

에픽에 이슈 추가#

히스토리

• 하위 이슈와 에픽의 최대 개수가 GitLab 17.1에서 5000개로 변경되었습니다.

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

직접 연결되는 하위 이슈와 에픽의 최대 개수는 5000개입니다.

에픽에 기존 이슈 추가#

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

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

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

사전 요구 사항:

• 이슈가 속한 프로젝트에 대해 Guest, Planner, Reporter, Developer, Maintainer, Owner 권한 중 하나가 있어야 합니다.
• 에픽을 볼 권한이 있어야 합니다. 에픽이 속한 그룹의 권한은 필요하지 않습니다. 에픽이 속한 그룹이나 그 하위 그룹에 있는 프로젝트의 멤버이면 충분합니다.

에픽에 기존 이슈를 추가하려면 다음을 수행합니다.

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

2. Existing issue를 선택합니다.

3. 다음 방법 중 하나로 추가할 이슈를 지정합니다:

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

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

4. Add를 선택합니다.

에픽에서 이슈 생성#

에픽에서 이슈를 생성하면 작업을 더 작은 단위로 나누면서도 에픽의 넓은 컨텍스트에 집중할 수 있습니다.

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

사전 요구 사항:

• 이슈가 속한 프로젝트와 에픽이 속한 그룹에 대해 Guest, Planner, Reporter, Developer, Maintainer, Owner 권한 중 하나가 있어야 합니다.

에픽에서 이슈를 생성하려면 다음을 수행합니다.

1. 에픽 페이지의 Child items 아래에서 Add를 선택합니다.
2. Add a new issue를 선택합니다.
3. Title 아래에 새 이슈의 제목을 입력합니다.
4. Project 드롭다운 목록에서 이슈를 생성할 프로젝트를 선택합니다.
5. Create issue를 선택합니다.

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

하위 항목 재구성#

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

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

새 이슈는 Child items 섹션 목록의 맨 위에 표시됩니다. 이슈를 끌어서 이슈 목록의 순서를 변경할 수 있습니다.

사전 요구 사항:

• 이슈가 속한 프로젝트와 에픽이 속한 그룹에 대해 Guest, Planner, Reporter, Developer, Maintainer, Owner 권한 중 하나가 있어야 합니다.

에픽에 할당된 이슈의 순서를 변경하려면 다음을 수행합니다.

1. Child items 섹션으로 이동합니다.
2. 이슈를 원하는 순서로 끌어다 놓습니다.

에픽 간 이슈 이동#

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

사전 요구 사항:

• 이슈가 속한 프로젝트와 에픽이 속한 그룹에 대해 Guest, Planner, Reporter, Developer, Maintainer, Owner 권한 중 하나가 있어야 합니다.

이슈를 다른 에픽으로 이동하려면 다음을 수행합니다.

1. Child items 섹션으로 이동합니다.
2. 표시된 계층 구조에서 원하는 상위 에픽으로 이슈를 끌어다 놓습니다.

상위 이슈를 이동할 때의 하위 항목 이동#

히스토리

• 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 권한 중 하나가 있어야 합니다.
• 에픽을 볼 권한이 있어야 합니다. 에픽이 속한 그룹의 권한은 필요하지 않습니다. 에픽이 속한 그룹이나 그 하위 그룹에 있는 프로젝트의 멤버이면 충분합니다.

에픽에서 이슈를 제거하려면 다음을 수행합니다.

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

다중 레벨 계층 구조 사용#

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

• 기존 에픽에 상위 에픽을 추가해 에픽 계층 구조를 생성합니다.
• 상위 에픽이 속한 그룹과 다른 그룹에 속한 하위 에픽을 추가합니다.
• 에픽의 하위 에픽과 관련 마일스톤을 로드맵에서 확인합니다.
• 에픽에서 하위 에픽을 추가, 이동, 순서 변경, 제거합니다.

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

에픽에 상위 에픽 추가#

히스토리

• GitLab 17.5에서 도입되었습니다.

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

사전 요구 사항:

• 상위 에픽이 속한 그룹이나 하위 에픽이 속한 그룹 중 한쪽에 대해 Guest, Planner, Reporter, Developer, Maintainer, Owner 권한 중 하나가 있어야 합니다.

상위 에픽을 추가하려면 다음을 수행합니다.

1. 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
2. Plan > Work items를 선택합니다.
3. 에픽을 선택합니다.
4. 오른쪽 사이드바의 Parent 섹션에서 Edit를 선택합니다.
5. 검색 상자에 상위 에픽 제목의 일부를 입력합니다. 같은 그룹 계층에 있는 에픽만 검색할 수 있습니다.
6. 검색 결과에서 상위로 추가할 에픽을 선택합니다.

상위 에픽이 추가됩니다.

다른 그룹의 하위 에픽#

상위 에픽이 속한 그룹과 다른 그룹에 속한 하위 에픽을 추가합니다.

사전 요구 사항:

• 하위 에픽과 상위 에픽이 속한 두 그룹 모두에 대해 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 권한 중 하나가 있어야 합니다.

새 에픽#

새 에픽을 하위 에픽으로 추가하려면 다음을 수행합니다.

1. 에픽의 Child items 섹션에서 Add > Add a new epic을 선택합니다.
2. 드롭다운 목록에서 그룹을 선택합니다. 기본적으로 해당 에픽의 그룹이 선택됩니다.
3. 새 에픽의 제목을 입력합니다.
4. Create epic을 선택합니다.

기존 에픽#

기존 에픽을 하위 에픽으로 추가하려면 다음을 수행합니다.

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

2. 다음 방법 중 하나로 추가할 에픽을 지정합니다:

   • 에픽의 링크를 붙여넣습니다.
   • 에픽 제목의 일부를 입력해 원하는 에픽을 검색한 다음 일치하는 항목을 선택합니다. 이 검색은 같은 그룹 계층에 있는 에픽에만 사용할 수 있습니다.

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

3. Add를 선택합니다.

에픽 간 하위 에픽 이동#

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

사전 요구 사항:

• 상위 에픽이 속한 그룹에 대해 Guest, Planner, Reporter, Developer, Maintainer, Owner 권한 중 하나가 있어야 합니다.

하위 에픽을 다른 에픽으로 이동하려면 다음을 수행합니다.

1. Child items 섹션으로 이동합니다.
2. 원하는 상위 에픽으로 에픽을 끌어다 놓습니다.

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

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

사전 요구 사항:

• 상위 에픽이 속한 그룹에 대해 Guest, Planner, Reporter, Developer, Maintainer, Owner 권한 중 하나가 있어야 합니다.

에픽에 할당된 하위 에픽의 순서를 변경하려면 다음을 수행합니다.

1. Child items 섹션으로 이동합니다.
2. 에픽을 원하는 순서로 끌어다 놓습니다.

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

사전 요구 사항:

• 상위 에픽이 속한 그룹에 대해 Guest, Planner, Reporter, Developer, Maintainer, Owner 권한 중 하나가 있어야 합니다.

상위 에픽에서 하위 에픽을 제거하려면 다음을 수행합니다.

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

하위 항목 표시 설정 구성#

Child items 섹션에 표시할 정보를 구성하면 워크플로에서 가장 중요한 내용에 집중할 수 있습니다.

히스토리

• 하위 항목의 표시 옵션이 GitLab 18.10에서 확장되었습니다.

Child items 섹션에 표시할 정보를 구성하면 워크플로에서 가장 중요한 내용에 집중할 수 있습니다.

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

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

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

   • 표시 옵션:
     • Show closed items
   • 표시되는 필드:
     • Status
     • Assignee
     • Labels
     • Weight
     • Milestone
     • Iteration
     • Dates
     • Health
     • Blocked/Blocking

관련 주제#

• 에픽 관리
• 이슈 관리