マイルストーン

マイルストーンは、GitLabでの作業の追跡と整理に役立ちます。マイルストーンでは、次のことを行います:

• 関連するイシュー、エピック、およびマージリクエストをグループ化して、目標に対する進捗状況を追跡します。
• オプションの開始日と期限を使用して、時間ベースの計画をサポートします。
• イテレーションと連携して、同時タイムボックスを追跡します。
• リリースを追跡し、リリースエビデンスを生成します。
• プロジェクトとグループに適用されます。

マイルストーンは、プロジェクトまたはグループに属することができます。プロジェクトマイルストーンは、そのプロジェクトのイシューとマージリクエストにのみ適用されます。グループマイルストーンは、そのグループのプロジェクト内の任意のイシュー、エピック、またはマージリクエストに適用されます。

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

• プロジェクトマイルストーンAPI
• グループマイルストーンAPI

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

マイルストーンを使用して、リリースを追跡できます。これを行うには、次の手順を実行します:

1. マイルストーンの期限を、リリースのリリース日に設定します。リリースサイクルに定義された開始日がない場合は、マイルストーンの開始日を空白のままにすることができます。
2. マイルストーンのタイトルを、Version 9.4などのリリースのバージョンに設定します。
3. イシューの右側のサイドバーからマイルストーンを選択して、イシューをリリースに追加します。

さらに、リリースを作成するときにリリースエビデンスを自動的に生成するには、マイルストーンをリリース機能と統合します。

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

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

project milestones（プロジェクトマイルストーン）は、そのプロジェクトのイシューまたはマージリクエストにのみ割り当てることができます。そのグループに含まれる任意のプロジェクトの任意のイシュー、エピック、またはマージリクエストにgroup milestones（グループマイルストーン）を割り当てることができます。

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

• プロジェクトマイルストーンAPI
• グループマイルストーン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. 左側のサイドバーで、マイルストーンを選択します。

マイルストーンの詳細を表示する

マイルストーンに関する詳細情報を表示するには、マイルストーンページで、表示するマイルストーンのタイトルを選択します。

マイルストーンビューには、タイトルと説明が表示されます。タイトルと説明の下のタブには、次のものが表示されます:

• Work Items（作業アイテム）: マイルストーンに割り当てられたすべての作業アイテムを表示します。作業アイテムは、次の名前の3つの列に表示されます:
  • 開始していないイシュー（オープンかつ未割り当て）
  • 進行中のイシュー（オープンかつ割り当て済）
  • 完了したイシュー（クローズ）
• マージリクエスト: マイルストーンに割り当てられたすべてのマージリクエストを表示します。マージリクエストは、次の名前の4つの列に表示されます:
  • 実行中（オープンかつ未割り当て）
  • マージ待ち（オープンかつ割り当て済）
  • 拒否（クローズ）
  • マージ済み
• 参加者: マイルストーンに割り当てられたイシューのすべての担当者を表示します。
• ラベル: マイルストーンに割り当てられたイシューで使用されているすべてのラベルを表示します。

バーンダウンチャート

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

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

マイルストーンビューのサイドバーには、以下の項目が表示されます:

• 完了率は、クローズされた作業アイテムの数を作業アイテムの合計数で割って算出されます。
• 開始日と期限。
• マイルストーンに割り当てられたすべての作業アイテムとマージリクエストに費やされた合計時間。
• マイルストーンに割り当てられたすべての作業アイテムのイシューのウェイトの合計。
• 合計、オープン、クローズ、マージ済みのマージリクエストの数。
• 関連するリリースへのリンク。
• クリップボードにコピーできるマイルストーンの参照。

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

マイルストーンは、プロジェクトまたはグループのいずれかで作成できます。

前提要件:

• マイルストーンが属するプロジェクトまたはグループに対してプランナーロール以上を持っている必要があります。

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

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

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

前提要件:

• マイルストーンが属するプロジェクトまたはグループに対してプランナーロール以上を持っている必要があります。

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

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

