마일스톤

Tier: Free, Premium, Ultimate Offering: GitLab.com, Self-Managed, GitLab Dedicated

GitLab의 마일스톤은 특정 기간 동안 더 큰 목표를 달성하기 위해 생성된 이슈 및 Merge Request을 추적하는 방법입니다.

마일스톤을 사용하면 선택적으로 시작 날짜와 마감 날짜가 들어 있는 일관된 그룹으로 이슈와 Merge Request을 구성할 수 있습니다.

릴리스로서의 마일스톤

마일스톤은 릴리스를 추적하는 데 사용할 수 있습니다. 다음과 같이 진행하세요:

  1. 마일스톤 마감 날짜를 릴리스의 릴리스 날짜를 나타내도록 설정하고, 시작 날짜는 비워 두세요.
  2. 마일스톤 제목을 릴리스 버전(예: 버전 9.4)으로 설정하세요.
  3. 이슈 오른쪽 사이드바에서 원하는 마일스톤을 연결하여 릴리스에 이슈를 추가하세요.

또한, 마일스톤을 릴리스 기능과 통합할 수 있습니다.

프로젝트 마일스톤 및 그룹 마일스톤

마일스톤은 프로젝트 또는 그룹에 속할 수 있습니다.

프로젝트 마일스톤은 해당 프로젝트의 이슈 또는 Merge Request에만 할당할 수 있습니다. 그룹 마일스톤은 해당 그룹의 모든 프로젝트의 모든 이슈나 Merge Request에 할당할 수 있습니다.

프로젝트 및 그룹 마일스톤 API에 대한 자세한 정보는 다음을 참조하세요:

프로젝트 또는 그룹 마일스톤 보기

마일스톤 디렉터리을 보려면 다음을 수행하세요:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트 또는 그룹을 찾습니다.
  2. Plan > 마일스톤을 선택합니다.

프로젝트에서 GitLab은 프로젝트에 속한 마일스톤을 표시합니다. 그룹에서 GitLab은 그룹에 속한 프로젝트 및 모든 마일스톤을 표시합니다.

이슈가 비활성화된 프로젝트의 마일스톤 보기

프로젝트의 이슈 추적이 비활성화된 경우, 마일스톤 페이지로 이동하려면 해당 URL을 입력하세요.

다음을 수행하세요:

  1. 프로젝트로 이동합니다.
  2. 프로젝트 URL에 /-/milestones를 추가합니다. 예: https://gitlab.com/gitlab-org/sample-data-templates/sample-gitlab-project/-/milestones.

또는 이 프로젝트의 이슈는 해당 그룹의 마일스톤 페이지에서 표시됩니다.

이 경험의 개선 사항은 이슈 339009에서 추적됩니다.

모든 마일스톤 보기

전체 GitLab 네임스페이스에서 액세스할 수 있는 모든 마일스톤을 보실 수 있습니다. 멤버가 아닌 프로젝트 또는 그룹에 속한 마일스톤은 볼 수 없을 수 있습니다.

다음을 수행하세요:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택합니다.
  2. 작업을 선택합니다.
  3. 왼쪽 사이드바에서 마일스톤을 선택합니다.

마일스톤 세부 정보 보기

마일스톤에 대한 자세한 정보를 보려면, 마일스톤 디렉터리에서 보고 싶은 마일스톤의 제목을 선택하세요.

마일스톤 뷰에는 제목과 설명이 표시됩니다.

