이 페이지에는 에픽으로 할 수 있는 모든 작업과 에픽과 관련하여 할 수 있는 모든 작업의 지침을 모아 두었습니다.

에픽의 하위 항목 관리에 대한 정보는 하위 항목을 참고합니다.

에픽 만들기#

히스토리

• GitLab 17.7에서 최소 사용자 권한이 Reporter에서 Planner로 변경됨.
• GitLab 18.2에서 에픽에 마일스톤을 할당하는 기능 도입됨.
• GitLab 18.11에서 에픽에 가중치를 할당하는 기능 도입됨.

사전 요구 사항:

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

현재 속한 그룹에서 에픽을 만들려면 다음을 수행합니다.

1. New Epic 양식으로 이동합니다.

   • 그룹으로 이동한 다음 왼쪽 사이드바에서 Work items를 선택합니다. 그런 다음 New item을 선택합니다.
   • 그룹의 에픽에서 오른쪽 상단 모서리의 More actions(⋮)를 선택합니다. 그런 다음 New related item을 선택합니다.
   • 어느 화면에서든 상단 메뉴에서 New([plus-square])를 선택합니다. 그런 다음 New work item을 선택합니다.
   • 비어 있는 로드맵에서 New work item을 선택합니다.

2. Type 드롭다운 목록에서 Epic이 아직 선택되지 않았다면 선택합니다.

3. 필드를 입력합니다.

   • 제목을 입력합니다.
   • 설명을 입력합니다.
   • 에픽을 기밀로 설정하려면 Turn on confidentiality 옆의 체크박스를 선택합니다.
   • 레이블을 선택합니다.
   • 시작 날짜와 종료 날짜를 선택하거나 상속받습니다.
   • 색상을 선택합니다.

4. Create epic을 선택합니다.

새로 만든 에픽이 열립니다.

시작 날짜 및 종료 날짜 상속#

Inherited를 선택하면 다음과 같이 동작합니다.

• 시작 날짜의 경우: GitLab은 에픽에 할당된 모든 하위 에픽과 이슈를 검사하여, 하위 에픽에서 찾은 가장 이른 시작 날짜 또는 하위 항목에 할당된 마일스톤의 시작 날짜와 일치하도록 시작 날짜를 설정합니다.
• 종료 날짜의 경우: GitLab은 에픽에 할당된 모든 하위 에픽과 이슈를 검사하여, 하위 에픽에서 찾은 가장 늦은 종료 날짜 또는 하위 항목에 할당된 마일스톤의 종료 날짜와 일치하도록 종료 날짜를 설정합니다.

이 날짜는 동적이며 다음 중 하나가 발생하면 다시 계산됩니다.

• 하위 에픽의 날짜가 변경됩니다.
• 마일스톤이 이슈에 다시 할당됩니다.
• 마일스톤의 날짜가 변경됩니다.
• 에픽에 이슈가 추가되거나 에픽에서 이슈가 제거됩니다.

에픽의 날짜는 하위 항목의 날짜를 상속할 수 있으므로, 시작 날짜와 종료 날짜는 아래에서 위로 전파됩니다. 가장 낮은 수준에 있는 하위 에픽의 시작 날짜가 변경되면, 그 날짜가 상위 에픽에서 가능한 가장 이른 시작 날짜가 됩니다. 그러면 상위 에픽의 시작 날짜가 이 변경을 반영하고 최상위 에픽까지 위로 전파됩니다.

에픽 편집#

히스토리

• GitLab 17.7에서 최소 사용자 권한이 Reporter에서 Planner로 변경됨.

에픽을 만든 후에는 다음 세부 정보를 편집할 수 있습니다.

• 제목
• 설명
• 시작 날짜
• 종료 날짜
• 레이블
• 마일스톤
• 색상

사전 요구 사항:

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

에픽의 제목이나 설명을 편집하려면 다음을 수행합니다.

1. Edit를 선택합니다.
2. 변경 사항을 적용합니다.
3. Save changes를 선택합니다.

에픽의 시작 날짜, 종료 날짜, 마일스톤 또는 레이블을 편집하려면 다음을 수행합니다.

1. 오른쪽 사이드바의 각 섹션 옆에서 Edit를 선택합니다.
2. 에픽의 날짜, 마일스톤 또는 레이블을 선택합니다.

에픽 설명에서 목록 항목 순서 변경#

히스토리

• GitLab 17.7에서 최소 사용자 권한이 Reporter에서 Planner로 변경됨.

