マイルストーン

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

マイルストーンを使うと、イシューやマージリクエストを一つのまとまったグループにまとめることができます。

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

マイルストーンはリリースのトラッキングに使用できます。そのためには

  1. マイルストーンの期日をリリースのリリース日に設定し、マイルストーンの開始日を空白にします。
  2. マイルストーンのタイトルをVersion 9.4 のようにリリースのバージョンに設定します。
  3. issueの右側のサイドバーからマイルストーンに関連付けることで、リリースにissueを追加します。

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

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

マイルストーンはプロジェクトまたはグループに属することができます。

プロジェクトのマイルストーンは、そのプロジェクトのイシューまたはマージリクエストにのみ割り当てることができます。グループのマイルストーンは、そのグループ内のどのプロジェクトのどのイシューやマージリクエストにも割り当てることができます。

プロジェクトマイルストーンAPIとグループマイルストーンAPIについては、以下を参照してください：

プロジェクトやグループのマイルストーンの表示

マイルストーン一覧を表示します：

  1. 左側のサイドバーで、「検索」を選択するか、または「移動」を選択して、プロジェクトまたはグループを見つけます。
  2. 計画 > マイルストーン]を選択します。

プロジェクトでは、GitLabはプロジェクトに属するマイルストーンを表示します。グループでは、GitLab はグループとグループ内の全てのプロジェクトに属するマイルストーンを表示します。

イシューをオフにしたプロジェクトでマイルストーンを見る

プロジェクトでイシューのトラッキングがオフになっている場合、マイルストーンのページを表示するにはURLを入力してください。

を使用します：

  1. プロジェクトに移動します。
  2. プロジェクトのURLに/-/milestones を追加します。例えばhttps://gitlab.com/gitlab-org/sample-data-templates/sample-gitlab-project/-/milestones。

あるいは、このプロジェクトのイシューはグループのマイルストーンページに表示されます。

この経験の改善はイシュー339009で追跡されています。

すべてのマイルストーンを見る

GitLabネームスペース全体でアクセスできるマイルストーンをすべて見ることができます。あなたがメンバーではないプロジェクトやグループのマイルストーンは表示されないかもしれません。

を使用します：

  1. 左のサイドバーで、Search を選択するか、次のページに進んでください。
  2. 作品を選択します。
  3. 左サイドバーで、マイルストーンを選択します。

マイルストーンの詳細を見る

マイルストーンの詳細を表示するには、マイルストーンリストで表示したいマイルストーンのタイトルを選択します。

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

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

  • イシュー：マイルストーンに割り当てられたすべてのイシューが表示されます。これらは
    • 未着手のイシュー（未解決、未割り当て）
    • 進行中のイシュー（未解決かつ割り当て済み）
    • 完了したイシュー（クローズ済み）
  • マージリクエスト：マイルストーンに割り当てられたすべてのマージリクエストが表示されます。これらは
    • 進行中の作業（未解決および未割り当て）
    • マージ待ち（オープン、割り当て済み）
    • 却下（クローズ）
    • マージ
  • 参加者マイルストーンに割り当てられたイシューのすべての担当者を表示します。
  • ラベルマイルストーンに割り当てられたイシューで使用されているすべてのラベルを表示します。

バーンダウンチャート

マイルストーンビューにはバーンダウンチャートとバーンアップチャートがあり、マイルストーンの完了状況を表示します。

burndown chart

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

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

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

Project milestone page

マイルストーンの作成

GitLab 15.0の最小ユーザーロールを開発者からレポーターに変更しました。

マイルストーンはプロジェクトでもグループでも作成できます。

前提条件：

  • マイルストーンが属するプロジェクトまたはグループのレポーターロール以上を持っている必要があります。

マイルストーンを作成するには

  1. 左側のサイドバーで、「検索」を選択するか、または「移動」を選択して、プロジェクトまたはグループを見つけます。
  2. 計画 > マイルストーン]を選択します。
  3. 新しいマイルストーンを選択します。
  4. タイトルを入力します。
  5. オプション。説明、開始日、期限を入力してください。
  6. 新しいマイルストーンを選択します。

