마일스톤
Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
마일스톤은 GitLab에서 작업을 추적하고 구성하는 데 도움이 됩니다. 마일스톤은 프로젝트 또는 그룹에 속할 수 있습니다. 프로젝트 및 그룹 마일스톤 API에 대한 정보는 다음을 참조하세요: 마일스톤은 릴리스를 추적하는 데 사용할 수 있습니다.
마일스톤은 GitLab에서 작업을 추적하고 구성하는 데 도움이 됩니다. 마일스톤은:
- 관련 이슈, 에픽 및 머지 리퀘스트를 그룹화하여 목표를 향한 진행 상황을 추적합니다.
- 선택적인 시작 날짜와 기한으로 시간 기반 계획을 지원합니다.
- 동시 타임박스를 추적하기 위해 이터레이션과 함께 작동합니다.
- 릴리스를 추적하고 릴리스 증거를 생성합니다.
- 프로젝트와 그룹에 적용됩니다.
마일스톤은 프로젝트 또는 그룹에 속할 수 있습니다. 프로젝트 마일스톤은 해당 프로젝트의 이슈와 머지 리퀘스트에만 적용됩니다. 그룹 마일스톤은 해당 그룹의 프로젝트에 있는 모든 이슈, 에픽 또는 머지 리퀘스트에 적용됩니다.
프로젝트 및 그룹 마일스톤 API에 대한 정보는 다음을 참조하세요:
릴리스로서의 마일스톤#
마일스톤은 릴리스를 추적하는 데 사용할 수 있습니다. 이를 위해:
- 마일스톤의 기한을 릴리스 날짜로 설정합니다. 릴리스 사이클의 시작 날짜가 정해지지 않은 경우 마일스톤 시작 날짜를 비워둘 수 있습니다.
- 마일스톤 제목을
Version 9.4와 같이 릴리스 버전으로 설정합니다. - 이슈의 오른쪽 사이드바에서 마일스톤을 선택하여 릴리스에 이슈를 추가합니다.
또한, 릴리스를 생성할 때 릴리스 증거를 자동으로 생성하려면 마일스톤을 릴리스 기능과 통합하세요.
프로젝트 마일스톤 및 그룹 마일스톤#
프로젝트 마일스톤은 해당 프로젝트의 이슈나 머지 리퀘스트에만 할당할 수 있습니다. 그룹 마일스톤은 해당 그룹의 모든 프로젝트에 있는 이슈, 에픽 또는 머지 리퀘스트에 할당할 수 있습니다.
프로젝트 및 그룹 마일스톤 API에 대한 정보는 다음을 참조하세요:
프로젝트 또는 그룹 마일스톤 보기#
마일스톤 목록을 보려면:
- 상단 바에서 Search or go to를 선택하고 프로젝트 또는 그룹을 찾습니다.
- 왼쪽 사이드바에서 Plan > Milestones를 선택합니다.
프로젝트에서는 GitLab이 해당 프로젝트에 속한 마일스톤을 표시합니다. 그룹에서는 GitLab이 해당 그룹과 그룹 내 모든 프로젝트 및 서브그룹에 속한 마일스톤을 표시합니다.
이슈가 꺼진 프로젝트에서 마일스톤 보기#
프로젝트에서 이슈 추적이 꺼진 경우, 마일스톤 페이지로 이동하려면 URL을 직접 입력합니다.
이를 위해:
- 프로젝트로 이동합니다.
- 프로젝트 URL에
/-/milestones를 추가합니다. 예:https://gitlab.com/gitlab-org/sample-data-templates/sample-gitlab-project/-/milestones.
또는 이 프로젝트의 이슈는 그룹의 마일스톤 페이지에서 볼 수 있습니다.
이 경험 개선은 이슈 339009에서 추적됩니다.
모든 마일스톤 보기#
전체 GitLab 네임스페이스에서 액세스할 수 있는 모든 마일스톤을 볼 수 있습니다. 멤버가 아닌 프로젝트나 그룹에 있는 마일스톤은 보이지 않을 수 있습니다.
이를 위해:
- 상단 바에서 Search or go to를 선택합니다.
- Your work를 선택합니다.
- 왼쪽 사이드바에서 Milestones를 선택합니다.
마일스톤 세부 정보 보기#
마일스톤에 대한 자세한 정보를 보려면, Milestones 페이지에서 보려는 마일스톤의 제목을 선택합니다.
마일스톤 보기에는 제목과 설명이 표시됩니다. 제목과 설명 아래의 탭에는 다음이 표시됩니다:
- Work Items: 마일스톤에 할당된 모든 작업 항목이 표시됩니다. 작업 항목은 세 열로 표시됩니다:
- Unstarted Issues (열려 있고 담당자 없음)
- Ongoing Issues (열려 있고 담당자 있음)
- Completed Issues (닫힘)
- Merge Requests: 마일스톤에 할당된 모든 머지 리퀘스트가 표시됩니다. 머지 리퀘스트는 네 열로 표시됩니다:
- Work in progress (열려 있고 담당자 없음)
- Waiting for merge (열려 있고 담당자 있음)
- Rejected (닫힘)
- Merged
- Participants: 마일스톤에 할당된 이슈의 모든 담당자가 표시됩니다.
- Labels: 마일스톤에 할당된 이슈에 사용된 모든 레이블이 표시됩니다.
번다운 차트#
마일스톤 보기에는 마일스톤 완료 진행 상황을 보여주는 번다운 및 번업 차트가 포함됩니다.
마일스톤 사이드바#
마일스톤 보기의 사이드바에는 다음이 표시됩니다:
- 완료 비율: 닫힌 작업 항목 수를 전체 작업 항목 수로 나눈 값으로 계산됩니다.
- 시작 날짜 및 기한.
- 마일스톤에 할당된 모든 작업 항목 및 머지 리퀘스트에 소요된 총 시간.
- 마일스톤에 할당된 모든 작업 항목의 총 이슈 가중치.
- 전체, 열림, 닫힘 및 머지된 머지 리퀘스트 수.
- 관련 릴리스 링크.
- 클립보드에 복사할 수 있는 마일스톤 참조.
마일스톤 생성#
히스토리
마일스톤은 프로젝트 또는 그룹에서 생성할 수 있습니다.
사전 요구 사항:
- 마일스톤이 속한 프로젝트 또는 그룹에 Planner, Reporter, Developer, Maintainer, 또는 Owner 권한이 있어야 합니다.
마일스톤을 생성하려면:
- 상단 바에서 Search or go to를 선택하고 프로젝트 또는 그룹을 찾습니다.
- 왼쪽 사이드바에서 Plan > Milestones를 선택합니다.
- New milestone을 선택합니다.
- 제목을 입력합니다.
- 선택 사항. 설명, 시작 날짜, 기한을 입력합니다.
- New milestone을 선택합니다.
마일스톤 제목 규칙#
그룹 계층 내에서 혼란을 방지하기 위해 중복 마일스톤 제목은 허용되지 않습니다.
- 프로젝트 마일스톤의 경우 제목은 프로젝트와 마일스톤 제목 모두에 대해 프로젝트의 상위 계층에서 고유해야 합니다.
- 그룹 마일스톤의 경우 제목은 그룹과 프로젝트 마일스톤을 포함하여 상위 및 하위 계층 모두에서 그룹의 계층 내에서 고유해야 합니다.
마일스톤 편집#
히스토리
사전 요구 사항:
- 마일스톤이 속한 프로젝트 또는 그룹에 Planner, Reporter, Developer, Maintainer, 또는 Owner 권한이 있어야 합니다.
마일스톤을 편집하려면:
- 상단 바에서 Search or go to를 선택하고 프로젝트 또는 그룹을 찾습니다.
- 왼쪽 사이드바에서 Plan > Milestones를 선택합니다.
- 마일스톤의 제목을 선택합니다.
- 오른쪽 상단에서 Milestone actions(⋮)를 선택한 후 Edit를 선택합니다.
- 제목, 시작 날짜, 기한, 또는 설명을 편집합니다.
- Save changes를 선택합니다.
마일스톤 닫기#
히스토리
- GitLab 17.7에서 최소 사용자 권한이 Reporter에서 Planner로 변경되었습니다.
마일스톤은 기한이 지난 후 닫힙니다. 마일스톤을 수동으로 닫을 수도 있습니다.
마일스톤이 닫히면 열려 있는 이슈는 그대로 유지됩니다.
사전 요구 사항:
- 마일스톤이 속한 프로젝트 또는 그룹에 Planner, Reporter, Developer, Maintainer, 또는 Owner 권한이 있어야 합니다.
마일스톤을 닫으려면:
- 상단 바에서 Search or go to를 선택하고 프로젝트 또는 그룹을 찾습니다.
- 왼쪽 사이드바에서 Plan > Milestones를 선택합니다.
- 다음 중 하나를 수행합니다:
- 닫으려는 마일스톤 옆에서 Milestone actions(⋮) > Close를 선택합니다.
- 마일스톤 제목을 선택한 후 Close를 선택합니다.
마일스톤 삭제#
히스토리
사전 요구 사항:
- 마일스톤이 속한 프로젝트 또는 그룹에 Planner, Reporter, Developer, Maintainer, 또는 Owner 권한이 있어야 합니다.
마일스톤을 삭제하려면:
- 상단 바에서 Search or go to를 선택하고 프로젝트 또는 그룹을 찾습니다.
- 왼쪽 사이드바에서 Plan > Milestones를 선택합니다.
- 다음 중 하나를 수행합니다:
- 삭제하려는 마일스톤 옆에서 Milestone actions(⋮) > Delete를 선택합니다.
- 마일스톤 제목을 선택한 후 Milestone actions(⋮) > Delete를 선택합니다.
- Delete milestone을 선택합니다.
프로젝트 마일스톤을 그룹 마일스톤으로 승격#
히스토리
- GitLab 17.7에서 최소 사용자 권한이 Reporter에서 Planner로 변경되었습니다.
그룹의 프로젝트 수를 늘리는 경우, 이 그룹의 프로젝트 간에 동일한 마일스톤을 공유하고 싶을 수 있습니다. 프로젝트 마일스톤을 상위 그룹으로 승격하여 동일한 그룹의 다른 프로젝트에서 사용할 수 있도록 할 수 있습니다.
마일스톤을 승격하면 이 그룹의 모든 프로젝트에서 동일한 이름의 모든 프로젝트 마일스톤이 단일 그룹 마일스톤으로 병합됩니다. 이전에 이러한 프로젝트 마일스톤 중 하나에 할당되었던 모든 이슈와 머지 리퀘스트가 새 그룹 마일스톤에 할당됩니다.
이 작업은 취소할 수 없으며 변경 사항은 영구적입니다.
사전 요구 사항:
- 그룹에 Planner, Reporter, Developer, Maintainer, 또는 Owner 권한이 있어야 합니다.
프로젝트 마일스톤을 승격하려면:
- 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
- 왼쪽 사이드바에서 Plan > Milestones를 선택합니다.
- 다음 중 하나를 수행합니다:
- 승격하려는 마일스톤 옆에서 Milestone actions(⋮) > Promote를 선택합니다.
- 마일스톤 제목을 선택한 후 Milestone actions(⋮) > Promote를 선택합니다.
- Promote Milestone을 선택합니다.
항목에 마일스톤 할당#
히스토리
- 에픽에 마일스톤을 할당하는 기능이 GitLab 18.2에서 도입되었습니다.
모든 이슈, 에픽 또는 머지 리퀘스트에 하나의 마일스톤을 할당할 수 있습니다. 마일스톤은 모든 이슈와 머지 리퀘스트 페이지의 오른쪽 사이드바에 표시됩니다. 작업 항목 보드에서도 볼 수 있습니다.
마일스톤을 할당하거나 할당 해제하려면:
- 이슈, 에픽 또는 머지 리퀘스트를 봅니다.
- 오른쪽 사이드바에서 Milestones 옆의 Edit를 선택합니다.
- Assign milestone 목록에서 이름을 입력하여 마일스톤을 검색합니다. 프로젝트와 그룹 마일스톤 모두에서 선택할 수 있습니다.
- 할당할 마일스톤을 선택합니다.
마일스톤을 할당하거나 할당 해제하기 위해 다음을 사용할 수도 있습니다:
- 댓글이나 설명에서
/milestone빠른 액션 사용 - 보드의 마일스톤 목록으로 이슈 드래그
- 이슈 목록에서 이슈 일괄 편집
마일스톤별 이슈 및 머지 리퀘스트 필터링#
목록 페이지에서 필터링#
프로젝트 및 그룹 이슈/머지 리퀘스트 목록 페이지에서 그룹 마일스톤과 프로젝트 마일스톤 모두로 필터링할 수 있습니다.
이슈 보드에서 필터링#
프로젝트 이슈 보드에서 다음에서 그룹 마일스톤과 프로젝트 마일스톤 모두로 필터링할 수 있습니다:
그룹 이슈 보드에서 다음에서 그룹 마일스톤으로만 필터링할 수 있습니다:
특수 마일스톤 필터#
히스토리
- GitLab 18.0에서 Started 및 Upcoming 필터의 로직이 변경되었습니다.
마일스톤으로 필터링할 때, 특정 프로젝트 마일스톤이나 그룹 마일스톤을 선택하는 것 외에도 특수 마일스톤 필터를 선택할 수 있습니다.
- None: 할당된 마일스톤이 없는 이슈 또는 머지 리퀘스트를 표시합니다.
- Any: 할당된 마일스톤이 있는 이슈 또는 머지 리퀘스트를 표시합니다.
- Upcoming: 미래에 시작하는 열린 할당된 마일스톤이 있는 이슈 또는 머지 리퀘스트를 표시합니다.
- Started: 현재 날짜와 겹치는 열린 할당된 마일스톤이 있는 이슈 또는 머지 리퀘스트를 표시합니다. 목록에는 정의된 시작 날짜와 기한이 없는 마일스톤은 제외됩니다.