설명에 목록이 있는 에픽을 볼 때는 목록 항목의 순서도 변경할 수 있습니다.

사전 요구 사항:

• 프로젝트에 대한 Planner, Reporter, Developer, Maintainer 또는 Owner 권한이 있거나, 에픽의 작성자이거나, 에픽에 할당된 사용자여야 합니다.
• 에픽 설명에 순서가 있는 목록, 순서가 없는 목록 또는 작업 목록이 있어야 합니다.

에픽을 보는 중에 목록 항목의 순서를 변경하려면 다음을 수행합니다.

1. 목록 항목 행에 마우스를 올려 그립 아이콘([grip])이 표시되게 합니다.
2. 그립 아이콘을 선택한 상태로 유지합니다.
3. 행을 목록의 새 위치로 드래그합니다.
4. 그립 아이콘을 놓습니다.

에픽 일괄 편집#

히스토리

• GitLab 17.7에서 최소 사용자 권한이 Reporter에서 Planner로 변경됨.
• GitLab 18.3에서 일괄 편집 속성이 더 추가됨.
• GitLab 18.5에서 Parent 속성에 대한 일괄 편집 지원 추가됨.

사전 요구 사항:

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

여러 에픽을 동시에 업데이트하려면 다음을 수행합니다.

1. 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
2. 왼쪽 사이드바에서 Plan > Work items를 선택한 다음 Type = Epic으로 필터링합니다.
3. Bulk edit를 선택합니다. 오른쪽에 편집할 수 있는 필드가 담긴 사이드바가 나타납니다.
4. 편집할 각 에픽 옆의 체크박스를 선택합니다.
5. 사이드바에서 사용할 수 있는 필드를 편집합니다.
6. Update selected를 선택합니다.

그룹에서 에픽을 일괄 편집할 때는 다음 속성을 편집할 수 있습니다.

• 상태(열림 또는 닫힘)
• 담당자
• 레이블
• 건강 상태
• 알림 구독
• 기밀성
• 마일스톤
• Parent

Read more로 설명 잘림 방지#

히스토리

• GitLab 17.10에서 도입됨.

에픽 설명이 길면 GitLab은 설명의 일부만 표시합니다. 전체 설명을 보려면 Read more를 선택해야 합니다. 이렇게 잘라서 표시하면 긴 텍스트를 스크롤하지 않고도 페이지의 다른 요소를 더 쉽게 찾을 수 있습니다.

설명을 잘라서 표시할지 여부를 변경하려면 다음을 수행합니다.

1. 에픽에서 오른쪽 상단 모서리의 More actions(⋮)를 선택합니다.
2. 원하는 설정에 따라 Truncate descriptions를 전환합니다.

이 설정은 저장되며 모든 이슈, 작업, 에픽, 목표, 핵심 결과에 적용됩니다.

오른쪽 사이드바 숨기기#

히스토리

• GitLab 17.10에서 도입됨.

공간이 충분하면 에픽 속성이 설명 오른쪽의 사이드바에 표시됩니다.

사이드바를 숨기고 설명 공간을 넓히려면 다음을 수행합니다.

1. 에픽에서 오른쪽 상단 모서리의 More actions(⋮)를 선택합니다.
2. Hide sidebar를 선택합니다.

이 설정은 저장되며 모든 이슈, 작업, 에픽, 목표, 핵심 결과에 적용됩니다.

사이드바를 다시 표시하려면 다음을 수행합니다.

• 앞의 단계를 반복하고 Show sidebar를 선택합니다.

담당자#

히스토리

• GitLab 17.4에서 work_items_beta라는 이름의 기능 플래그와 함께 도입됨. 기본적으로 비활성화. 이 기능은 베타 상태입니다.
• GitLab 18.2에서 정식 출시. work_items_beta 기능 플래그 뒤에서 벗어났습니다.

에픽은 한 명 이상의 사용자에게 할당할 수 있습니다.

담당자는 필요한 만큼 자주 변경할 수 있습니다. 담당자는 해당 에픽을 책임지는 사람이라는 개념입니다.

사용자가 그룹의 멤버가 아니면, 다른 그룹 멤버가 할당하는 경우에만 그 사용자에게 에픽을 할당할 수 있습니다.

에픽의 담당자 변경#

히스토리

• GitLab 17.7에서 최소 사용자 권한이 Reporter에서 Planner로 변경됨.

사전 요구 사항:

