GitLab의 이터레이션은 특정 기간 동안 처리할 이슈를 묶는 시간 제한 워크플로를 뜻하며, 그 기간은 보통 1~3주입니다.

팀은 이터레이션으로 속도와 변동성 지표를 추적할 수 있습니다. 같은 항목을 여러 기간에 걸쳐 동시에 추적하려면 이터레이션을 마일스톤과 함께 사용합니다. 그룹에서 여러 이터레이션 케이던스를 만들고 관리합니다.

예를 들어 다음과 같이 사용할 수 있습니다.

• 8~12주에 걸친 프로그램 증분에는 마일스톤을 사용합니다.
• 2주에 걸친 스프린트에는 이터레이션을 사용합니다.

GitLab에서 이터레이션은 마일스톤과 비슷하지만 다음과 같은 차이가 있습니다.

• 이터레이션은 그룹에서만 사용할 수 있습니다.
• 이터레이션은 이터레이션 케이던스로 묶입니다.
• 이터레이션에는 시작 날짜와 종료 날짜가 모두 필요합니다.
• 하나의 이터레이션 케이던스 안에서 이터레이션의 날짜 범위는 겹칠 수 없습니다.

이터레이션을 활용한 계획 워크플로#

이터레이션으로 고정된 기간 단위로 작업을 구성하고 추적할 수 있습니다. 다음 예시는 이터레이션이 팀의 일관된 배포 주기 유지에 어떻게 기여하는지 보여 줍니다.

스프린트 계획 및 실행#

이터레이션으로 고정된 기간 안에서 작업을 계획하고 실행하면 팀이 예측 가능한 배포 케이던스를 유지할 수 있습니다. 팀이 스프린트 단위로 일할 때 각 이터레이션은 작업 항목의 계획과 실행, 배포를 위한 명확한 타임박스를 제공합니다. 자세한 내용은 GitLab으로 스크럼을 진행하는 튜토리얼을 참고합니다.

예를 들어 2주 스프린트를 운영하는 팀은 여러 작업 흐름을 함께 조율해야 하는 경우가 많습니다. 개발 팀은 현재 스프린트의 구현 상황을 추적하고, 제품 관리자는 다음 스프린트를 위한 백로그 항목을 준비합니다.

이터레이션을 사용하면 다음과 같은 이점이 있습니다.

• 팀이 전체 스프린트 일정을 한눈에 확인할 수 있습니다.
• 작업이 스프린트 사이에서 자동으로 이월됩니다.
• 이해관계자가 번다운 차트로 스프린트 진행 상황을 추적할 수 있습니다.
• 팀이 여러 스프린트에 걸쳐 속도를 측정할 수 있습니다.

이 구조는 팀이 진행 상황에 대한 가시성을 유지하면서 작업을 일관되게 완료하는 데 기여합니다.

스프린트용으로 이터레이션을 설정하면 다음과 같이 동작합니다.

• 각 팀이 같은 이터레이션 케이던스로 작업합니다.
• 팀이 이터레이션 보고서에서 작업 상태를 확인할 수 있습니다.
• 스프린트 계획의 예측 가능성이 높아집니다.

빠른 개발 주기#

팀에 잦은 릴리스가 필요하다면 이터레이션으로 더 짧은 개발 주기를 운영합니다. 익스트림 프로그래밍(XP) 같은 방법론을 적용하는 팀은 1주 단위 이터레이션으로 빠른 피드백 루프를 유지할 수 있습니다.

예를 들어 변경을 빠르게 반영하는 팀은 한 이터레이션 안에서 프로덕션에 여러 번 배포하기도 합니다. 이 팀은 코드가 준비되는 대로 릴리스할 수 있는 유연성을 유지하면서 주간 이터레이션으로 작업을 추적합니다.

이터레이션을 사용하면 다음과 같은 이점이 있습니다.

• 팀이 구조화된 타임박스를 유지합니다.
• 개발 속도를 추적할 수 있습니다.
• 팀이 주간 지표를 근거로 계획을 조정할 수 있습니다.
• 이해관계자가 매주 구체적인 진행 상황을 확인할 수 있습니다.

이 방식은 팀이 애자일 실천과 체계적인 계획 사이에서 균형을 잡는 데 기여합니다.

빠른 주기에 이터레이션을 사용하면 다음과 같이 동작합니다.

