- 에픽 생성
- 에픽 편집
- 대규모 에픽 일괄 편집
- 에픽 삭제하기
- 에픽 닫기
- 닫힌 에픽 다시 열기
- 이슈에서 에픽으로 이동
- 에픽 목록 보기
- 에픽 목록 필터링
- Epic 목록 정렬하기
- 활동 소트 순서 변경
- Epic을 비밀로 만들기
- Epic에 할당된 이슈 관리
- 다중 수준 하위 에픽
Epic 관리
이 페이지는 에픽 또는 그와 관련된 모든 작업에 대한 지침을 모았습니다.
에픽 생성
필수 조건:
- 에픽의 그룹에 적어도 기자 역할을 가져야 합니다.
현재 그룹에서 에픽을 생성하려면:
- 새로운 에픽 양식으로 이동합니다:
- 그룹으로 이동하여 왼쪽 사이드바에서 에픽을 선택합니다. 그런 다음 새 에픽을 선택합니다.
- 그룹 내의 에픽에서 에픽 작업 ()을 선택합니다. 그런 다음 새 에픽을 선택합니다.
- 어디서든 상단 메뉴에서 새로 만들기 ()를 선택합니다. 그런 다음 새 에픽을 선택합니다.
- 비어 있는 로드맵에서 새 에픽을 선택합니다.
- 제목을 입력합니다.
- 필드를 완성합니다.
- 에픽 생성을 선택합니다.
새로 생성된 에픽이 엽니다.
시작 및 마감 날짜 상속
상속을 선택하면:
- 시작 날짜에 대해: GitLab은 에픽에 할당된 모든 하위 에픽 및 이슈를 검색하여 시작 날짜를 하위 에픽 또는 이슈에 할당된 가장 빠른 시작 날짜와 일치하도록 설정합니다.
- 마감 날짜에 대해: GitLab은 에픽에 할당된 모든 하위 에픽 및 이슈를 검색하여 마감 날짜를 하위 에픽 또는 이슈에 할당된 가장 늦은 마감 날짜와 일치하도록 설정합니다.
이러한 날짜는 동적이며 다음 중 하나가 발생할 경우 다시 계산됩니다:
- 하위 에픽의 날짜가 변경됨.
- 이슈에 마일스톤이 다시 할당됨.
- 마일스톤의 날짜가 변경됨.
- 에픽에 이슈가 추가되거나 제거됨.
에픽의 날짜가 하위 항목에서 상속될 수 있기 때문에 시작 날짜와 마감 날짜가 아래에서 위로 전파됩니다. 가장 낮은 수준의 자식 에픽의 시작 날짜가 변경되면 해당 날짜가 상위 에픽의 가장 빠른 시작 날짜가 됩니다. 상위 에픽의 시작 날짜가 이 변경을 반영하고 최상위 에픽까지 전파됩니다.
에픽 색상
- GitLab 14.9에 도입됨 플래그인
epic_color_highlight로 비활성화됨.
epic_color_highlight라는 피쳐 플래그를 활성화해야 합니다.
GitLab.com에서는이 기능을 사용할 수 있지만 관리자만 구성할 수 있습니다.
GitLab Dedicated에서는 이 기능을 사용할 수 없습니다.
이 기능은 제품 사용 준비 상태가 아닙니다.에픽을 생성하거나 편집할 때 해당 색상을 선택할 수 있습니다. 에픽의 색상은 로드맵 및 에픽 보드에 표시됩니다.
에픽 편집
에픽을 생성한 후에 다음 세부 정보를 편집할 수 있습니다:
- 제목
- 설명
- 시작 날짜
- 마감 날짜
- 레이블
- 색상
필수 조건:
- 에픽의 그룹에 적어도 기자 역할을 가져야 합니다.
에픽의 제목 또는 설명을 편집하려면:
- 제목 및 설명 편집 을 선택합니다.
- 변경 사항을 가합니다.
- 변경 사항 저장을 선택합니다.
에픽의 시작 날짜, 마감 날짜 또는 레이블을 편집하려면:
- 오른쪽 사이드바의 각 섹션 옆에서 편집을 선택합니다.
- 에픽의 날짜 또는 레이블을 선택합니다.
에픽 설명의 목록 항목 재정렬
에픽을 보고 있는 경우 설명에 목록이 있는 경우 목록 항목도 재정렬할 수 있습니다.
필수 조건:
- 프로젝트에 적어도 기자 역할을 가지고 있거나, 에픽의 작성자이거나, 에픽에 할당되어 있어야 합니다.
- 에픽의 설명은 순서가 지정된, 순서가 지정되지 않은 또는 작업 목록이어야 합니다.
목록 항목을 재정렬하려면 에픽을 보고 있을 때:
- 목록 항목 행 위로 마우스를 올려서 그립 아이콘이 () 표시되도록 합니다.
- 그립 아이콘을 선택한 채로 들어서 새 위치로 항목을 끌어옵니다.
- 그립 아이콘을 놓습니다.
대규모 에픽 일괄 편집
리포터 역할을 적어도 가진 사용자는 에픽을 관리할 수 있습니다.
그룹에서 대규모로 에픽을 편집할 때 레이블을 편집할 수 있습니다.
전제 조건:
- 최소한 상위 에픽 그룹의 리포터 역할을 가져야 합니다.
동시에 여러 개의 에픽을 업데이트하려면:
- 그룹에서 에픽 > 목록으로 이동합니다.
- 대규모 편집을 선택합니다. 오른쪽에 편집 가능한 필드가 나타납니다.
- 편집하려는 각 에픽 옆의 확인란을 선택합니다.
- 측면 표시줄에서 적합한 필드와 그 값들을 선택합니다.
- 모두 업데이트를 선택합니다.
에픽 삭제하기
전제 조건:
- 에픽 그룹의 소유자 역할을 가져야 합니다.
에픽을 삭제하려면:
- 제목 및 설명 편집을 선택합니다 {연필}.
- 삭제를 선택합니다. 작업을 확인하라는 모달이 나타납니다.
에픽을 삭제하면 시스템에서 연결된 에픽의 모든 기존 이슈가 해제됩니다.
경고: 에픽을 삭제하면 해당 에픽의 모든 하위 에픽과 그 자손도 삭제됩니다. 필요하다면 삭제하기 전에 부모 에픽에서 하위 에픽 제거할 수 있습니다.
에픽 닫기
전제 조건:
- 에픽의 그룹에서 최소한 리포터 역할을 가져야 합니다.
에픽을 닫으려면, 오른쪽 상단에서 에픽 작업 ({엘립시스_세로})을 선택한 후 에픽 닫기를 선택합니다.
/close 빠른 조치도 사용할 수 있습니다.
닫힌 에픽 다시 열기
닫힌 에픽을 다시 열 수 있습니다.
전제 조건:
- 에픽의 그룹에서 최소한 리포터 역할을 가져야 합니다.
다음 중 하나를 수행하면 됩니다:
- 오른쪽 상단에서 에픽 작업 ({엘립시스_세로})을 선택한 후 에픽 다시 열기를 선택합니다.
-
/reopen빠른 조치도 사용할 수 있습니다.
또한 이슈를 에픽으로 승격할 수 있습니다.
이슈에서 에픽으로 이동
이슈가 에픽에 속하는 경우, 오른쪽 사이드바의 링크로 부모 에픽으로 이동할 수 있습니다.
에픽 목록 보기
그룹에서 왼쪽 사이드바에는 열린 에픽의 총 수가 표시됩니다. 이 숫자는 그룹 및 하위 그룹과 관련된 모든 에픽을 나타내며 보기 권한이 없을 수도 있습니다.
전제 조건:
- 다음 중 하나의 멤버여야 합니다:
- 그룹
- 그 그룹의 프로젝트
- 해당 그룹의 하위 그룹 중 하나의 프로젝트
그룹에서 에픽을 보려면:
- 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
- Plan > 에픽을 선택합니다.
에픽을 볼 수 있는 사용자
에픽을 볼 수 있는지 여부는 그룹 가시성 수준 및 에픽의 기밀 상태에 따라 달라집니다:
- 공개 그룹 및 비기밀 에픽: 누구나 에픽을 볼 수 있습니다.
- 비공개 그룹 및 비기밀 에픽: 해당 그룹에 대한 게스트 역할을 최소한 가져야 합니다.
- 기밀 에픽 (그룹 가시성 수준에 관계없이): 해당 그룹에 대한 리포터 역할을 최소한 가져야 합니다.
캐시된 에픽 수
- GitLab 13.11에 도입되었습니다. 기본적으로
cached_sidebar_open_epics_count라는 플래그가 있습니다.- GitLab 14.0에서 자체 관리 및 GitLab.com에 사용 중. 기능 플래그
cached_sidebar_open_epics_count이 제거되었습니다.
사이드바에 표시된 열린 에픽의 총 수는 1000보다 크면 캐시됩니다. 캐시된 값은 천 단위나 백만 단위로 반올림되며 매 24시간마다 업데이트됩니다.
에픽 목록 필터링
- 하위 에픽으로 필터링하는 것은 GitLab 13.0에서 도입되었습니다.
- 사용자 반응 이모지로 필터링하는 것은 GitLab 13.11에서 도입되었습니다.
- 에픽 제목으로 정렬하는 것은 GitLab 14.1에서 도입되었습니다.
- 마일스톤 및 기밀로 필터링하는 것은 GitLab 14.2에서 도입되었습니다. 사용은 기본적으로 비활성화된 기능 플래그
vue_epics_list가 있습니다.- GitLab 14.7에서 GitLab.com 및 자체 관리에서 사용되는 항목.
- 기능 플래그
vue_epics_list이 GitLab 14.8에서 제거되었습니다.- 그룹으로 필터링하는 것은 GitLab 15.9에서 도입되었습니다.
에픽 목록을 다음으로 필터링할 수 있습니다:
- 제목 또는 설명
- 작성자 이름 / 사용자명
- 레이블
- 마일스톤
- 기밀성
- 반응 이모지
- 그룹
필터링하려면:
- 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
- Plan > 에픽을 선택합니다.
- 검색 또는 결과 필터링 필드를 선택합니다.
- 드롭다운 목록에서 범위를 선택하거나 에픽 제목 또는 설명으로 검색하려면 일반 텍스트를 입력합니다.
- 키보드의 Enter를 누릅니다. 목록이 필터링됩니다.
OR 연산자로 필터링하기
- 라벨 및 작성자에 대한 OR 필터링이 GitLab 15.9에서 도입되었습니다.
or_issuable_queries라는 플래그와 함께 기본적으로 비활성화되어 있습니다.
플래그:
자체 호스팅된 GitLab의 경우, 기본적으로 이 기능을 사용할 수 없습니다.
사용하려면 관리자가 or_issuable_queries라는 피처 플래그를 활성화할 수 있습니다.
GitLab.com 및 전용 GitLab에서는 이 기능을 사용할 수 없습니다.
이 기능은 프로덕션 환경에서 사용할 준비가 되지 않았습니다.
이 기능을 활성화하면 OR 연산자인 (**|| **)를 사용하여 epic 목록을 필터링할 때:
- 작성자
- 라벨
is one of는 포괄적인 OR을 나타냅니다. 예를 들어, Label이 Deliverable 중 하나 및 Label이 UX 중 하나로 필터링하면 GitLab은 Deliverable, UX, 또는 두 라벨 중 하나 두 개가 있는 epic을 표시합니다.
Epic 목록 정렬하기
다음을 기준으로 epic 목록을 정렬할 수 있습니다:
- 시작 날짜
- 마감 날짜
- 제목
각 옵션에는 오름차순 및 내림차순 사이를 전환할 수 있는 버튼이 포함되어 있습니다. 정렬 옵션과 순서가 저장되어 epic 브라우징시 항상 사용됩니다. 로드맵을 포함하여 epic을 브라우징하는 모든 곳에 적용됩니다.
활동 소트 순서 변경
GitLab 13.2에서 도입.
기본 순서를 반전하여 활동 피드를 최신 항목이 상단에 오도록 정렬할 수 있습니다. 사용자 기본 설정은 로컬 저장소를 통해 저장되어 모든 epic 및 이슈에 자동으로 적용됩니다.
활동 소트 순서를 변경하려면 가장 오래된 항목 먼저 드롭다운 목록을 선택하고 가장 오래된 또는 가장 최신 항목 중 원하는 것을 선택하세요.
Epic을 비밀로 만들기
GitLab 13.0에서 피처 플래그를 통해 도입되었고 기본적으로 비활성화되어 있습니다. GitLab 13.2에서 기본적으로 활성화되었습니다. 그 후, GitLab 13.3 이후로는 epic 사이드바에서 비밀 유무 옵션을 사용할 수 있습니다.
만약 비밀 정보를 포함하는 항목에 작업 중이라면, Epic을 비밀로 만들 수 있습니다.
참고: 비밀로 표시된 Epic은 비밀 이슈와 비밀 유무로 생성된 하위 Epic만 포함할 수 있습니다. 그러나 생성된 경우, 머지 요청은 공개됩니다. 비밀 이슈를 생성하는 방법은 비밀 이슈에 대한 머지 요청를 확인하세요.
전제 조건:
- Epic 그룹의 기록을 보기 위해서는 적어도 Reporter 역할이 있어야 합니다.
Epic을 비밀로 만들려면 다음을 수행하세요:
- Epic을 생성할 때: Confidentiality 아래의 확인란을 선택합니다.
- 기존 Epic에서: 오른쪽 사이드바에서 비밀 유무 옆의 편집(Edit)을 선택하고 켜기를 선택합니다.
GitLab 15.6 이상에서는 /confidential 빠른 동작도 사용할 수 있습니다.
Epic에 할당된 이슈 관리
이 부분에서는 Epic과 관련하여 이슈로 할 수 있는 모든 작업에 대한 지침을 수집합니다.
Epic에 할당된 이슈 보기
하위 이슈 및 Epic 섹션에서 이 Epic에 할당된 Epic 및 이슈를 볼 수 있습니다. 액세스할 수 있는 Epic와 이슈만 목록에 표시됩니다.
그룹의 하위 프로젝트에 할당된 이슈를 항상 볼 수 있습니다. 이는 프로젝트의 가시성 설정이 부모 그룹과 동일하거나 제한적이어야 하기 때문에 가능합니다.
Epic에 할당된 이슈 수 보기
하위 이슈 및 Epic 섹션에서 각 Epic 이름 아래에 총 카운트 위로 마우스를 올리세요.
숫자는 프로젝트와 연관된 모든 Epic을 나타냅니다. 이 중에는 권한이 없는 이슈도 포함될 수 있습니다.
Epic에 새로운 이슈 추가
기존 이슈를 Epic에 추가하거나 Epic에 자동으로 추가되는 새로운 이슈를 생성할 수 있습니다.
기존 이슈를 Epic에 추가
프로젝트의 최소 요구 역할이 GitLab 15.8에서 리포터에서 게스트로 변경되었습니다(https://gitlab.com/gitlab-org/gitlab/-/issues/382506)로 변경되었습니다.
기존 이슈를 Epic에 추가할 수 있으며, 다른 그룹 계층 구조의 프로젝트에 있는 이슈를 포함하여 추가할 수 있습니다. 새로 추가된 이슈는 하위 이슈 및 Epic 섹션의 이슈 목록 상단에 표시됩니다.
Epic에는 이슈 목록이 포함되며, 이슈는 최대 한 개의 Epic과 연결될 수 있습니다. 이미 연결된 Epic에서 새 이슈를 추가하면 이슈는 현재 부모에서 자동으로 연결이 해제됩니다.
전제 조건:
- 이슈의 프로젝트 및 Epic의 그룹에 최소한 게스트 역할이 있어야 합니다.
기존 이슈를 Epic에 추가하려면 다음을 수행하세요:
- Epic 페이지에서 하위 이슈 및 Epic 아래의 추가를 선택합니다.
- 기존 이슈 추가를 선택합니다.
- 다음 중 하나의 방법으로 추가할 이슈를 식별합니다:
- 이슈의 링크를 붙여넣기합니다.
- 이슈의 제목 일부를 입력하여 원하는 항목을 선택하는 검색을 수행합니다. 서로 다른 그룹 계층 구조의 이슈는 검색 결과에 나타나지 않습니다. 그러한 이슈를 추가하려면 전체 URL을 입력하세요.
여러 이슈를 추가해야 한다면 Space를 누르고 이 단계를 반복하세요.
- 추가를 선택합니다.
에픽에서 이슈 생성하기
- 최소 요구 역할 변경 : GitLab 15.8에서 프로젝트에 대한 리포터 역할에서 게스트 역할로 변경되었습니다.
에픽에서 이슈를 생성하면 에픽의 더 넓은 맥락에 초점을 맞추면서 작업을 더 작은 부분으로 나눌 수 있습니다.
에픽에서만 에픽이 속한 그룹이나 하위 하위 그룹 중 하나에 있는 프로젝트에서만 새 이슈를 생성할 수 있습니다.
에픽에서 이슈를 생성하려면:
- 에픽 페이지에서 하위 이슈 및 에픽 아래에서 추가를 선택합니다.
- 새 이슈 추가를 선택합니다.
- 제목 아래에 새 이슈의 제목을 입력합니다.
- 프로젝트 드롭다운 목록에서 이슈를 생성해야 할 프로젝트를 선택합니다.
- 이슈 생성을 선택합니다.
새 이슈가 에픽에 할당됩니다.
에픽에서 이슈 제거하기
- 최소 요구 역할 변경 : GitLab 15.8에서 프로젝트에 대한 리포터 역할에서 게스트 역할로 변경되었습니다.
에픽의 세부 정보 페이지에 있을 때 이슈를 에픽에서 제거할 수 있습니다. 이슈를 에픽에서 제거한 후에는 해당 이슈가 이 에픽과 더 이상 연관되지 않습니다.
에픽에 할당된 이슈 목록
에픽에 할당된 이슈 재정렬하기
- 최소 요구 역할 변경 : GitLab 15.8에서 프로젝트에 대한 리포터 역할에서 게스트 역할로 변경되었습니다.
새 이슈는 하위 이슈 및 에픽 섹션의 목록 상단에 표시됩니다. 목록을 드래그하여 이슈의 순서를 변경할 수 있습니다.
에픽 사이 이슈 이동하기
새 이슈는 하위 이슈 및 에픽 탭의 목록 상단에 표시됩니다. 한 에픽에서 다른 에픽으로 이슈를 이동할 수 있습니다.
반복되는 이슈를 위한 에픽 템플릿 사용하기
에픽 템플릿을 사용하여 일관되게 반복되는 이슈의 패턴을 관리하는 스프레드시트 템플릿을 만들 수 있습니다.
에픽 템플릿에 대한 소개는 GitLab 에픽 및 에픽 템플릿 설명서에서 확인할 수 있습니다.
에픽 템플릿에 대한 자세한 정보는 에픽 템플릿 - 반복되는 이슈 세트에서 확인할 수 있습니다.
다중 수준 하위 에픽
상위 에픽의 그룹 또는 하위 그룹에 속하는 모든 에픽을 추가할 수 있습니다. 새로운 하위 에픽은 하위 이슈 및 에픽 섹션의 에픽 목록 상단에 표시됩니다.
현재 부모 에픽에 연결된 에픽을 추가하면 해당 에픽의 현재 부모 링크가 제거됩니다.
에픽에는 총 7단계까지의 중첩된 하위 에픽을 포함할 수 있습니다.
직접적인 하위 에픽의 최대 수는 100개입니다.
다른 그룹의 하위 Epic
-
Introduced in GitLab 15.6 with a flag named
child_epics_from_different_hierarchies. Disabled by default. - 그룹 내에서 롤이 최소 요구된 수준은 GitLab 15.7에서 기고자(Reporter)로부터 손님(Guest)로 변경되었습니다.
- Cross-group 하위 Epic은 GitLab 15.9에서 GitLab.com 및 자체 관리에서 활성화되었습니다. 기본적으로 활성화됩니다.
-
Feature flag
child_epics_from_different_hierarchies가 GitLab 15.10에서 제거되었습니다.
부모 Epic 그룹과 다른 그룹에 속하는 하위 Epic을 추가할 수 있습니다.
전제 조건:
- 적어도 기고자(Reporter) 및 상위 Epic 그룹의 Guest 역할을 가져야 합니다.
- 다단계 하위 Epic은 하위 및 상위 Epic 그룹 모두에서 사용 가능해야 합니다.
다른 그룹의 하위 Epic을 추가하려면 기존 Epic 추가 시 Epic의 URL을 붙여 넣으십시오.
Epic에 하위 Epic 추가
- 그룹 내에서 롤이 최소 요구된 수준은 GitLab 15.7에서 기고자(Reporter)로부터 손님(Guest)로 변경되었습니다.
전제 조건:
- 상위 Epic 그룹의 최소한 손님(Guest) 역할을 가져야 합니다.
하위 Epic을 추가하려면:
- Epic에서 하위 이슈 및 Epic 섹션에서 추가 > 새 Epic 추가를 선택합니다.
- 드롭다운 목록에서 그룹을 선택합니다. Epic의 그룹이 기본적으로 선택됩니다.
- 새 Epic의 제목을 입력합니다.
- Epic 만들기를 선택합니다.
기존 Epic을 하위 Epic으로 추가하려면:
- Epic에서 하위 이슈 및 Epic 섹션에서 추가 > 기존 Epic 추가를 선택합니다.
- Epic의 링크를 붙여넣습니다
- 원하는 이슈를 검색하여 추가하려면 Epic의 일부를 입력한 후 원하는 링크를 선택합니다. 이 검색은 동일한 그룹 계층 구조의 Epic에 대해서만 사용할 수 있습니다.
여러 Epic을 추가해야 하는 경우 Space를 누르고 이 단계를 반복합니다.
- 추가를 선택합니다.
Epic 간의 하위 Epic 이동
새로운 하위 Epic은 하위 이슈 및 Epic 섹션의 목록 맨 위에 나타납니다. 하위 Epic을 다른 Epic으로 이동할 수 있습니다. 현재 링크된 부모 Epic이 있는 새 Epic을 추가하면 현재 부모의 링크가 제거됩니다. 이슈 및 하위 Epic을 혼합해서 사용할 수 없습니다.
전제 조건:
- 상위 Epic 그룹에서 적어도 손님(Guest) 역할을 가져야 합니다.
하위 Epic을 다른 Epic으로 이동하려면:
- 하위 이슈 및 Epic 섹션으로 이동합니다.
- 원하는 부모 Epic으로 Epic을 끌어다 놓습니다.
Epic에 할당된 하위 Epic 재정렬
- 그룹 내에서 롤이 최소 요구된 수준은 GitLab 15.7에서 기고자(Reporter)로부터 손님(Guest)로 변경되었습니다.
새로운 하위 Epic은 하위 이슈 및 Epic 섹션의 목록 맨 위에 나타납니다. 하위 Epic 목록을 재정렬할 수 있습니다.
전제 조건:
- 상위 Epic 그룹에서 적어도 손님(Guest) 역할을 가져야 합니다.
Epic에 할당된 하위 Epic을 재정렬하려면:
- 하위 이슈 및 Epic 섹션으로 이동합니다.
- Epic을 원하는 순서로 끌어다 놓습니다.
부모 Epic에서 하위 Epic 제거
- 그룹 내에서 롤이 최소 요구된 수준은 GitLab 15.7에서 기고자(Reporter)로부터 손님(Guest)로 변경되었습니다.
전제 조건:
- 상위 Epic 그룹에서 적어도 손님(Guest) 역할을 가져야 합니다.
부모 Epic에서 하위 Epic을 제거하려면:
- 부모 Epic의 Epic 목록에서 제거()를 선택합니다. Epic 제거 경고가 나타납니다.
- 제거를 선택합니다.
도움말