• 그룹에 대한 Planner, Reporter, Developer, Maintainer 또는 Owner 권한이 있어야 합니다.

에픽의 담당자를 변경하려면 다음을 수행합니다.

1. 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
2. 왼쪽 사이드바에서 Plan > Work items를 선택한 다음 Type = Epic으로 필터링합니다.
3. 에픽을 선택하여 엽니다.
4. 오른쪽 사이드바의 Assignees 섹션에서 Edit를 선택합니다.
5. 드롭다운 목록에서 담당자로 추가할 사용자를 선택합니다.
6. 드롭다운 목록 밖의 아무 영역이나 선택합니다.

페이지를 새로 고치지 않아도 담당자가 변경됩니다.

에픽 색상#

히스토리

• GitLab 17.5에서 사용자 지정 색상 도입됨.

에픽에 색상을 설정하여 작업을 시각적으로 분류하고 우선순위를 지정할 수 있습니다. 색상은 다음 용도로 사용합니다.

• 에픽을 팀이나 회사 이니셔티브와 연결합니다.
• 에픽 계층 구조의 수준을 표시합니다.
• 관련 에픽을 함께 묶습니다.

에픽 색상은 로드맵과 에픽 보드에서 확인할 수 있습니다.

로드맵에서는 타임라인 막대가 에픽의 색상과 일치합니다.

에픽 보드에서는 에픽 카드의 강조 영역에 색상이 표시됩니다.

에픽 색상 변경#

히스토리

• GitLab 17.7에서 최소 사용자 권한이 Reporter에서 Planner로 변경됨.

사전 요구 사항:

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

에픽의 색상을 변경하려면 다음을 수행합니다.

1. 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
2. 왼쪽 사이드바에서 Plan > Work items를 선택한 다음 Type = Epic으로 필터링합니다.
3. 에픽을 선택합니다.
4. 오른쪽 사이드바의 Color 섹션에서 Edit를 선택합니다.
5. 기존 색상을 선택하거나 RGB 또는 16진수 값을 입력합니다.
6. 대화 상자 밖의 아무 영역이나 선택합니다.

에픽의 색상이 업데이트됩니다.

에픽 삭제#

히스토리

• GitLab 17.7에서 Planner 권한으로 에픽을 삭제할 수 있도록 허용됨.

사전 요구 사항:

• 에픽이 속한 그룹에 대한 Planner 또는 Owner 권한이 있어야 합니다.

에픽을 삭제하려면 다음을 수행합니다.

1. 오른쪽 상단 모서리의 More actions(⋮)를 선택한 다음 Delete epic을 선택합니다.
2. Delete를 선택합니다. 확인 대화 상자에서 Delete epic을 선택합니다.

에픽을 삭제하면 시스템에서 기존 이슈가 모두 연결된 에픽에서 해제됩니다.

에픽 닫기#

히스토리

• GitLab 17.7에서 최소 사용자 권한이 Reporter에서 Planner로 변경됨.

사전 요구 사항:

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

에픽을 닫으려면 다음을 수행합니다.

• 오른쪽 상단 모서리의 More actions(⋮)를 선택한 다음 Close epic을 선택합니다.

/close 빠른 작업을 사용할 수도 있습니다.

닫힌 에픽 다시 열기#

히스토리

• GitLab 17.7에서 최소 사용자 권한이 Reporter에서 Planner로 변경됨.

닫힌 에픽은 다시 열 수 있습니다.

사전 요구 사항:

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

다음 중 하나를 수행합니다.

• 오른쪽 상단 모서리의 More actions(⋮)를 선택한 다음 Reopen epic을 선택합니다.
• /reopen 빠른 작업을 사용합니다.

이슈를 에픽으로 승격하는 방식으로도 에픽을 만들 수 있습니다.

이슈에서 에픽으로 이동#

이슈가 에픽에 속해 있으면 다음에서 상위 에픽으로 이동할 수 있습니다.

• 이슈 상단의 이동 경로
• 오른쪽 사이드바의 Parent 섹션

에픽 목록 보기#

사전 요구 사항:

• 다음 중 하나의 멤버여야 합니다.
  • 그룹
  • 그룹에 속한 프로젝트
  • 그룹의 하위 그룹에 속한 프로젝트

그룹에서 에픽을 보려면 다음을 수행합니다.

1. 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
2. 왼쪽 사이드바에서 Plan > Work items를 선택한 다음 Type = Epic으로 필터링합니다.

에픽 목록에서 에픽에 어떤 속성을 표시할지 설정하려면 목록 표시 환경 설정 구성을 참고합니다.