New milestone

マイルストーンの編集

GitLab 15.0の最小ユーザーロールを開発者からレポーターに変更しました。

前提条件：

  • マイルストーンが属するプロジェクトまたはグループのレポーターロール以上を持っている必要があります。

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

  1. 左側のサイドバーで、「検索」を選択するか、または「移動」を選択して、プロジェクトまたはグループを見つけます。
  2. 計画 > マイルストーン]を選択します。
  3. マイルストーンのタイトルを選択します。
  4. 右上のマイルストーンアクション（{ellipsis_v}）を選択し、編集を選択します。
  5. タイトル、開始日、期限、または説明を編集します。
  6. 変更を保存を選択します。

マイルストーンの削除

GitLab 15.0の最小ユーザーロールを開発者からレポーターに変更しました。

前提条件：

  • マイルストーンが属するプロジェクトまたはグループのレポーターロール以上を持っている必要があります。

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

  1. 左側のサイドバーで、「検索」を選択するか、または「移動」を選択して、プロジェクトまたはグループを見つけます。
  2. 計画 > マイルストーン]を選択します。
  3. マイルストーンのタイトルを選択します。
  4. 右上でマイルストーンのアクション({ellipsis_v}) を選択し、削除を選択します。
  5. マイルストーンの削除を選択します。

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

グループ内のプロジェクト数を増やす場合、同じマイルストーンをグループ内のプロジェクトで共有したい場合があります。プロジェクトのマイルストーンをグループのマイルストーンに昇格させて、同じグループ内の他のプロジェクトで利用できるようにすることもできます。

マイルストーンを昇格させると、同じ名前のグループ内のすべてのプロジェクトのマイルストーンが1つのグループマイルストーンにマージされます。これらのプロジェクト マイルストーンのいずれかに割り当てられていたすべてのイシューとマージリクエストは、新しいグループ マイルストーンに割り当てられます。

caution
このアクションは取り消すことができず、変更は永続的です。

前提条件：

  • 少なくともグループのレポーターロールを持っている必要があります。

プロジェクトのマイルストーンを昇格させるには：

  1. 左のサイドバーで「検索」または「移動」を選択してあなたのプロジェクトを検索します。
  2. 計画 > マイルストーン]を選択します。
  3. どちらか：
    • 昇格させたいマイルストーンの横にある「グループマイルストーンに昇格」（{昇格}）を選択します。
    • マイルストーンのタイトルを選択し、マイルストーンのアクション({ellipsis_v}) >昇格を選択します。
  4. マイルストーンを昇格させる]を選択します。

マイルストーンをイシューまたはマージリクエストに割り当てます。

すべてのイシューとマージリクエストにはマイルストーンを割り当てることができます。マイルストーンはすべてのイシューとマージリクエストページの右サイドバーに表示されます。イシューボードにも表示されます。

マイルストーンを割り当てたり、割り当てなかったりするには、次のようにします：

  1. イシューまたはマージリクエストを表示します。
  2. 右サイドバーのマイルストーンの横にある[編集]を選択します。
  3. マイルストーンの割り当てリストで、マイルストーン名を入力して検索します。プロジェクトとグループの両方のマイルストーンから選択できます。
  4. 割り当てたいマイルストーンを選択します。

コメントで/assign クイックアクションを使用することもできます。

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

リストページのフィルター

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

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

プロジェクトのイシューボードでは、グループのマイルストーンとプロジェクトのマイルストーンの両方でフィルターをかけることができます：

グループのイシューボードから、グループのマイルストーンだけを絞り込むことができます：

特殊マイルストーンフィルター

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

  • なし：マイルストーンが割り当てられていないイシューやマージリクエストを表示します。
  • すべてマイルストーンが割り当てられているイシューまたはマージリクエストを表示します。
  • 今後の予定：未解決のマイルストーンが割り当てられていて、期限が最も近いイシューまたはマージリクエストを表示します。
  • 開始未解決のマイルストーンが割り当てられ、開始日が今日以前のイシューまたはマージリクエストを表示します。