マイルストーンをクローズする

マイルストーンは、期日を過ぎるとクローズします。マイルストーンを手動でクローズすることもできます。

マイルストーンをクローズすると、オープンなイシューはオープンのままになります。

前提要件:

• マイルストーンが属するプロジェクトまたはグループに対してプランナーロール以上を持っている必要があります。

マイルストーンをクローズするには:

1. 左側のサイドバーで、検索または移動先を選択して、プロジェクトまたはグループを見つけます。
2. Plan > マイルストーンを選択します。
3. 次のいずれかの操作を行います:
   • クローズするマイルストーンの横で、マイルストーンアクション（ ） > 閉じるを選択します。
   • マイルストーンのタイトルを選択し、閉じるを選択します。

マイルストーンを削除する

前提要件:

• マイルストーンが属するプロジェクトまたはグループに対してプランナーロール以上を持っている必要があります。

マイルストーンを削除するには:

1. 左側のサイドバーで、検索または移動先を選択して、プロジェクトまたはグループを見つけます。
2. Plan > マイルストーンを選択します。
3. 次のいずれかの操作を行います:
   • 削除するマイルストーンの横で、マイルストーンアクション（ ） > 削除を選択します。
   • マイルストーンのタイトルを選択し、マイルストーンアクション（ ） > 削除を選択します。
4. マイルストーンを削除を選択します。

プロジェクトマイルストーンをグループマイルストーンにプロモートする

グループ内のプロジェクトが増えている場合は、このグループのプロジェクト間で同じマイルストーンを共有することをお勧めします。プロジェクトマイルストーンを親グループにプロモートして、同じグループ内の他のプロジェクトで使用できるようにすることができます。

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

前提要件:

• グループのプランナーロール以上を持っている必要があります。

プロジェクトマイルストーンをプロモートするには:

1. 左側のサイドバーで、検索または移動先を選択して、プロジェクトを見つけます。
2. Plan > マイルストーンを選択します。
3. 次のいずれかの操作を行います:
   • プロモートするマイルストーンの横で、マイルストーンアクション（ ） > プロモートを選択します。
   • マイルストーンのタイトルを選択し、マイルストーンアクション（ ） > プロモートを選択します。
4. マイルストーンをプロモートを選択します。

アイテムにマイルストーンを割り当てる

各イシュー、エピック、またはマージリクエストには、1つのマイルストーンを割り当てることができます。マイルストーンは、各イシューページと各マージリクエストページの右側のサイドバーに表示されます。それらは作業項目ボードにも表示されます。

マイルストーンを割り当てる、または割り当てを解除するには:

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

次の方法で、マイルストーンを割り当てる、または割り当てを解除することもできます:

• コメントまたは説明で/milestoneクイックアクションを使用する
• イシューをボードのマイルストーンリストにドラッグする
• イシューリストからイシューを一括編集する

マイルストーンでイシューとマージリクエストをフィルタリングする

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

プロジェクトおよびグループのイシュー/マージリクエストリストページから、グループマイルストーンとプロジェクトマイルストーンの両方でフィルタリングできます。

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

プロジェクトイシューボードから、次の場所でグループマイルストーンとプロジェクトマイルストーンの両方を使用してフィルタリングできます:

• 検索およびフィルターバー
• イシューボードの設定

グループイシューボードから、次の場所でグループマイルストーンのみを使用してフィルタリングできます:

• 検索およびフィルターバー
• イシューボードの設定

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

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

• なし: マイルストーンが割り当てられていないイシューまたはマージリクエストを表示します。
• 任意: マイルストーンが割り当てられたイシューまたはマージリクエストを表示します。
• 今後: 今後開始されるオープンなマイルストーンが割り当てられたイシューまたはマージリクエストを表示します。
• 開始済み: 現在の日付と重なるオープンなマイルストーンが割り当てられたイシューまたはマージリクエストを表示します。リストでは、定義された開始日と期限のないマイルストーンは除外されます。