マイルストーン

概要

GitLabのマイルストーンは、ある期間内に広い目標を達成するために作成されたイシューやマージリクエストを追跡する方法です。

マイルストーンでは、イシューやマージリクエストを、開始日と期限を任意に設定して、まとまったグループに整理することができます。

アジャイルスプリントとしてのマイルストーン

マイルストーンはアジャイルのスプリントとして使用することができ、特定のスプリントに関連するすべてのイシューとマージリクエストを追跡することができます。 そのためには、次のようにします:

  1. マイルストーンの開始日と期日を、アジャイルスプリントの開始日と終了日に設定します。
  2. マイルストーンのタイトルをアジャイルスプリントの名前に設定します(November 2018 sprintなど)。
  3. 課題の右側のサイドバーから必要なマイルストーンを関連付けることで、課題をアジャイルスプリントに追加します。

リリースとしてのマイルストーン

同様にマイルストーンもリリースとして使用できます。 そのためには

  1. マイルストーンの期日をリリースのリリース日に設定し、マイルストーンの開始日は空白にしてください。
  2. マイルストーンのタイトルは、リリースのバージョンに設定してください (Version 9.4など)。
  3. イシューの右側のサイドバーから目的のマイルストーンを関連付けることで、リリースにイシューを追加できます。

さらに、マイルストーンをGitLabのリリース機能とインテグレーションすることもできます。

プロジェクトのマイルストーンとグループのマイルストーン

プロジェクトのマイルストーンは、そのプロジェクト内のイシューまたはマージリクエストにのみ割り当てることができます。 プロジェクトのマイルストーンリストを表示するには、プロジェクトで Issues > Milestonesに進みます。

グループ内のどのプロジェクトのどのイシューやマージリクエストにも、グループマイルストーンを割り当てることができます。 グループマイルストーンリストを表示するには、グループ内で Issues > Milestonesに進んでください。

ダッシュボードのマイルストーン一覧で、アクセス可能なすべてのマイルストーンを表示することもできます。 プロジェクトマイルストーンとアクセス可能なグループマイルストーンの両方を表示するには、上部ナビゲーションバーの「その他 > マイルストーン」をクリックします。

プロジェクトとグループのマイルストーンAPIについては、こちらをご覧ください:

注:グループにいて[イシュー]→[マイルストーン]をクリックすると、グループのマイルストーンとこのグループ内のプロジェクトのマイルストーンが表示されます。 プロジェクトにいて[イシュー]→[マイルストーン]をクリックすると、このプロジェクトのマイルストーンのみが表示されます。

マイルストーンの作成

注:マイルストーンを作成するには、開発者以上の権限が必要です。

新規プロジェクトのマイルストーン

プロジェクトのマイルストーンを作成します:

  1. プロジェクトで、{イシュー} イシュー >マイルストーンに進みます。
  2. 新しいマイルストーンをクリックします。
  3. タイトル、任意の説明、任意の開始日、および任意の期限を入力します。
  4. 新しいマイルストーンをクリックします。

New project milestone

新グループのマイルストーン

グループのマイルストーンを作成するには:

  1. グループで、{イシュー} 課題 >マイルストーンに進みます。
  2. 新しいマイルストーンをクリックします。
  3. タイトル、任意の説明、任意の開始日、および任意の期限を入力します。
  4. 新しいマイルストーンをクリックします。

New group milestone

マイルストーンの編集

注:マイルストーンを編集するには、開発者以上の権限が必要です。

マイルストーンを編集するには

  1. プロジェクトまたはグループで、イシュー イシュー>マイルストーンに進みます。
  2. マイルストーンのタイトルをクリックしてください。
  3. 編集をクリックします。

削除ボタンをクリックするとマイルストーンを削除できます。

プロジェクトのマイルストーンをグループのマイルストーンに昇格させます。

少数のプロジェクトから、同じグループ内の多数のプロジェクトに拡大する場合、同じマイルストーンを同じグループ内の複数のプロジェクトで共有したいと思うかもしれません。 以前プロジェクトのマイルストーンを作成し、同じグループ内の他のプロジェクトでも利用できるようにしたい場合、そのマイルストーンをグループのマイルストーンに昇格させることができます。