• 작업이 명확한 주 단위 경계로 구성됩니다.
• 팀이 더 작은 단위로 진행 상황을 추적합니다.
• 릴리스 계획이 이터레이션 경계에 맞춰집니다.

이터레이션 케이던스#

이터레이션 케이던스는 이터레이션을 담는 컨테이너이며, 이터레이션 일정을 자동화하는 데 사용합니다. 1주, 2주, 3주, 4주마다 이터레이션을 자동으로 만들 수 있습니다. 미완료 이슈를 다음 이터레이션으로 자동 이월하도록 이터레이션 케이던스를 구성할 수도 있습니다.

이터레이션 케이던스 생성#

히스토리

• GitLab 17.7에서 최소 사용자 권한이 Reporter에서 Planner로 변경되었습니다.

사전 요구 사항:

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

이터레이션 케이던스를 만들려면 다음을 수행합니다.

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

2. 왼쪽 사이드바에서 Plan > Iterations를 선택합니다.

3. New iteration cadence를 선택합니다.

4. 이터레이션 케이던스의 제목과 설명을 입력합니다.

   이터레이션 케이던스를 직접 관리하려면 Enable automatic scheduling 체크박스를 선택 해제하고 다음 단계를 건너뜁니다.

5. 자동 일정 예약을 사용하려면 필수 필드를 입력합니다.

   • 이터레이션 케이던스의 자동화 시작 날짜를 선택합니다. 이터레이션은 시작 날짜와 같은 요일에 시작하도록 예약됩니다.
   • Duration 드롭다운 목록에서 각 이터레이션을 몇 주 동안 지속할지 선택합니다.
   • Upcoming iterations 드롭다운 목록에서 현재 이터레이션 외에 추가로 예약할 향후 이터레이션 수를 선택합니다.
   • 선택 사항. 미완료 이슈를 다음 이터레이션으로 옮기려면 Enable roll over 체크박스를 선택합니다. 현재 이터레이션이 끝나면 Automation Bot이 열려 있는 모든 이슈를 다음 이터레이션으로 옮깁니다. 이슈는 인스턴스 시간대(기본값 UTC)의 자정에 이동합니다. 관리자는 인스턴스 시간대를 변경할 수 있습니다.

6. Create cadence를 선택합니다. 케이던스 목록 페이지가 열립니다.

생성한 케이던스를 직접 관리하려면 이터레이션 수동 생성을 참고합니다.

이터레이션 목록 보기#

1. 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
2. 왼쪽 사이드바에서 Plan > Iterations를 선택합니다.

케이던스에 속한 모든 이터레이션을 날짜 내림차순으로 보려면 해당 이터레이션 케이던스를 선택합니다. 그 화면에서 새 이터레이션을 만들거나, 이터레이션을 선택해 자세한 내용을 확인할 수 있습니다.

이터레이션 케이던스 편집#

사전 요구 사항:

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

이터레이션 케이던스를 편집하려면 다음을 수행합니다.

1. 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
2. 왼쪽 사이드바에서 Plan > Iterations를 선택합니다.
3. 편집할 케이던스 오른쪽에서 세로 줄임표(⋮)를 선택한 다음 Edit cadence를 선택합니다.
4. 필드를 편집합니다.
   • 자동 일정 예약을 사용하는 상태에서 Automation start date를 편집할 때는 기존의 현재 이터레이션이나 지난 이터레이션과 겹치지 않는 새 시작 날짜를 지정해야 합니다.
   • Upcoming iterations 편집은 기존 데이터를 삭제하지 않습니다. 예를 들어 향후 이터레이션이 이미 10개 있는 상태에서 Upcoming iterations의 값을 2로 바꿔도 기존의 향후 이터레이션 8개는 삭제되지 않습니다.
5. Save changes를 선택합니다.

이터레이션 케이던스의 자동 일정 예약 켜기 및 끄기#

1. 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
2. 왼쪽 사이드바에서 Plan > Iterations를 선택합니다.
3. 자동 일정 예약을 켜거나 끌 케이던스 오른쪽에서 세로 줄임표 (⋮)를 선택한 다음 Edit cadence를 선택합니다.
4. Enable automatic scheduling 체크박스를 선택하거나 선택 해제합니다.
5. 자동 일정 예약을 켜는 경우 필수 필드인 Automation start date, Duration, Upcoming iterations를 입력합니다.
   • Automation start date에는 열려 있는 기존 이터레이션과 겹치지 않는 날짜를 지정할 수 있습니다. 향후 이터레이션이 있으면 자동 일정 예약이 선택한 기간에 맞도록 해당 이터레이션을 조정합니다.