또한 아래에는 다음을 보여주는 탭이 있습니다:

  • 이슈: 마일스톤에 할당된 모든 이슈를 보여줍니다. 이들은 다음과 같은 세 개의 열에 표시됩니다:
    • 시작하지 않은 이슈(열려 있고 할당되지 않음)
    • 진행 중인 이슈(열려 있고 할당됨)
    • 완료된 이슈(닫힘)
  • Merge Request: 마일스톤에 할당된 모든 Merge Request을 보여줍니다. 이들은 다음과 같은 네 개의 열에 표시됩니다:
    • 진행 중인 작업(열려 있고 할당되지 않음)
    • Merge 대기 중(열려 있고 할당됨)
    • 거부됨(닫힘)
    • Merge됨
  • 참여자: 마일스톤에 할당된 이슈의 모든 담당자를 표시합니다.
  • 라벨: 마일스톤에 할당된 이슈에서 사용되는 모든 라벨을 표시합니다.

번다운 차트

마일스톤 뷰에는 번다운 및 번업 차트도 포함되어 있습니다. 이는 마일스톤을 완료하는 진행을 보여주는 차트입니다.

번다운 차트

마일스톤 사이드바

마일스톤 뷰의 마일스톤 사이드바에는 다음이 표시됩니다:

  • 닫힌 이슈의 수를 전체 이슈의 수로 나눈 값으로 계산된 완료 비율.
  • 시작 일자 및 마감 날짜.
  • 마일스톤에 할당된 모든 이슈 및 Merge Request에 소요된 총 시간.
  • 마일스톤에 할당된 모든 이슈의 총 이슈 가중치.

프로젝트 마일스톤 페이지

마일스톤 생성

  • Changed GitLab 15.0에서 최소 사용자 역할을 개발자에서 보고자로 변경했습니다.

프로젝트 또는 그룹에 마일스톤을 생성할 수 있습니다.

전제 조건:

  • 해당 마일스톤에 대해 프로젝트 또는 그룹에서 적어도 보고자 역할을 해야 합니다.

마일스톤을 생성하려면 다음을 수행하세요:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하여 프로젝트 또는 그룹을 찾습니다.
  2. Plan > 마일스톤을 선택합니다.
  3. 새 마일스톤을 선택합니다.
  4. 제목을 입력합니다.
  5. 선택 사항: 설명, 시작 일자, 마감 날짜를 입력합니다.
  6. 새 마일스톤을 선택합니다.

새 마일스톤

마일스톤 편집

  • Changed GitLab 15.0에서 최소 사용자 역할을 개발자에서 보고자로 변경했습니다.

전제 조건:

  • 해당 마일스톤에 대해 프로젝트 또는 그룹에서 적어도 보고자 역할을 해야 합니다.

마일스톤을 편집하려면 다음을 수행하세요:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하여 프로젝트 또는 그룹을 찾습니다.
  2. Plan > 마일스톤을 선택합니다.
  3. 마일스톤의 제목을 선택합니다.
  4. 오른쪽 상단 모서리에서 마일스톤 작업 ()을 선택한 다음 편집을 선택합니다.
  5. 제목, 시작 일자, 마감 날짜 또는 설명을 편집합니다.
  6. 변경 사항 저장을 선택합니다.

마일스톤 닫기

  • Changed GitLab 15.0에서 최소 사용자 역할을 개발자에서 보고자로 변경했습니다.

전제 조건:

  • 해당 마일스톤에 대해 프로젝트 또는 그룹에서 적어도 보고자 역할을 해야 합니다.

마일스톤을 닫으려면 다음을 수행하세요:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하여 프로젝트 또는 그룹을 찾습니다.
  2. Plan > 마일스톤을 선택합니다.
  3. 다음 중 하나를 수행합니다:
    • 닫고자 하는 마일스톤 옆에 마일스톤 작업 () > 닫기를 선택합니다.
    • 마일스톤 제목을 선택한 다음 닫기를 선택합니다.

마일스톤 삭제

  • Changed GitLab 15.0에서 최소 사용자 역할을 개발자에서 보고자로 변경했습니다.

전제 조건:

  • 해당 마일스톤에 대해 프로젝트 또는 그룹에서 적어도 보고자 역할을 해야 합니다.

