エピック

エピックは、プロジェクトやマイルストーンをまたいで、テーマを共有するイシューのグループを追跡することで、より効率的かつ少ない労力でプロジェクトのポートフォリオを管理することができます。

epics list view

ユースケース

  • あなたのチームが、グループ内の異なるプロジェクトで作成された異なるイシューを通して、複数のディスカッションを含む大規模な機能開発に取り組んでいるとします。 エピックでは、1つの機能に貢献するすべての関連アクティビティを追跡することができます。
  • イシューグループの作業をいつ開始し、いつ終了するのか。
  • 機能のアイデアとスコープについて、高いレベルで議論し、協力します。

エピックの管理

エピックで何ができるかは、エピックの管理をご覧ください。 可能なアクションは以下の通りです:

エピックとイシューの関係

エピックとイシューの関係として考えられるのは:

  • エピックは1つ以上のイシューの親。
  • エピックは、1つ以上の子エピックの親になります。 詳細は、マルチレベルの子エピックを参照してください。
graph TD Parent_epic --> Issue1 Parent_epic --> Child_epic Child_epic --> Issue2

エピックへのissueの追加、issueの並び替え、エピック間でのissueの移動、エピックへのissueの昇格させる手順については、「エピックに割り当てられたissueの管理」を参照してください。

エピックツリーで健康状態をイシューします。

GitLab Ultimate12.10で導入されました

エピック・ツリーに表示されるissueの健全性ステータスを赤、アンバー、または緑に設定することで、個々のissueやエピックの健全性をレポーターし、迅速に対応することができます。

エピック・ツリーでイシューの健康状態を表示しないようにします。

この機能はデフォルトで機能フラグが有効になっています。 これを無効にする手順については、「イシューの健全性ステータスを無効にする」を参照してください。

マルチレベルの子供エピック

GitLab Ultimate 11.7で導入されました

グループ、または親エピックのグループのサブグループに属するエピックは、追加する資格があります。 新しい子エピックは、[エピックとイシュー]タブのエピック・リストの一番上に表示されます。

すでに親エピックにリンクされているエピックを追加すると、現在の親エピックへのリンクは削除されます。

エピックは最大5つまで、複数の子エピックを持つことができます。

子エピックの作成、移動、並べ替え、または削除の手順については、「複数レベルの子エピックの管理」を参照してください。

開始日と期限

エピックに開始日と期限を設定するには、以下のいずれかを選択します:

  • 固定:固定値を入力します。
  • マイルストーンから: 現在エピックに割り当てられているマイルストーンから動的な値を継承します。 GitLab 12.5では、このオプションはInheritedに変更されました。
  • 継承: エピックのイシュー、子エピック、マイルストーンから動的な値を継承します(GitLab 12.5でマイルストーンから置き換えられて導入されました)。

マイルストーンから

GitLab 12.5でInheritedに置き換えられました

開始日にマイルストーンからを選択した場合、GitLabはエピックに追加されたイシューに現在割り当てられているすべてのマイルストーンの中で最も早い開始日を自動的に設定します。 同様に、期限日にマイルストーンからを選択した場合、GitLabはそれらのイシューに現在割り当てられているすべてのマイルストーンの中で最も遅い期限日を設定します。

これらの日付は、以下のいずれかが発生した場合に再計算される動的な日付です:

  • マイルストーンはイシューに再割り当てされます。
  • マイルストーンの日付は変更されます。
  • エピックにイシューが追加・削除されます。

継承

GitLab 12.5でマイルストーンに代わって導入されました

を選択した場合:

  • 開始日を継承すると、GitLabはエピックに割り当てられたすべての子エピックとイシューをスキャンし、最も早く見つかった開始日またはマイルストーンに一致する開始日を設定します。
  • 期日に継承され、GitLabは子エピックやイシューの中で見つかった最新の期日やマイルストーンに合わせて期日を設定します。

これらは動的な日付であり、以下のいずれかが発生した場合に再計算されます:

  • 子どもエピックは日付が変わります。
  • マイルストーンはイシューに再割り当てされます。
  • マイルストーンの日付が変わります。
  • エピックにイシューが追加されたり、削除されたりします。

エピックの日付は子エピックから継承できるため、開始日と期日は下から上へ伝搬します。 最下層の子エピックの開始日が変更された場合、それが親エピックの可能な限り早い開始日となり、親エピックの開始日に変更が反映され、これが上層のエピックに伝搬します。

エピックにおけるロードマップ

GitLab Ultimate11.10で導入されました

エピックに、開始日または期限を持つ 1 つ以上の子エピックが含まれる場合、子エピックのロードマップ表示が親エピックの下に表示されます。

Child epics roadmap

権限

エピック閲覧のアクセス権があり、そのエピックに既に追加されているイシューを閲覧するアクセス権がある場合、エピック・イシュー・リストでそのイシューを閲覧することができます。

エピック編集のアクセス権があり、イシュー編集のアクセス権がある場合、エピックにイシューを追加したり、エピックから削除したりすることができます。

あるグループに対して、すべてのプロジェクトの可視性はそのグループと同じか、それ以下の制限でなければならないことに注意してください。 つまり、あるグループのエピックにアクセスできる場合、そのグループのプロジェクトのイシューにもすでにアクセスできるということです。

グループ権限表を参照することもできます。

スレッド

  • コメント: そのスレッドにコメントを投稿することで、そのエピックに協力することができます。 これらのテキストフィールドはGitLab Flavored Markdownも完全にサポートしています。

コメントまたはスレッドの作成

コメントを書いたら、次のいずれかを実行できます:

  • コメントをクリックすると、あなたのコメントが公開されます。
  • スレッドを開始」をクリックすると、そのエピック内のディスカッションでスレッドが開始されます。

アクティビティのソート順

GitLab Premium13.2で導入されました

デフォルトの並び順を逆にして、アクティビティフィードを最新のものからソートして表示することもできます。 設定はローカルストレージに保存され、表示するすべてのイシューに自動的に適用されます。

アクティビティのソート順を変更するには、[古い順]ドロップダウンメニューをクリックし、最も古いアイテムまたは最も新しいアイテムのいずれかを最初に表示するように選択します。

Issue activity sort order dropdown button

絵文字リアクション

そのエピックやコメントに絵文字を贈ることができます。

お知らせ

通知をオンにすると、エピックイベントをお知らせします。