6. Save changes를 선택합니다.

예시: 수동 이터레이션 케이던스에 자동 일정 예약 켜기#

오늘이 4월 15일 금요일이고, 수동 이터레이션 케이던스에 이터레이션이 세 개 있다고 가정합니다.

• 4월 4일 월요일 - 4월 8일 금요일(종료됨)
• 4월 12일 화요일 - 4월 15일 금요일(진행 중)
• 5월 3일 화요일 - 5월 6일 금요일(예정)

이 상황에서 선택할 수 있는 가장 빠른 Automation start date는 4월 16일 토요일입니다. 4월 15일은 진행 중인 이터레이션과 겹치기 때문입니다.

자동화 시작 날짜로 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 17.7에서 최소 사용자 권한이 Reporter에서 Planner로 변경되었습니다.

사전 요구 사항:

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

이터레이션 케이던스를 삭제하면 그 케이던스에 속한 이터레이션도 모두 삭제됩니다.

이터레이션 케이던스를 삭제하려면 다음을 수행합니다.

1. 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
2. 왼쪽 사이드바에서 Plan > Iterations를 선택합니다.
3. 삭제할 케이던스 오른쪽에서 세로 줄임표(⋮)를 선택한 다음 Delete cadence를 선택합니다.
4. Delete cadence를 선택합니다.

GitLab Automation Bot 사용자#

이터레이션 이월이 켜져 있으면 현재 이터레이션이 끝날 때 열려 있는 모든 이슈가 다음 이터레이션으로 이동합니다.

이터레이션 변경은 GitLab Automation Bot이라는 특수 사용자가 수행하며, 이슈의 시스템 노트에서 확인할 수 있습니다. 이 사용자는 청구 대상 사용자가 아니므로 라이선스 한도 계산에 포함되지 않습니다.

GitLab.com에서는 automation-bot1 사용자입니다.

이터레이션 수동 생성#

히스토리

• GitLab 17.7에서 최소 사용자 권한이 Reporter에서 Planner로 변경되었습니다.

이터레이션 케이던스에 자동 일정 예약이 켜져 있으면 이터레이션이 일정에 따라 생성됩니다. 이 옵션을 끄면 이터레이션을 직접 만들 수 있습니다.

사전 요구 사항:

• 그룹에 대한 Planner, Reporter, Developer, Maintainer 또는 Owner 권한이 있어야 합니다.
• 그룹에 이터레이션 케이던스가 하나 이상 있어야 하고, 해당 이터레이션 케이던스의 자동 일정 예약이 꺼져 있어야 합니다.

이터레이션을 만들려면 다음을 수행합니다.

1. 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
2. 왼쪽 사이드바에서 Plan > Iterations를 선택합니다.
3. 이터레이션을 만들 케이던스 오른쪽에서 세로 줄임표 (⋮)를 선택한 다음 Add iteration을 선택합니다.
4. 필드를 입력합니다.
5. Create iteration을 선택합니다. 이터레이션 세부 정보 페이지가 열립니다.

이터레이션 편집#

히스토리

• GitLab 17.7에서 최소 사용자 권한이 Reporter에서 Planner로 변경되었습니다.

사전 요구 사항:

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

이터레이션을 편집하려면 다음을 수행합니다.

1. 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
2. 왼쪽 사이드바에서 Plan > Iterations를 선택하고 이터레이션 케이던스를 선택합니다.
3. 편집할 이터레이션을 선택합니다. 이터레이션 세부 정보 페이지가 열립니다.
4. 오른쪽 위에서 세로 줄임표(⋮)를 선택한 다음 Edit를 선택합니다.
5. 다음 기준에 따라 필드를 편집합니다.
   • Title, Start date, Due date는 해당 이터레이션 케이던스의 자동 일정 예약이 꺼져 있을 때만 편집할 수 있습니다.
6. Save changes를 선택합니다.

이터레이션 삭제#

히스토리

• GitLab 17.7에서 최소 사용자 권한이 Reporter에서 Planner로 변경되었습니다.