에픽을 볼 수 있는 사용자#

히스토리

• GitLab 17.7에서 최소 사용자 권한이 Reporter에서 Planner로 변경됨.

에픽을 볼 수 있는지 여부는 그룹 가시성 수준과 에픽의 기밀성 상태에 따라 달라집니다.

• 공개 그룹의 기밀이 아닌 에픽: 누구나 에픽을 볼 수 있습니다.
• 비공개 그룹의 기밀이 아닌 에픽: 그룹에 대한 Guest, Planner, Reporter, Developer, Maintainer 또는 Owner 권한이 있거나, 그룹 또는 그 하위 그룹에 속한 프로젝트의 멤버여야 합니다.
• 기밀 에픽(그룹 가시성과 무관): 그룹에 대해 최소한 Planner 권한이 있어야 합니다.

에픽을 볼 수 있는 권한은 그 하위 항목을 볼 수 있는 권한과 같지 않습니다. Child items 섹션에는 볼 권한이 있는 항목만 표시됩니다. 항목 수와 진행률에는 볼 수 없는 항목도 포함됩니다. 자세한 내용은 에픽의 이슈 수와 가중치 보기를 참고합니다.

드로어에서 에픽 열기#

히스토리

• GitLab 17.4에서 work_item_view_for_issues라는 이름의 기능 플래그와 함께 도입됨. 기본적으로 활성화.
• GitLab 18.2에서 드로어와 전체 페이지 보기 사이의 전환 도입됨.
• GitLab 18.6에서 정식 출시. 기능 플래그 epics_list_drawer가 제거되었습니다.

작업 항목 페이지나 에픽 보드에서 에픽을 선택하면 세부 정보 패널에서 열립니다. 그러면 에픽 목록이나 보드의 컨텍스트를 잃지 않고 세부 정보를 보고 편집할 수 있습니다.

드로어를 사용할 때는 다음과 같이 동작합니다.

• 목록에서 에픽을 선택하면 드로어에서 열립니다.
• 드로어는 화면 오른쪽에 나타납니다.
• 드로어에서 에픽을 바로 편집할 수 있습니다.
• 드로어를 닫으려면 닫기 아이콘(✗)을 선택하거나 Escape 키를 누릅니다.

전체 페이지 보기로 에픽 열기#

전체 페이지 보기로 에픽을 열려면 다음을 수행합니다.

• 새 탭에서 에픽을 엽니다. 작업 항목 목록에서 다음 중 하나를 수행합니다.
  • 에픽을 마우스 오른쪽 버튼으로 클릭하여 새 브라우저 탭에서 엽니다.
  • Command 또는 Control을 누른 상태에서 에픽을 선택합니다.
• 에픽을 선택한 다음 드로어에서 다음 중 하나를 수행합니다.
  • 왼쪽 상단 모서리에서 이슈 참조를 선택합니다. 예를 들면 my_project#123입니다.
  • 오른쪽 상단 모서리에서 Open in full page([maximize])를 선택합니다.

작업 항목을 항상 전체 페이지 보기로 열려면 항목을 드로어에서 열지 여부 설정을 참고합니다.

에픽 목록 필터링#

히스토리

• GitLab 17.11에서 사용자 지정 필드로 필터링하는 기능 도입됨.

다음 기준으로 에픽 목록을 필터링할 수 있습니다.

• 제목 또는 설명(Search within 선택)
• 작성자 이름 / 사용자 이름
• 기밀성
• 그룹
• 건강 상태
• 레이블
• 마일스톤
• 반응 이모지
• 상위 항목
• 구독 여부
• 에픽에 활성화된 사용자 지정 필드

필터링하려면 다음을 수행합니다.

1. 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
2. 왼쪽 사이드바에서 Plan > Work items를 선택한 다음 Type = Epic으로 필터링합니다.
3. 필요에 따라 추가 필터, 연산자, 값을 선택합니다. 제목이나 설명으로 검색하려면 필터 바에 입력합니다.
4. Enter를 누르거나 돋보기 아이콘(🔍)을 선택합니다.

OR 연산자로 필터링#

히스토리

• GitLab 15.9에서 레이블과 작성자에 대한 OR 필터링이 or_issuable_queries라는 이름의 기능 플래그와 함께 도입됨. 기본적으로 비활성화.
• GitLab 15.9에서 GitLab.com과 GitLab Self-Managed에서 활성화됨.
• GitLab 17.0에서 정식 출시. 기능 플래그 or_issuable_queries가 제거되었습니다.