プロジェクトマイルストンリストページから、プロジェクトマイルストンをグループマイルストンに昇格させることができます。 これにより、同じ名前のグループ内のすべてのプロジェクトマイルストンが1つのグループマイルストンにマージされます。 以前にこれらのプロジェクトマイルストンに割り当てられていたすべてのイシューとマージリクエストは、新しいグループマイルストンに割り当てられます。 このアクションは取り消すことができず、変更は永続的です。

注意:GitLab 12.4 以前から、プロジェクトマイルストーンをグループマイルストーンに昇格させると、いくつかの情報が失われます。 プロジェクトマイルストーン・ビューのすべての機能がグループマイルストーン・ビューで利用できるわけではありません。 プロジェクトマイルストーンをグループマイルストーン・ビューに昇格させると、これらの機能が失われます。 グループマイルストーン・ビューでどの機能が失われるかは、マイルストーン・ビューを参照してください。

Promote milestone

サイドバーからのマイルストーン割り当て

すべてのイシューとマージリクエストにはマイルストーンを割り当てることができます。 マイルストーンはすべてのイシューとマージリクエストページのサイドバーに表示され、イシューボードにも表示されます。 サイドバーから、マイルストーンをオブジェクトに割り当てたり、割り当てを解除したりすることができます。 また、コメントでクイックアクションとして実行することもできます。前述のように、特定のイシューやマージリクエストに対して、プロジェクトのマイルストーンとグループのマイルストーンの両方を選択し、オブジェクトに割り当てることができます。

マイルストーンによるイシューとマージリクエストのフィルタリング

リストページでのフィルタリング

プロジェクト課題/マージ・リクエスト一覧ページとグループ課題/マージ・リクエスト一覧ページでは、グループ・マイルストーンとプロジェクト・マイルストーンの両方でフィルタリングすることができます。

イシューボードでのフィルタリング

特別マイルストーン・フィルター

マイルストーンでフィルタリングする場合、特定のプロジェクトマイルストーンやグループマイルストーンを選択するだけでなく、特別なマイルストーンフィルタを選択することもできます。

  • なし: マイルストーンが割り当てられていないイシューまたはマージリクエストを表示します。
  • 任意: マイルストーンが割り当てられているイシューまたはマージリクエストを表示します。
  • 今後の予定: 次の期日(将来の最も近い期日)のマイルストーンが割り当てられているイシューまたはマージリクエストを表示します。
  • 開始: マイルストーンが割り当てられており、開始日が今日以前のイシューまたはマージリクエストを表示します。

マイルストーン

マイルストーンビューにはタイトルと説明が表示されます。

また、この下に以下のようなタブがあります:

  • イシュ: マイルストーンに割り当てられたすべてのイシューが表示されます。 イシューは3つのカラムに表示されます:
    • 未着手のイシュー(未解決、未割当)
    • 進行中のイシュー(未解決および割り当て済み)
    • 終了したイシュー(クローズド)
  • マージリクエスト: マイルストーンに割り当てられているすべてのマージリクエストが表示されます。 これらは4つの列で表示されます:
    • 進行中の仕事(未決済、未割り当て)
    • マージ待ち(オープン、未割り当て)
    • 不採用(クローズ)
    • マージ
  • 参加者: マイルストーンに割り当てられたイシューのすべての担当者を表示します。
  • ラベル: マイルストーンに割り当てられたイシューで使用されているすべてのラベルが表示されます。

プロジェクトバーンダウンチャート

GitLabStarterのプロジェクトマイルストーンでは、マイルストーン完了までの進捗を示すバーンダウンチャートがマイルストーンビューに表示されます。

burndown chart

グループバーンダウンチャート

GitLabPremiumのグループマイルストーンでは、マイルストーンビューにバーンダウンチャートが表示され、マイルストーン完了までの進捗が表示されます。

マイルストーンサイドバー

マイルストーン・ビューのマイルストーン・サイドバーには以下のように表示されます:

  • 終了したイシューの数を総イシュー数で割ったパーセンテージ。
  • 開始日と期限。
  • マイルストーンに割り当てられたすべてのイシューとマージリクエストに費やされた時間の合計です。
  • マイルストーンに割り当てられたすべてのイシューの総重量。

Project milestone page