사전 요구 사항:

• 그룹에 대한 Planner, Reporter, Developer, Maintainer 또는 Owner 권한이 있어야 합니다.
• 해당 이터레이션 케이던스의 자동 일정 예약이 꺼져 있어야 합니다.

이터레이션을 삭제하려면 다음을 수행합니다.

1. 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
2. 왼쪽 사이드바에서 Plan > Iterations를 선택하고 이터레이션 케이던스를 선택합니다.
3. 편집할 이터레이션을 선택합니다. 이터레이션 세부 정보 페이지가 열립니다.
4. 오른쪽 위에서 세로 줄임표(⋮)를 선택한 다음 Delete를 선택합니다.
5. Delete를 선택합니다.

이터레이션 보고서#

이터레이션 보고서를 확인하면 이터레이션의 진행 상황을 추적할 수 있습니다. 이터레이션 보고서에는 해당 이터레이션에 할당된 모든 이슈와 그 상태가 표시됩니다.

보고서에는 이터레이션의 전체 이슈 구성도 함께 표시됩니다. 열려 있는 이터레이션의 보고서에는 완료, 미착수, 진행 중 이슈의 요약이 표시됩니다. 종료된 이터레이션의 보고서에는 마감일까지 완료한 이슈의 총 개수가 표시됩니다.

이터레이션 보고서 보기#

이터레이션 보고서를 보려면 다음을 수행합니다.

1. 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
2. 왼쪽 사이드바에서 Plan > Iterations를 선택하고 이터레이션 케이던스를 선택합니다.
3. 이터레이션을 선택합니다.

이터레이션 번다운 및 번업 차트#

이터레이션 보고서에는 번다운 및 번업 차트가 포함되며, 마일스톤을 볼 때와 같은 형태로 표시됩니다.

• 번다운 차트는 전체 범위의 완료 진행 상황을 추적하는 데 사용합니다.
• 번업 차트는 지정한 타임박스에서 추가되고 완료된 이슈의 일별 총 개수와 가중치를 추적합니다.

하위 그룹 또는 프로젝트 범위로 이터레이션 차트 보기#

그룹에 만든 이터레이션의 번다운 및 번업 차트는 그 그룹의 하위 그룹이나 프로젝트에서도 볼 수 있습니다. 이때 차트는 해당 하위 그룹 또는 프로젝트에 속한 이슈만 집계합니다.

예를 들어 어떤 그룹에 Project 1과 Project 2라는 프로젝트가 두 개 있다고 가정합니다. 각 프로젝트에는 그룹의 같은 이터레이션에 할당된 이슈가 하나씩 있습니다.

그룹에 대해 생성한 이터레이션 보고서에는 그룹의 모든 프로젝트 이슈 수가 표시됩니다.

• 완료: 2개 중 0개
• 미완료: 2개 중 0개
• 미착수: 2개 중 2개
• 번다운 차트 전체 이슈: 2개
• 번업 차트 전체 이슈: 2개

Project 1에 대해 생성한 이터레이션 보고서에는 이 프로젝트에 속한 이슈만 표시됩니다.

• 완료: 1개 중 0개
• 미완료: 1개 중 0개
• 미착수: 1개 중 1개
• 번다운 차트 전체 이슈: 1개
• 번업 차트 전체 이슈: 1개

레이블별 이슈 그룹화#

이슈 목록을 레이블별로 묶으면 팀이 담당하는 이슈를 확인하고, 각 레이블에 해당하는 범위를 더 정확하게 파악할 수 있습니다.

이슈를 레이블별로 묶으려면 다음을 수행합니다.

1. 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
2. 왼쪽 사이드바에서 Plan > Iterations를 선택하고 이터레이션 케이던스를 선택합니다.
3. 이터레이션을 선택합니다.
4. Group by 드롭다운 목록에서 Label을 선택합니다.
5. Filter by label 드롭다운 목록에서 그룹화 기준으로 사용할 레이블을 선택합니다.
6. 레이블 드롭다운 목록 바깥의 아무 영역이나 선택합니다. 이제 선택한 레이블을 기준으로 페이지가 묶여 표시됩니다.

관련 주제#

• 이터레이션에 이슈 추가
• 튜토리얼: GitLab으로 애자일 이터레이션 운영하기