마일스톤


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

GitLab의 마일스톤은 일정 기간 동안의 넓은 목표를 달성하기 위해 생성된 이슈와 병합 요청을 추적하는 방법입니다.

마일스톤을 사용하면 선택적으로 시작 날짜와 만료 날짜를 포함하여 이슈 및 병합 요청을 일치시키는 데 사용할 수 있습니다.

릴리스로서의 마일스톤

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

  1. 마일스톤 만료 날짜를 릴리스 날짜로 설정하고, 마일스톤 시작 날짜는 비워 둡니다.
  2. 마일스톤 제목을 릴리스 버전에 맞게 설정하세요, 예를 들어 버전 9.4.
  3. 이슈를 릴리스에 추가하려면 이슈의 오른쪽 사이드바에서 원하는 마일스톤을 연결하세요.

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

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

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

프로젝트 마일스톤은 해당 프로젝트의 이슈 또는 병합 요청에만 할당할 수 있습니다.
그룹 마일스톤은 해당 그룹 내의 모든 프로젝트의 이슈 또는 병합 요청에 할당할 수 있습니다.

프로젝트 및 그룹 마일스톤 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. Your work를 선택합니다.
  3. 왼쪽 사이드바에서 마일스톤을 선택합니다.

마일스톤 세부 정보 보기

마일스톤에 대한 자세한 정보를 보려면 마일스톤 페이지에서 보고자 하는 마일스톤 제목을 선택하세요.

마일스톤 뷰에는 제목과 설명이 표시됩니다.
제목 및 설명 아래의 탭은 다음과 같은 정보를 보여줍니다:

  • 이슈: 마일스톤에 할당된 모든 이슈를 표시합니다. 이슈는 다음과 같이 세 개의 열에 표시됩니다:
    • 시작되지 않은 이슈 (오픈 및 미할당)
    • 진행 중인 이슈 (오픈 및 할당됨)
    • 완료된 이슈 (닫힘)
  • 병합 요청: 마일스톤에 할당된 모든 병합 요청을 표시합니다. 병합 요청은 다음과 같이 네 개의 열에 표시됩니다:
    • 진행 중인 작업 (오픈 및 미할당)
    • 병합 대기 중 (오픈 및 할당됨)
    • 거부됨 (닫힘)
    • 병합됨
  • 참여자: 마일스톤에 할당된 이슈의 모든 담당자를 표시합니다.
  • 라벨: 마일스톤에 할당된 이슈에서 사용된 모든 라벨을 표시합니다.

버넹다운 차트

마일스톤 뷰에는 버드아운 및 버낍 차트가 포함되어 있습니다.
이 차트는 마일스톤을 완료하는 진행 상황을 보여줍니다.

버드아운 차트

마일스톤 사이드바

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

  • 완료된 백분율, 이는 닫힌 이슈 수를 총 이슈 수로 나눈 것입니다.
  • 시작 날짜 및 만료 날짜
  • 해당 마일스톤에 할당된 모든 이슈 및 병합 요청에 소요된 총 시간
  • 해당 마일스톤에 할당된 모든 이슈의 총 이슈 가중치

프로젝트 마일스톤 페이지

마일스톤 생성

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

전제 조건:

  • 해당 마일스톤에 대해 프로젝트 또는 그룹에서 적어도 리포터 역할이 있어야 합니다.

마일스톤을 생성하려면:

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

새 마일스톤

마일스톤 편집

전제 조건:

  • 해당 마일스톤에 대해 프로젝트 또는 그룹에서 적어도 리포터 역할이 있어야 합니다.

마일스톤을 편집하려면:

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

마일스톤 닫기

전제 조건:

  • 해당 마일스톤에 대해 프로젝트 또는 그룹에서 적어도 리포터 역할이 있어야 합니다.

마일스톤을 닫으려면:

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

마일스톤 삭제

  • 변경됨 GitLab 15.0에서 Developer에서 Reporter로 최소 사용자 역할 변경됨.

전제 조건:

  • 해당 마일스톤이 속한 프로젝트 또는 그룹의 기록자 역할 이상이어야 합니다.

마일스톤을 삭제하려면:

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

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

그룹 내의 프로젝트 수를 확장하는 경우, 해당 그룹의 프로젝트 간에 동일한 마일스톤을 공유하고 싶을 수 있습니다. 또한, 프로젝트 마일스톤을 그룹 마일스톤으로 승격하여 동일 그룹 내의 다른 프로젝트에서 사용할 수 있게 할 수 있습니다.

마일스톤을 승격하면 해당 그룹에 있는 모든 프로젝트의 프로젝트 마일스톤이 동일한 이름의 그룹 마일스톤으로 병합됩니다. 이전에 하나의 이러한 프로젝트 마일스톤에 할당된 모든 이슈와 병합 요청이 새로운 그룹 마일스톤에 할당됩니다.

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

전제 조건:

  • 그룹에 대해 기록자 역할 이상이어야 합니다.

프로젝트 마일스톤을 승격하려면:

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

이슈 또는 병합 요청에 마일스톤 할당

모든 이슈와 병합 요청에는 하나의 마일스톤을 할당할 수 있습니다. 마일스톤은 모든 이슈와 병합 요청 페이지의 오른쪽 사이드바에 표시됩니다. 이슈 보드에서도 볼 수 있습니다.

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

  1. 이슈 또는 병합 요청을 보세요.
  2. 마일스톤 옆의 오른쪽 사이드바에서 편집을 선택합니다.
  3. 마일스톤 할당 목록에서 해당 이름을 입력하여 마일스톤을 검색합니다. 프로젝트 및 그룹 마일스톤 모두에서 선택할 수 있습니다.
  4. 할당하려는 마일스톤을 선택합니다.

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

마일스톤별로 이슈 및 병합 요청 필터링

목록 페이지의 필터

프로젝트 및 그룹 이슈/병합 요청 목록 페이지에서 그룹 및 프로젝트 마일스톤으로 필터링할 수 있습니다.

이슈 보드의 필터

프로젝트 이슈 보드에서는 해당 프로젝트와 그룹 마일스톤으로 다음에서 필터링할 수 있습니다:

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

특별한 마일스톤 필터

마일스톤으로 필터링할 때 특정 프로젝트 마일스톤 또는 그룹 마일스톤을 선택하는 것 외에도 특별한 마일스톤 필터를 선택할 수 있습니다.

  • 없음: 할당된 마일스톤이 없는 이슈 또는 병합 요청을 표시합니다.
  • 모두: 할당된 마일스톤이 있는 이슈 또는 병합 요청을 표시합니다.
  • 다가오는: 미래에 가장 가까운 마감일이 열린 마일스톤에 할당된 이슈나 병합 요청을 표시합니다.
  • 시작됨: 오늘 이전의 시작 날짜가 있는 열린 마일스톤에 할당된 이슈나 병합 요청을 표시합니다.