반복
GitLab에서의 반복은 특정 기간 동안 작업할 이슈를 그룹화하는 시간 상자(workflow)를 말합니다. 보통 1-3주 동안 지속됩니다.
팀은 반복을 사용하여 속도 및 변동성 지표를 추적할 수 있습니다. 동일한 항목을 여러 동시기간 동안 추적하려면 milestones와 함께 반복을 사용할 수 있습니다. 그룹 내에서 여러 반복 주기를 만들고 관리할 수 있습니다.
예를 들어, 다음과 같이 사용할 수 있습니다:
- 프로그램 증가에 대한 마일스톤, 8-12 주 동안 지속됩니다.
- 스프린트에 대한 반복, 2주 동안 지속됩니다.
GitLab에서 반복은 마일스톤과 유사하지만 몇 가지 차이가 있습니다:
- 반복은 그룹에서만 사용할 수 있습니다.
- 반복은 반복 주기에 그룹화됩니다.
- 반복에는 시작일과 종료일이 모두 필요합니다.
- 반복 날짜 범위는 반복 주기 내에서 중첩될 수 없습니다.
반복 주기
- GitLab 14.1에 도입되었습니다. 기본값은 사용되지 않는
iteration_cadences
라는 플래그로 설정되어 있습니다.- GitLab 15.0에서 변경: 모든 예정된 반복은 반복 주기 시작일자와 동일한 요일에 시작해야 합니다. 첫 반복이 시작된 후에는 반복 주기의 시작일을 편집할 수 없습니다.
- GitLab 15.0에서 GitLab.com 및 Self-managed에서 활성화됨.
- GitLab 15.4에서 변경: 반복 주기에 대한 새로운 자동화 시작 날짜를 선택할 수 있습니다. 앞으로의 반복은 변경된 시작일의 요일에 시작하도록 예약됩니다. 반복 주기는 자동 예약 기능을 끄는 방식으로 수동으로 관리할 수 있습니다.
- GitLab 15.5에서 일반 사용 가능. 기능 플래그
iteration_cadences
가 제거되었습니다.
반복 주기는 반복의 컨테이너로 사용되어 반복 스케줄링을 자동화하는 데 사용할 수 있습니다. 반복 주기를 사용하여 1주, 2주, 3주 또는 4주마다 반복을 자동으로 생성할 수 있습니다. 또한 반복 주기를 구성하여 완료되지 않은 이슈를 자동으로 다음 반복으로 롤오버할 수 있습니다.
반복 주기 생성
전제 조건:
- 그룹에 대한 최소한의 Reporter 역할이 있어야 합니다.
반복 주기를 만들려면:
- 좌측 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
- Plan > Iterations을 선택합니다.
- 새로운 반복 주기를 선택합니다.
-
반복 주기의 제목과 설명을 입력합니다.
반복 주기를 수동으로 관리하려면 자동 스케줄링 사용 확인란을 선택 해제하고 다음 단계를 건너 뜁니다.
- 자동 스케줄링을 사용하려면 필수 필드를 작성합니다.
- 반복 주기의 자동화 시작 날짜를 선택합니다. 반복은 시작일의 요일과 동일한 요일에 예약됩니다.
- 기간 드롭다운 목록에서 각 반복이 지속되어야 하는 주 수를 선택합니다.
- 다가오는 반복 드롭다운 목록에서 생성 및 유지할 예정인 다가오는 반복의 수를 선택합니다.
- 선택 사항. 미완료된 이슈를 다음 반복으로 이동하려면 롤오버 사용 확인란을 선택합니다. 현재 반복의 끝에서 자동화 봇이 모든 오픈된 이슈를 다음 반복으로 이동합니다. 이슈는 인스턴스의 기본 시간대(기본값은 UTC)에 자정에 이동됩니다. 관리자는 인스턴스 시간대를 변경할 수 있습니다.
- 주기 생성을 선택합니다. 주기 목록 페이지가 엽니다.
만들어진 주기를 수동으로 관리하려면 반복 주기 수동으로 만들기를 참조하세요.
반복 목록 보기
- 좌측 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
- Plan > Iterations을 선택합니다.
반복 주기에서 모든 반복을 날짜를 기준으로 내림차순으로 보려면 해당 반복 주기를 선택하세요. 여기서 새로운 반복을 만들거나 상세한 보기를 보려면 반복을 선택할 수 있습니다.
참고:
프로젝트에서 이슈 추적 기능이
꺼져 있으면,
반복 목록을 보려면 해당 URL으로 이동하십시오. 이를 위해 프로젝트 또는 그룹 URL에 /-/cadences
를 추가하십시오.
예: https://gitlab.com/gitlab-org/sample-data-templates/sample-gitlab-project/-/cadences
.
이슈 339009이 이를 개선하는 데 사용됩니다.
반복 주기 편집
전제 조건:
- 그룹에 대한 최소한의 Reporter 역할이 있어야 합니다.
반복 주기를 수정하려면:
- 좌측 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
- Plan > Iterations을 선택합니다.
- 수정하려는 주기 오른쪽에 있는 수직 엘리시스()를 선택한 다음 주기 편집을 선택합니다.
- 필드를 편집합니다.
- 자동 스케줄링을 사용하고 자동화 시작 날짜 필드를 편집하는 경우에는 기존 현재 또는 지난 반복과 겹치지 않는 새로운 시작일을 설정해야 합니다.
-
다가오는 반복을 편집하는 것은 파괴적인 조치가 아닙니다.
예를 들어, 십 개의 다가오는 반복이 이미 존재하면 다가오는 반복 아래의 숫자를
2
로 변경해도 여덟 개의 기존 다가오는 반복이 삭제되지 않습니다.
- 변경 사항 저장을 선택합니다.
반복 주기의 자동 스케줄링 켜고 끄기
- 좌측 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
- Plan > Iterations을 선택합니다.
- 자동 스케줄링을 켜거나 끄려는 주기의 오른쪽에 있는 수직 엘리시스()를 선택한 다음 주기 편집을 선택합니다.
- 자동 스케줄링 사용 확인란을 선택 또는 선택 해제합니다.
- 자동 스케줄링을 켜는 경우,
필수 필드 자동화 시작 날짜, 기간 및 다가오는 반복을 작성하세요.
- 자동화 시작 날짜에는 기존 개방된 반복과 겹치지 않는 날짜를 선택할 수 있습니다. 다가오는 반복이 있는 경우, 자동 스케줄링은 선택한 기간에 적합하도록 이를 적절하게 조정합니다.
- 변경 사항 저장을 선택합니다.
예시: 수동 이터레이션 주기용 자동 일정 설정 켜기
4월 15일 금요일이며, 수동 이터레이션 주기에 3개의 이터레이션이 있는 경우를 가정해 보겠습니다.
- 4월 4일(월) - 4월 8일(금) (종료)
- 4월 12일(화) - 4월 15일(금) (진행 중)
- 5월 3일(화) - 5월 6일(금) (예정)
이 시나리오에서 선택할 수 있는 가장 빠른 자동화 시작일은 4월 15일과 겹치기 때문에 여기서 선택할 수 있는 가장 빠른 날짜는 4월 16일 토요일입니다.
이 시나리오에서 매주 최대 2개의 다가오는 이터레이션까지 일정화하기 위해 자동 일정화 시작 날짜로 4월 18일(월)을 선택한다면, 전환 후 다음과 같은 이터레이션이 생깁니다.
- 4월 4일(월) - 4월 8일(금) (종료)
- 4월 12일(화) - 4월 15일(금) (진행 중)
- 4월 18일(월) - 4월 24일(일) (예정)
- 4월 25일(월) - 5월 1일(일) (예정)
기존의 다가오는 이터레이션 “4월 12일(화) - 4월 15일(금)”은 “4월 18일 - 4월 24일(일)”로 변경됩니다.
추가로 다가오는 이터레이션인 “4월 25일 - 5월 1일”은 최소한 두 개의 다가오는 이터레이션이 예정되어야 한다는 요구를 충족시키기 위해 예정됩니다.
이터레이션 주기 삭제
- 변경됨 : GitLab 15.0에서 최소 사용자 역할을 개발자에서 기고자로 변경하였습니다.
전제 조건:
- 그룹에 대해 기고자 역할이 적어도 있어야 합니다.
이터레이션 주기를 삭제하면 해당 주기의 모든 이터레이션이 삭제됩니다.
이터레이션 주기를 삭제하려면:
- 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
- 계획 > 이터레이션을 선택합니다.
- 삭제하려는 주기 오른쪽에 수직 탐점 ()을 선택한 후 주기 삭제를 선택합니다.
- 주기 삭제를 선택합니다.
GitLab Automation Bot 사용자
이터레이션 롤오버가 활성화되면 현재 이터레이션이 끝날 때 모든 열린 이슈가 다음 이터레이션으로 이동됩니다.
이터레이션은 특별한 GitLab Automation Bot 사용자에 의해 변경됩니다. 이를 이슈의 시스템 노트에서 볼 수 있습니다. 이 사용자는 과금 대상 사용자가 아니므로 라이센스 제한을 계산할 때 고려되지 않습니다.
GitLab.com에서는 automation-bot1
사용자입니다.
수동으로 이터레이션 생성
- 변경됨 : GitLab 15.0에서 최소 사용자 역할을 개발자에서 기고자로 변경하였습니다.
이터레이션 주기에 자동 일정화가 활성화된 경우 일정에 따라 자동으로 이터레이션이 생성됩니다. 해당 옵션을 비활성화하면 이터레이션을 수동으로 생성할 수 있습니다.
전제 조건:
- 그룹에 대해 기고자 역할이 적어도 있어야 합니다.
- 그룹에 적어도 하나의 이터레이션 주기가 있어야 하며, 해당 이터레이션 주기에 대해 자동 일정화를 활성화하고 해제해야 합니다.
이터레이션을 만들려면:
- 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
- 계획 > 이터레이션을 선택합니다.
- 이터레이션을 만들고자 하는 주기 오른쪽에 수직 탐점 ()을 선택한 후 이터레이션 추가를 선택합니다.
- 필드를 완성합니다.
- 이터레이션 생성을 선택합니다. 이터레이션 세부 정보 페이지가 열립니다.
이터레이션 수정
- 변경됨 : GitLab 15.0에서 최소 사용자 역할을 개발자에서 기고자로 변경하였습니다.
전제 조건:
- 그룹에 대해 기고자 역할이 적어도 있어야 합니다.
이터레이션을 수정하려면:
- 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
- 계획 > 이터레이션을 선택하고 이터레이션 주기를 선택합니다.
- 편집하려는 이터레이션을 선택합니다. 이터레이션 세부 정보 페이지가 엽니다.
- 우측 상단에서 수직 탐점 ()을 선택한 후 편집을 선택합니다.
- 필드를 편집합니다:
- 이터레이션 주기에 대해 자동 일정화가 비활성화된 경우에는 제목, 시작 날짜, 마감 날짜만 편집할 수 있습니다.
- 변경 사항 저장을 선택합니다.
이터레이션 삭제
- 변경됨 : GitLab 15.0에서 최소 사용자 역할을 개발자에서 기고자로 변경하였습니다.
전제 조건:
- 그룹에 대해 기고자 역할이 적어도 있어야 합니다.
- 이터레이션 주기에 대해 자동 일정화가 비활성화되어 있어야 합니다.
이터레이션을 삭제하려면:
- 왼쪽 사이드바에서 검색 또는 이동를 선택하고 그룹을 찾습니다.
- 계획 > 이터레이션을 선택하고 이터레이션 주기를 선택합니다.
- 삭제하려는 이터레이션을 선택합니다. 이터레이션 세부 정보 페이지가 엽니다.
- 우측 상단에서 수직 탐점 ()을 선택한 후 삭제를 선택합니다.
- 삭제를 선택합니다.
이터레이션 보고서
이터레이션 보고서를 검토함으로써 이터레이션 진행 상황을 추적할 수 있습니다. 이터레이션 보고서는 해당 이터레이션에 할당된 모든 이슈와 이슈의 상태 목록을 표시합니다.
보고서에는 이터레이션의 총 이슈 수를 나타내는 분석도 표시됩니다. 진행 중인 이터레이션 보고서는 완료된 이슈, 시작되지 않은 이슈, 진행 중인 이슈의 요약을 표시합니다. 종료된 이터레이션 보고서는 마감일까지 완료된 이슈의 총 수를 보여줍니다.
이터레이션 보고서 보기
이터레이션 보고서를 보려면:
- 왼쪽 사이드바에서 검색 또는 이동를 선택하고 그룹을 찾습니다.
- 계획 > 이터레이션을 선택하고 이터레이션 주기를 선택합니다.
- 이터레이션을 선택합니다.
이터레이션 버다운 및 버나프 차트
이터레이션 보고서에는 버다운 및 버나프 차트가 포함되어 있습니다. 이는 마일스톤을 볼 때와 유사합니다.
- 버다운 차트는 총 범위의 완료 진행을 추적합니다.
- 버나프 차트는 주어진 시간 범위 내에 추가된 이슈의 일일 총 개수와 무게, 그리고 완료된 이슈를 추적합니다.
하위 그룹이나 프로젝트에 범위를 지정한 이터레이션 차트 보기
그룹 내의 하위 그룹이나 프로젝트에서 생성된 이터레이션의 번다운 및 번업 차트를 보실 수 있습니다. 이를 통해 차트는 해당 하위 그룹이나 프로젝트에 속한 이슈만을 계산합니다.
예를 들어, 그룹에 프로젝트 1
과 프로젝트 2
라는 두 개의 프로젝트가 있다고 가정해봅시다.
각 프로젝트에는 동일한 이터레이션에 할당된 단일 이슈가 있습니다.
그룹을 위해 생성된 이터레이션 보고서는 그룹의 모든 프로젝트에 대한 이슈 수를 보여줍니다:
- 완료됨: 2 중 0
- 미완료: 2 중 0
- 시작되지 않음: 2 중 2
- 번다운 차트 총 이슈: 2
- 번업 차트 총 이슈: 2
프로젝트 1
을 위해 생성된 이터레이션 보고서는 해당 프로젝트에 속한 이슈만을 보여줍니다:
- 완료됨: 1 중 0
- 미완료: 1 중 0
- 시작되지 않음: 1 중 1
- 번다운 차트 총 이슈: 1
- 번업 차트 총 이슈: 1
레이블로 이슈 그룹화
팀에 속한 이슈를 보고 각 레이블에 속한 범위를 더 정확하게 파악하려면 레이블로 이슈 목록을 그룹화하세요.
레이블로 이슈를 그룹화하려면:
- 왼쪽 사이드바에서 검색 또는 가기를 선택하여 그룹을 찾습니다.
- 계획 > 이터레이션을 선택하고 이터레이션 주기를 선택합니다.
- 이터레이션을 선택합니다.
- 그룹 기준 드롭다운 목록에서 레이블을 선택합니다.
- 레이블로 필터링 드롭다운 목록에서 그룹화하려는 레이블을 선택합니다.
- 레이블 드롭다운 목록 외의 지역을 클릭합니다. 페이지가 이제 선택한 레이블로 그룹화됩니다.