마일스톤을 삭제하려면 다음을 수행하세요:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하여 프로젝트 또는 그룹을 찾습니다.
  2. Plan > 마일스톤을 선택합니다.
  3. 다음 중 하나를 수행합니다:
    • 삭제하려는 마일스톤 옆에 마일스톤 작업 () > 삭제를 선택합니다.
    • 마일스톤 제목을 선택한 다음 마일스톤 작업 () > 삭제를 선택합니다.
  4. 마일스톤 삭제를 선택합니다.

프로젝트 마일스톤을 그룹 마일스톤으로 승격

그룹의 프로젝트 수를 확장하고 있다면, 그룹의 프로젝트 간에 동일한 마일스톤을 공유하고 싶을 것입니다. 그룹 내의 다른 프로젝트에서 사용할 수 있도록 프로젝트 마일스톤을 그룹 마일스톤으로 승격할 수도 있습니다.

마일스톤을 승격하면 이 그룹 내의 모든 프로젝트의 모든 프로젝트 마일스톤이 동일한 그룹 마일스톤으로 Merge됩니다. 이전에 하나의 프로젝트 마일스톤에 할당된 모든 이슈 및 Merge Request은 새 그룹 마일스톤에 할당됩니다.

caution
이 작업은 되돌릴 수 없으며 변경 사항은 영구적입니다.

전제 조건:

  • 이 그룹에 대해 적어도 보고자 역할을 가져야 합니다.

프로젝트 마일스톤을 승격하려면 다음을 수행하세요:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. Plan > 마일스톤을 선택합니다.
  3. 다음 중 하나를 수행합니다:
    • 승격하려는 마일스톤 옆에 마일스톤 작업 () > 승격을 선택합니다.
    • 마일스톤 제목을 선택한 다음 마일스톤 작업 () > 승격을 선택합니다.
  4. 마일스톤 승격을 선택합니다.

이슈 또는 Merge Request에 마일스톤 할당하기

모든 이슈와 Merge Request에는 하나의 마일스톤을 할당할 수 있습니다. 마일스톤은 모든 이슈 및 Merge Request 페이지의 오른쪽 사이드바에서 볼 수 있습니다. 또한 이슈 보드에서도 확인할 수 있습니다.

마일스톤을 할당하거나 해제하려면:

  1. 이슈 또는 Merge Request을 보기.
  2. 오른쪽 사이드바에서 Milestones 옆의 편집을 선택합니다.
  3. 마일스톤 할당 디렉터리에서 해당하는 마일스톤을 찾아 이름을 입력합니다. 프로젝트 및 그룹 마일스톤을 모두 선택할 수 있습니다.
  4. 할당하려는 마일스톤을 선택합니다.

또한 코멘트에서 /assign 빠른 조치를 사용할 수도 있습니다.

마일스톤으로 이슈 및 Merge Request 필터링하기

디렉터리 페이지의 필터

프로젝트 및 그룹 이슈/Merge Request 디렉터리 페이지에서 그룹 및 프로젝트 마일스톤으로 필터링할 수 있습니다.

이슈 보드의 필터

프로젝트 이슈 보드에서는 프로젝트 마일스톤 및 그룹 마일스톤으로 필터링할 수 있습니다.

그룹 이슈 보드에서는 그룹 마일스톤으로만 필터링할 수 있습니다.

특별한 마일스톤 필터

마일스톤으로 필터링할 때 특별한 마일스톤 필터를 선택할 수 있습니다.

  • 없음: 할당된 마일스톤이 없는 이슈 또는 Merge Request을 표시합니다.
  • 아무거나: 할당된 마일스톤이 있는 이슈 또는 Merge Request을 표시합니다.
  • 다가오는 것: 오픈된 마일스톤이 할당된 이슈 또는 Merge Request을 표시하며, 가장 가까운 미래의 마감일을 가지고 있습니다.
  • 시작됨: 오늘보다 이전에 시작된 오픈된 마일스톤이 할당된 이슈 또는 Merge Request을 표시합니다.