에픽 목록을 필터링할 때 다음 항목에는 OR 연산자(is one of: ||)를 사용할 수 있습니다.

• 담당자
• 작성자
• 레이블

is one of는 포함적 OR를 의미합니다. 예를 들어 Label is one of Deliverable과 Label is one of UX로 필터링하면 GitLab은 Deliverable 레이블이 있는 에픽, UX 레이블이 있는 에픽, 두 레이블이 모두 있는 에픽을 표시합니다.

에픽 목록 정렬#

다음 기준으로 에픽 목록을 정렬할 수 있습니다.

• 생성 날짜
• 업데이트 날짜
• 닫힌 날짜
• 마일스톤 종료 날짜
• 종료 날짜
• 인기도
• 제목
• 시작 날짜
• 건강 상태
• 차단 여부

각 옵션에는 순서를 Ascending과 Descending 사이에서 전환하는 버튼이 있습니다. 정렬 옵션과 순서는 저장되어 로드맵을 포함해 에픽을 탐색하는 모든 곳에서 사용됩니다.

활동 정렬 순서 변경#

기본 순서를 반대로 바꿔서 가장 최근 항목이 위에 오도록 정렬된 활동 피드를 사용할 수 있습니다. 이 환경 설정은 로컬 스토리지에 저장되어, 이후에 보는 모든 에픽과 이슈에 자동으로 적용됩니다.

활동 정렬 순서를 변경하려면 Oldest first 드롭다운 목록을 선택하고 가장 오래된 항목 또는 가장 최근 항목을 먼저 표시하도록 선택합니다.

에픽을 기밀로 설정#

히스토리

• GitLab 17.7에서 최소 사용자 권한이 Reporter에서 Planner로 변경됨.

비공개 정보가 포함된 항목을 다루는 경우 에픽을 기밀로 설정할 수 있습니다.

사전 요구 사항:

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

에픽을 기밀로 설정하려면 다음을 수행합니다.

• 에픽을 만들 때: Turn on confidentiality 옆의 체크박스를 선택합니다.
• 기존 에픽에서: 오른쪽 상단 모서리의 More actions(⋮)를 선택합니다. 그런 다음 Turn on confidentiality를 선택합니다.

/confidential 빠른 작업을 사용할 수도 있습니다.

에픽에 할당된 이슈 관리#

이 섹션에는 에픽과 관련하여 이슈로 할 수 있는 모든 작업의 지침을 모아 두었습니다.

건강 상태#

히스토리

• GitLab 17.5에서 도입됨.

에픽에 건강 상태를 사용하면 프로젝트 진행 상황을 빠르게 파악할 수 있습니다. 건강 상태는 잠재적인 문제를 미리 알리고 관리하는 데 도움이 됩니다.

에픽 화면과 Child items 및 Linked items 섹션에서 에픽의 건강 상태를 확인할 수 있습니다.

건강 상태는 다음 값으로 설정할 수 있습니다.

• On track(녹색)
• Needs attention(황색)
• At risk(적색)

계획한 작업을 제때 완료하지 못할 위험에 대응하려면 다음에 에픽 건강 상태 검토를 포함합니다.

• 일일 스탠드업 회의
• 프로젝트 상태 보고서
• 주간 회의

에픽의 건강 상태 변경#

히스토리

• GitLab 17.7에서 최소 사용자 권한이 Reporter에서 Planner로 변경됨.

사전 요구 사항:

• 그룹에 대한 Planner, Reporter, Developer, Maintainer 또는 Owner 권한이 있어야 합니다.

에픽의 건강 상태를 변경하려면 다음을 수행합니다.

1. 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
2. 왼쪽 사이드바에서 Plan > Work items를 선택한 다음 Type = Epic으로 필터링합니다.
3. 에픽을 선택합니다.
4. 오른쪽 사이드바의 Health status 섹션에서 Edit를 선택합니다.
5. 드롭다운 목록에서 상태를 선택합니다.

에픽의 건강 상태가 업데이트됩니다.

/health_status 및 /clear_health_status 빠른 작업으로 건강 상태를 설정하거나 지울 수도 있습니다.

참여자#

참여자는 에픽에 상호 작용한 사용자입니다. 참여자를 보는 방법에 대한 자세한 내용은 참여자를 참고합니다.

관련 주제#

• 연결된 항목
• 하위 항목
• 가중치